プラットフォームとしてのコンバージョンAPIの設定
タグ管理サービスの一部としてMetaピクセルのセットアップを提供する場合、コンバージョンAPIの機能の追加を検討したいと思われるかもしれません。コンバージョンAPIと連携することによって、顧客は、ブラウザーのピクセルイベントに依存することなくウェブイベントを直接Metaに送信できるようになります。
サーバーイベントvs.ブラウザーイベント
事前に、サーバーイベントとMetaピクセルの関係について十分に理解していることが重要です。サーバーイベントはコンバージョンAPI経由で送信され、ブラウザーのピクセルイベントと同じ方法で、効果測定、レポート作成、最適化に使われます。
ブラウザーピクセルイベントの送信がエアメールに似ているとすれば、サーバーイベントの送信は船便に似ています。いずれも、宛先住所(ピクセルID)に荷物(イベントについてのデータ)を送るメカニズムです。そのため次の理由から、(別個のプラグインやサービスとしてではなく)現行のMetaピクセルのオファリングの拡張機能として、プラットフォーム上にコンバージョンAPIの連携を構築するよう強くおすすめします。
- サーバーイベントはピクセルIDを宛先として使う
- サーバーイベントは、ブラウザーピクセルイベントがFacebookに送信されるのと同じように処理される
- 重複除外の実装がさらに容易になる
- クライアントにとって使いやすい。例えば、サーバーイベントはデフォルトではブラウザーイベントと一緒に送信できます。
プラットフォームがコンバージョンAPIと連携されたら、ブラウザーとサーバーの両方を通じて同じウェブイベントを送信することをおすすめします。こうした重複処理によって、信号の信頼性を確保できます。以前にはネットワークにまつわるさまざまな理由によりブラウザーサイドで失われていたかもしれないイベントが、コンバージョンAPIによってキャプチャされるようになります。
ブラウザーとサーバーを通じてイベントを送信するには、対応するイベントに対して同じevent_idを正しく設定する必要があります。これにより、Facebookはイベントの重複除外処理を適切に実行することができます。
前提条件
- Facebookにイベントを共有できるウェブプラットフォーム。例えば、ウェブサイトビルダー、タグマネージャ、AdTechプラットフォームなど。
- Facebookビジネスツール利用規約に従い、Facebookとのイベントデータシェアに関するユーザーからの適切な通知と同意。
- Facebook担当者
- 標準のコンバージョンAPI統合の前提要件:
プラットフォームとしてのコンバージョンAPIの提供を開始するには、アプリがアプリレビューを受ける必要があります。アプリレビュープロセスにおいて、以下のアクセスレベル、機能、アクセス許可をリクエストする必要があります。
- アクセスレベル: 詳細アクセス
- 機能: 広告管理標準アクセス
- アクセス許可:
ads_management、pages_read_engagement、ads_read
スタートガイド
コンバージョンAPIを初めて使う場合は、以下の手順に従って、ビジネス、Metaアプリ、Metaピクセル、システムユーザーを作成してください。その後、システムユーザーのアクセストークンを使って、コンバージョンAPIを通じてサーバーイベントを送信できるようになります。
ステップ1: ビジネスを作成します。
ステップ2: 新たに作成したビジネスの下にMetaアプリを作成します。
ステップ3: 新たに作成したビジネスの下にMetaピクセルを作成します。
- イベントマネージャを開きます。
- [新しいデータソースを追加]を選択します。
ステップ4: システムユーザーアクセストークンを生成します。
ステップ5: サーバーイベントを自分のMetaピクセルに送信します。
クライアントの代わりにイベントを送信する
サーバーイベントを自分のMetaピクセルに正しく送信できたら、クライアントの代わりにイベントを送信する方法を選べるようになります。
パートナーのビジネスマネージャが所有または管理するMetaピクセルの場合
- ビジネスマネージャの[ユーザー]セクションに移動し、[システムユーザー]タブを選択します。コンバージョンAPIのために使う特定のシステムユーザーをクリックします。
- [アセットの割り当て]ダイアログに移動して[ピクセル]を選択します。その後、イベントを代理送信するピクセルを選択します。
- ピクセルごとに、[ピクセルの管理]アクセス許可を選択し、[変更を保存]をクリックします。
- システムユーザーの詳細ページに戻ります。選択したピクセルがそこに表示されていることを確認してください。
パートナーが管理していないMetaピクセルの場合
まず、クライアントの代わりにイベントを送信するための承認をリクエストする必要があります。次のような認証オプションがあります。
Facebook Business Extension (おすすめ)
このオプションでは、Facebook Business Extension (FBE)から、以降のプロセスでクライアントの代わりにイベントを送信するために必要なすべての情報が返されます。また、クライアントのビジネスマネージャで作成されたシステムユーザーアクセストークンを取得するためのエンドポイントが提供されます。このプロセスには、サーバーイベントを送信するための権限が含まれており、安全な方法で自動的に実行されます。
このエンドポイントは、入力パラメーターとしてユーザーアクセストークンを必要とします。新規のFBEユーザーの場合は、FBEの設定完了後、このエンドポイントを呼び出してシステムユーザーアクセストークンを取得します。既存のユーザーは、新しいAPIエンドポイントを呼び出す前に再認証を要求する必要があります。
クライアントシステムユーザーアクセストークン
このオプションでは、クライアントに、[ピクセル設定]内で、コンバージョンAPI経由でシステムユーザーアクセストークンを手動で作成してもらう必要があります。それから、そのトークンを使って、イベントを広告主のピクセルに送信できます。
システムユーザーまたは管理者システムユーザーが、アクセストークンの生成に使用されるアプリをインストールする必要があります。この設定により、アプリがこのシステムユーザーまたは管理者システムユーザーに代わってAPIを呼び出せるようになります。
スタートガイドのドキュメントにある説明に従い、システムのユーザートークンを広告主からリクエストしてください。テストには、必ず自分独自のMetaピクセルとアクセストークンを使うようにしてください。
パートナーのビジネスマネージャに対してクライアントがMetaピクセルをシェアする
このオプションでは、クライアントが、ビジネスマネージャの設定により、またはAPIを利用して、それぞれのMetaピクセルをパートナーに対してシェアします。その上で、パートナーシステムユーザーをクライアントピクセルに割り当て、サーバーイベントを送信するためのアクセストークンを生成することができます。
partner_agentフィールドを使って該当プラットフォームにイベントをアトリビュートする
該当プラットフォームにコンバージョンAPIのイベントをアトリビュートするには、partner_agentフィールドを使います。そうすれば、クライアントの代わりにイベントを送信する際に、独自のプラットフォーム識別情報を設定できます。Facebookの担当者と相談し、プラットフォームの識別情報について合意しておく必要があります。その後、その識別情報をサーバーイベントごとに送信します。
イベントペイロードの例
プラットフォーム識別情報がdatapartnerの場合、クライアントの代わりに送信される購入イベントペイロードの例は次のようになります。
{
"data": [
{
"user_data": {
"em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
},
"event_name": "PageView",
"event_time": 1579645238
},
{
"user_data": {
"em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
},
"custom_data": {
"currency": "USD",
"value": "50"
},
"event_name": "Purchase",
"event_time": 1579645238
}
],
"partner_agent": "datapartner"
}
よくある質問
コンバージョンAPIを通じて送信されたイベントを送信することは、ピクセルを通じてイベントを送信することによく似ています。唯一の違いは、イベントがブラウザーではなくサーバーを通じて送信されるという点です。ではなぜ、わざわざコンバージョンAPIと統合するのでしょうか？次に、重要な事例をいくつか示します。
1.オフラインとダウンファネルのイベントをキャプチャする
あるユーザーが広告主のウェブサイトを使用してクレジットカードを登録する場合、ViewContent、Application Start、Application Submit などのイベントは、ブラウザーを通じてピクセルに送信することができます。しかし、それでもそのエンドユーザーは、このクレジットカードの承認を得る必要があります。承認のイベントはオフラインで発生するため、ブラウザー経由で送信できません。この最終ステップを登録するため、広告主はコンバージョンAPIを通じて承認を送信することができます。
2.信号の回復
ブラウザーサイドのイベントは、次のようなさまざまな理由で失われることがあります。
- ページ読み込み完了前にユーザーが別のページに移ってしまった
- 広告ブロック機能により、イベント発生が妨げられた
- インターネットの状況が変化したため、ドメイン内メッセージの送信方法が変わった
これらの例の場合、いずれもコンバージョンAPIを通じてイベントを送信することにより、状況を緩和することができます。
3.機密性の高いデータ
ブラウザーを通じてデータを共有する場合、データの表示や調査が可能になってしまうことを心配する広告主は少なくありません。この問題は、データをコンバージョンAPI経由で送信することにより緩和できます。
たとえば、広告主は利益率や顧客生涯価値(LTV)などのデータを、purchaseイベントと共に送信したいと思うかもしれません。そのようにして、特定のタイプの顧客に合わせて広告を最適化することができます。
ブラウザーイベントには上記の障害に対する脆弱性が常にあるため、送信するのは、コンバージョンAPIソースから取得されたイベントのみにするようにおすすめします。たとえば、次の場合です。
- 顧客があなたのプラットフォームにデータを入れる手段の1つが、ブラウザーのjavascriptタグによる場合
- コンバージョンAPIを通じて、そのデータをFacebookに送信する場合
データは、上記質問で言及されているブラウザー側の危険にさらされます。
コンバージョンAPIをフル活用するには、データフローのどの部分もブラウザーに依存しないようにしてください。あなた自身のプラットフォームでその接続をテストできる手段を、広告主に提供するようおすすめします。
そのための1つの方法は、次のとおりです。
- コンバージョンAPIを通じてテストイベントを広告主のピクセルに送信する
200戻りコードを見つける- 適切に接続のステータスをアップデートします。
Facebookは、FacebookピクセルとコンバージョンAPIを使用して送信された同一のイベントの重複を除外します。イベントが同一かどうかは、IDと名前に基づいて判断されます。詳しくは、「ピクセルイベントとサーバーイベントの重複除外」をご覧ください。
External IDとは、広告主のシステム上でユーザーを表している文字列のことです。それらのIDは、広告アトリビューションを向上させたり、オーディエンスを作成したりするのに役立ちます。
external_idは、ブラウザーを通じて、またはコンバージョンAPIを通じて送信できますが、複数のチャネルで一貫していなければなりません。たとえば、external_idが123に設定されたブラウザーピクセルイベントを送信する場合、それと同じユーザーのサーバーイベントでもexternal_idが123に設定されていなければなりません。