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ピクセルの構成とインストール方法を参照してください。

接続テスト

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を使用している場合は、次のアプローチが必要になる場合があります。

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

• 自動重複排除が入力され、値がデータレイヤーで見つかった場合。この値はEvent IDでマッピングされたものよりも優先されます。たとえば、fb_event_id_ViewContent_30。
• 自動重複排除が入力されていますが、タグ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) の重要度は 高 です。

| 性別 | 性別の小文字一文字の値。このパラメータは文字列または文字列の配列を受け入れます。例：["<first value>", "<second value>"]。選択肢は以下の通りです：

• f 女性用
• m 男性用

• productに構成する場合、送信するキーはContent IDsまたはContent Productにあります。Content Productは製品を表します。
• product_groupに構成する場合、送信するキーはContent IDsにあります。Content Productは製品グループを表します。

Send Advanced Measurement Event

この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のペイロードヘルパーをデータパラメータフィールドと共に使用します。このツールは、サーバーからFacebookにイベントを送信する際の構造を示します。問題のトラブルシューティングについては、Facebookのサポートページを参照してください。

コンバージョンAPIについての詳細は、FacebookのコンバージョンAPIの使用を参照してください。