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 Pixel ID。
  • Facebook Pixelが正しく機能するためには、前提条件で説明されている手順に従って、Facebook Pixelのパートナー統合を有効にすることを確認してください。
  • 詳細については、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属性をfb_event_id_{FACEBOOK_EVENT}（タグUIDなし）の命名形式でのみ受信している場合は、タグを更新することをお勧めします。詳細については、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コンバージョンコネクタを使用してオフラインおよび店舗イベントを処理するには、action_sourceパラメータをphysical_storeに構成します。

アクション

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

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

イベント送信

パラメータ

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

自動マッピングを無効にする

コネクタはデフォルトで以下のパラメータを自動マッピングします：

• ブラウザID (fbp)
• ユーザーエージェント (fbc)

自動マッピングを無効にするには、自動マッピングを無効にするをtrueに構成します。自動マッピングされたパラメータはベンダーに送信されません。

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

この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に対応するピクセルをクリックします。

概要タブ

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

詳細タブ

詳細タブでは、正常に送信されたイベントの内訳が表示されます。ドロップされたイベントはサーバーイベント受信列に表示されません。

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

検証

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

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