メインコンテンツへスキップ
Conversions API (CAPI) は、Profound Pixel のサーバーサイドのチャネルです。バックエンドからコンバージョンイベントを Profound に直接送信するため、訪問者のブラウザーでは何も実行されません。広告ブロッカーやプライバシー重視のブラウザーによってイベントが失われることはなく、訪問から数時間後に確定した注文も記録されます。 この API はブラウザーのピクセルと同じイベントを受け付け、同じ場所に記録します。異なるのは送信経路だけです。

使用する場面

決済 Webhook、オフラインや電話での注文、サブスクリプションの更新など、コンバージョンがサーバー上で確定する場合に Conversions API を使用します。 コンバージョンのカバレッジを高めるには、ブラウザーのピクセルを使用したうえで、同じコンバージョンをサーバーからも送信することをお勧めします。両者は失敗する箇所が異なります。ブラウザーのピクセルはサーバーからは見えない訪問や意図を記録し、サーバーは広告ブロッカー、閉じられたタブ、プライバシー重視のブラウザーによって失われてしまう注文を記録します。両方を組み合わせることで、どちらか一方だけの場合よりもはるかに多くをカバーできます。
Profound がイベントのペアを照合できるよう、両方のイベントで同じ注文 ID を dedup_key として送信してください。重複排除を参照してください。

始める前に

  • ピクセル ID を用意します。 各イベントには、そのイベントが属するピクセルを指定します。ピクセル ID の生成方法はインストールガイドに記載されています。
  • コンバージョンを広告に紐づけるには、ブラウザーのピクセルをインストールします。 コンバージョンを広告に紐づけるための値は、ブラウザーのピクセルが書き込む Cookie から取得されます。これらがない場合、Profound はコンバージョンを記録しますが、広告に紐づけることはできません。アトリビューションを参照してください。

CAPI キーを取得する

CAPI には専用のホストとキーがあります。認証で説明している REST API キーはここでは使用できません。
1

キーを生成する

Profound プラットフォームで左側のナビゲーションから Ads を開き、Conversions を選択してから、Conversions API の下で Generate CAPI key を選択します。キーを生成するには、ピクセル設定の権限が必要です。ボタンが表示されない場合は、Admin または Editor ロールを持つユーザーにキーの生成を依頼してください。
2

キーをコピーする

キーは pfck_ で始まります。Profound がキーを表示するのは作成時の 1 回だけなので、すぐにコピーしてください。
3

安全な場所に保管する

キーはシークレットとして扱ってください。キーは組織全体を認証し、組織が所有するすべてのピクセルに書き込むことができます。
1 つの組織で保持できる有効なキーは最大 10 個です。失効したキーは上限にカウントされません。