Facebookコンバージョンコネクタ構成ガイド

前提条件

FacebookコンバージョンコネクタをWebイベント用に使用する場合、クライアント側のFacebook PixelタグがWebブラウザで実行されている必要があります。詳細については、Facebookヘルプセンターを参照してください。

Facebook広告アカウントの構成でTealiumパートナー統合を有効にするには、次の手順を使用します：

1. Facebook広告マネージャーアカウントにログインし、メニューからイベントマネージャーを選択します。
2. メニューでデータソースを選択し、ピクセルを選択して構成タブをクリックします。
3. サーバーサイドAPIセクションまでスクロールダウンします。
4. パートナー統合セクションでパートナーを選択をクリックします。
5. Tealium接続の承認を選択し、続行をクリックしてTealiumを有効にします。

パートナー統合を切り替えるオプションが表示されない場合は、Tealiumアカウントマネージャーに連絡してサポートを受けてください。

Facebook Pixelタグは自動的にユーザーデータをハッシュ化します。このピクセル機能は変更できません。

API情報

このコネクタは以下のベンダーAPIを使用します：

• API名：Facebook Graph API - Facebook Pixel
• APIバージョン：v22.0
• APIエンドポイント：https://graph.facebook.com

アクション

構成

コネクタマーケットプレイスにアクセスして新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。

コネクタを追加した後、次の構成を構成します：

• ピクセル/データセットID
  • FacebookピクセルID。
  • Facebookピクセルが正しく機能するためには、前提条件で説明されている手順に従って、Facebookピクセルのパートナー統合を有効にすることを確認してください。
  • 詳細については、Meta Pixelの構成とインストール方法を参照してください。

接続テスト

Facebookへの接続をテストするには：

• ピクセルが許可リストに追加され、Tealium用に有効になっている場合、TealiumTestConnectorイベントがピクセルで追跡されます。接続テストをクリックして、TealiumConnectorTestという名前のテストイベントを送信します。
• Facebookイベントマネージャーピクセル概要でイベントが受信されたことを確認します。
• テストに失敗した場合は、構成を再確認してください。

Webイベントの重複排除

このコネクタをFacebook Pixelタグからのイベントの重複排除に構成するには、次の命名規則でイベントIDをイベント属性として送信します：

fb_event_id_{FACEBOOK_EVENT}_{TAG_UID}

Tealium iQのタグテーブルまたはタグ詳細画面でタグのUIDを見つけることができます：

たとえば、UIDが168のタグからの購入イベントは、次の属性値を送信します：

{
  "fb_event_id_Purchase_168": "028b2ade7478..."
}

同じタグからのページビューイベントは、次の属性値を送信します：

{
  "fb_event_id_PageView_168": "084b1cda7461..."
}

各タイプのイベントに対して別のアクションを使用します。イベント固有のイベントID属性をEvent IDにマッピングし、一致するイベント名をEvent Nameにマッピングします。たとえば：

イベントID属性をタグUIDなしでfb_event_id_{FACEBOOK_EVENT}という形式でのみ受け取っている場合は、タグを更新することをお勧めします。詳細については、Facebook Pixel タグ構成ガイドを参照してください。

自動重複排除

自動重複排除値が入力されている場合、コネクタは対応するイベントID属性を検索します。このセクションが入力されていてTealium iQを使用している場合、Event IDを追加する必要はありません。ただし、Tealium iQを使用せずにEventStreamを使用している場合は、次のアプローチが必要になる場合があります。

コネクタは次の操作順序に従います：

• 自動重複排除が入力され、データレイヤーで値が見つかった場合（例：fb_event_id_ViewContent_30）、この値はEvent IDにマッピングされたものより優先されます。
• 自動重複排除が入力されているが、タグIDバージョンを見つけることができず、レガシーバージョン（IDなし）を見つけた場合、その値が使用されます（例：fb_event_id_ViewContent）。
• 自動重複排除が入力されているが、値が見つからない場合は、入力されているEvent IDが使用されます。

オフラインコンバージョン

Facebookコンバージョンコネクタを使用してオフラインおよび店舗イベントを処理するには、必要なパラメータを含めてコネクタを構成します。

前提条件

