AnalyticsCORE← トップページ
Manual

コンバージョンAPI — 注文の実額をサーバーから送る

最終更新: 2026年8月25日

この機能が必要な方・必要ない方

この機能は、注文の確定を知っているのがあなたのサーバーだけだから必要になります （ブラウザの計測タグは「買ったこと」は分かっても「いくらだったか」を確実には知りません）。

できること

注文が確定したとき、あなたのサーバーからAnalytics CORE に金額を送ると、その注文が実額で成果に載ります。 タグで数える成果は「1件の価値」×件数の概算ですが、こちらは注文ごとの本当の金額です。

買い手のIPアドレスとブラウザ情報を一緒に送ると、同じ日にサイトを見た訪問と自動で結びつき、 どの経路（検索・SNS・AI…）の、どの入口ページから生まれた売上かまで分かります。 Cookieもクリック用のIDも要りません。

準備（1分）

  1. 設定画面（左メニューの「設定」）を開き、「コンバージョンAPI」のカードまでスクロールする
  2. [トークンを発行] を押す。表示されたトークンを控える
  3. [疎通を確認する] を押して「確認できました」と出れば、受け口の準備は完了です（成果としては記録されません）
  4. 注文が確定する処理の最後に送る。WordPress（WooCommerce）なら下の貼るだけの例が使えます。 それ以外は次の項目の形式で送ってください

トークンはサーバー側だけに保存してください（ブラウザのJavaScriptや公開リポジトリに置くと、 誰でも偽の成果を送れてしまいます）。

送り方

POST https://analyticscore.jp/api/cv
Authorization: Bearer <トークン>
Content-Type: application/json

{
  "order_id":  "ord_123",                   // 必須。注文ごとに一意（再送は上書き）
  "value_jpy": 4980,                        // 金額（円・整数）。取り消しは 0
  "goal":      "purchase",                  // 目標の名前。目標画面の名前と同じにすると一覧が繋がる
  "buyer_ip":  "203.0.113.7",               // 買い手のIP（結びつけ用・保存しません）
  "buyer_ua":  "Mozilla/5.0 ...",           // 買い手のブラウザ情報（同上）
  "url":       "https://example.com/thanks" // 任意
}

注文が確定した直後に送るなら、時刻の指定は要りません（受信した時刻を使います）。 あとからまとめて送る場合だけ occurred_at に確定時刻をISO 8601形式 （例 2026-08-25T12:34:56Z）で入れてください。★未来の時刻は受け付けませんので、 サンプルの日時をそのまま貼らないでください。

buyer_ip と buyer_ua は、あなたのサーバーが受け取ったリクエストの 接続元IPと User-Agent ヘッダをそのまま入れてください。結びつけの計算にだけ使い、保存しません。

WordPress（WooCommerce）の例 — これを貼るだけ

使っているテーマの functions.php（推奨は子テーマ、またはコードスニペット系プラグイン）に貼り付け、 1行目のトークンだけご自分のものに置き換えてください。注文が「支払い済み」になったときに自動で送られます。

<?php
// Analytics CORE — 注文の実額を送る（WooCommerce）
add_action( 'woocommerce_payment_complete', function ( $order_id ) {
    $token = 'ここにトークンを貼る';   // 設定画面 → コンバージョンAPI で発行したもの

    $order = wc_get_order( $order_id );
    if ( ! $order ) { return; }

    wp_remote_post( 'https://analyticscore.jp/api/cv', array(
        'timeout'  => 5,
        'blocking' => false,              // 注文処理を遅くしない（応答を待たない）
        'headers'  => array(
            'Authorization' => 'Bearer ' . $token,
            'Content-Type'  => 'application/json',
        ),
        'body' => wp_json_encode( array(
            'order_id'  => (string) $order_id,
            'value_jpy' => (int) $order->get_total(),
            'goal'      => 'purchase',
            'buyer_ip'  => $order->get_customer_ip_address(),
            'buyer_ua'  => $order->get_customer_user_agent(),
            'url'       => $order->get_checkout_order_received_url(),
        ) ),
    ) );
} );

応答の読み方

{ "ok": true, "order_id": "ord_123", "matched": true,  "reason": null }
{ "ok": true, "order_id": "ord_124", "matched": false, "reason": "late",
  "hint": "当日（UTC）内の注文だけ訪問と突合できます。台帳には件数と金額が残ります。" }

結びつく条件と限界

うまくいかないとき