Conversions API

1. サーバーサイドを使う理由

ブラウザーのピクセルがコンバージョンを報告するには、広告ブロッカー、トラッキング防止設定、ピクセルの発火前に訪問者がタブを閉じること、という三つの障害を乗り越える必要があります。サーバーサイドの呼び出しはブラウザー内では行われないため、この三つの影響を受けません。

MousePlayer は、目標が達成されたことを既に把握しています。それが目標の役割だからです。Conversions API は、その事実を当社のサーバーから広告ネットワークに転送するだけです。

2. 送信するものと、一切送信しないもの

これらの呼び出しで訪問者を識別するものは、 ネットワーク自身が設定した Cookie またはクリック識別子だけです。その人に関する他の情報が当社のサーバーを出ることはありません。

ネットワーク	使用する識別子	取得元
Meta	_fbp、 _fbc	Meta ピクセルが設定したファーストパーティー Cookie
LinkedIn	li_fat_id	LinkedIn Insight Tag が設定したファーストパーティー Cookie
TikTok	_ttp、 ttclid	_ttp は Cookie、 ttclid は広告クリックの URL が取得元です
Google Ads	gclid、 wbraid、 gbraid	広告クリックの URL、またはその後の _gcl_aw Cookie
Microsoft Advertising	msclkid	広告クリックの URL、または UET タグが書き込む _uetmsclkid Cookie

同意がある場合のみ

これらすべての呼び出しには、録画自体と同じ同意チェックが適用されます。同意のないセッションからは、プロジェクト設定のスイッチにかかわらず、コンバージョンを報告しません。

3. Google Ads の識別子は一つではなく三つ

意外に思われる点なので、明確に説明します。Google は、1回の広告クリックに対して gclid を使います。Apple のトラッキング防止機能によって個々のクリックに帰属させられない場合、Google は代わりに wbraid または gbraid を送信します。これらはクリックのグループを表します。

三つは相互排他的です。Google は二つの識別子を含むコンバージョンを拒否します。当社は正確に一つだけを送信します。複数ある場合は、最も精度の高い gclid を優先します。

URL に現れるのは一度だけ

識別子がアドレスに現れるのは、広告クリック後の 最初の ページだけです。その後、Google タグが次の _gcl_aw Cookie に保存します。当社は代替として Cookie を読み取ります。これがなければ、訪問の3ページ目でコンバージョンしても、識別子が見つからなくなります。

4. 設定方法

Meta、LinkedIn、TikTok

各2項目です。ピクセルまたはコンバージョンルールの ID と、ネットワーク自身の画面で作成するアクセストークンを設定します。両方とも AES-256-GCM で暗号化して保存し、保存後は再表示しません。

Google Ads では6項目が必要です

Google は例外です。その理由は、始める前に知っておくと役立ちます。他の三つと異なり、Google は単純なアクセストークンを発行しません。アクセスにはリフレッシュトークンを使う OAuth が必要で、さらに Ads API には次が必要です： 開発者トークン。

項目	確認する場所
顧客 ID	Google Ads の右上。ハイフンを除いた数字のみです。
コンバージョンアクション ID	「目標とコンバージョン」から、計上先のアクションを開きます。
開発者トークン	Google Ads の管理者アカウントの API センター。
OAuth クライアント ID とシークレット	Google Cloud Console の「認証情報」で、種類が「デスクトップアプリ」の OAuth クライアント。
リフレッシュトークン	次のスコープについて、ご自身で一度生成します： adwords。

LinkedIn の経路は二つ。使うのは短い方です

Campaign Manager で、 データ、シグナルマネージャー、Direct API、アクセストークンを生成と進みます。これは自社のデータを送る広告主向けの経路で、開発者アプリケーションも審査も不要です。トークンには有効期限がなく、Campaign Manager は再表示しないため、その場でコピーしてください。

もう一方の、LinkedIn の Developer Portal から申請する開発者アプリは、多数の広告主の代理で送信するプラットフォーム向けです。会社ページの確認とユースケースの承認が必要ですが、ここではいずれも不要です。

Microsoft Advertising の設定は簡単です

Google Ads の後では、OAuth、開発者トークン、承認手順といった同じ重さを想像するかもしれませんが、逆です。必要なのは2項目だけです。ブラウザーで既に使っている UET タグ ID と、Microsoft Advertising の UET タグにある「Conversions API を使用」「トークンをコピー」からコピーするトークンです。申請は不要です。

ブラウザーのタグと 同じ タグ ID を使ってください。これにより Microsoft は、サーバーサイドのイベントとブラウザーのイベントを二つではなく、一つのコンバージョンとして認識できます。

5. コンバージョンを報告するタイミング

目標とセッションの組み合わせごとに、正確に1回です。MousePlayer は送信前に重複を抑制し、さらにペイロードに ID を付けるため、ネットワーク側でも再度重複を抑制できます。5個の商品をカートに入れた訪問者について、コンバージョンは5件ではなく1件です。

広告アカウントに表示される内容

コンバージョンには、目標名、設定している場合は金額と通貨、発生時刻が含まれます。通常の稼働では1分以内に届きます。

何も届かない場合

• クリック識別子がない。 そのネットワークの広告から来た訪問者ではないか、ピクセルが Cookie を設定する前に到着しています。何も送信しません。これは想定どおりで、エラーではありません。
• 同意がない。 同意チェックが先に適用されます。
• ネットワークが呼び出しを受け付けたが、コンバージョンを拒否した。 Google、TikTok などは、HTTP 200 を返しながら、レスポンス本文にエラーを含める場合があります。当社はステータスだけでなく本文を読み取り、その理由を配信ログに表示します。