• FacebookコンバージョンAPIを通じて送信されるオフラインイベントは、Facebookイベントマネージャーのデータセットに関連付けられている必要があります。
• すべてのオフラインおよび店舗イベントについて、広告主はイベントのaction_sourceパラメータをphysical_storeに構成する必要があります。
• オフラインイベントには、すべての必要なイベントパラメータを含める必要があります。詳細については、Meta: Server Event Parametersを参照してください。

構成手順

Facebookコンバージョンコネクタを使用してオフラインおよび店舗イベントを送信するための構成手順は次のとおりです：

1. Facebookイベントマネージャーで、新しいオフラインデータソースを作成するか、既存のものを選択します。構成手順については、Meta: Sending Offline Events Using the Conversions APIを参照してください。
2. コネクタ構成で、オフラインデータソースに関連付けられたデータセットIDを入力します。このIDは、正しいMetaデータセットにイベントを送信するために使用されます。
3. アクションタブで、イベント送信などの新しいアクションを追加します。
4. アクションソースパラメータをphysical_storeにマッピングします。
5. 必要なパラメータをマッピングし、イベントタイプに基づいて必要に応じてオプションのパラメータを含めます。
6. イベントを送信し、Facebookイベントマネージャーで確認します。

詳細については、Meta: Sending Offline Events Using the Conversions APIを参照してください。

自動マッピング

コネクタは、デフォルトで次のパラメータをeコマース拡張機能から自動的にマッピングします：

ベンダーにこれらのパラメータを自動的に送信するのを防ぐには、自動マッピング無効をtrueに構成して有効にします。

アクション

次へをクリックするか、アクションタブをクリックします。アクションタブでコネクタアクションを構成します。

このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

イベント送信

パラメータ

ユーザーデータパラメータについて、以下の表はいくつかのパラメータの重要度を示しています。重要度は、そのパラメータがイベントマッチ品質に与える影響を説明します。例えば、Email (em) の重要度は 最高 であり、電話番号 (ph) の重要度は 高 です。

高度な測定イベントを送信する

このFacebookアクションは限定的に利用可能です。アクセスをリクエストするためにFacebook担当者に連絡してください。このアクションがFacebookアカウントで有効になっていない場合、“このAPIコールを行う機能がアプリケーションにはありません。“または"このピクセルはサーバーイベントを報告する権限がありません。“のようなエラーが返されます。

イベントデータ

ユーザーデータ

すべてのユーザーデータパラメータは文字列または文字列の配列を受け入れます。例: ["<first value>", "<second value>"]。

カスタムデータ

カスタムデータをプレーンテキスト値またはJSONテンプレートを使用してマップします。テンプレート名を{{template_name}}形式で参照します。

コンテンツデータ

自動重複排除

アプリデータ

アプリイベントに必要です。

リードイベントの送信

バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

• リクエストの最大数：1000
• 最も古いリクエストからの最大時間：10分
• リクエストの最大サイズ：1 MB

パラメータ

構成

FacebookとのTealiumサーバーサイドAPIパートナー統合を構成および管理するためのいくつかのオプションがあります。

• Facebookパートナー統合ギャラリー
  

  

• パートナーを選択ボタンを通じてピクセルの構成タブ：

  

• ウェブシグナル構成フローとサーバーサイドAPIガイダンスカード：

  

イベントの確認

イベントを送信した後、概要と詳細ビューでFacebookがそれらを受信したことを確認します：

1. ビジネスマネージャー > ピクセルに移動します。
2. POSTリクエストのPIXEL_IDに対応するピクセルをクリックします。

概要タブ

概要タブでは、すべてからサーバーにビューを変更して、正常に送信されたイベントの数を確認します。

詳細タブ

詳細タブでは、正常に送信されたイベントの内訳を表示します。ドロップされたイベントはServer Events Received列に表示されません。

イベントをサーバーから送信してから20分以内にイベントを確認できます。

検証

検証のために、FacebookのPayload Helperを使用して、サーバーからFacebookにイベントが送信される際のデータパラメータフィールドの構造を確認します。問題のトラブルシューティングについては、Facebookのサポートページを参照してください。

Conversions APIについての詳細は、FacebookのConversions APIの使用を参照してください。