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

前提条件

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

Facebook Adsアカウントの構成でTealiumパートナー統合を有効にします。

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

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

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

API情報

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

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

コネクタのアクション

アクション名	AudienceStream	EventStream
イベントを送信する	✓	✓
リードイベントを送信する	✓	✓

構成の構成

コネクタマーケットプレイスに移動して、新しいコネクタを追加します。コネクタの追加方法については、コネクタの概要の記事を読んでください。

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

データセットID
- Facebook Pixelが動作するためには、Facebookピクセルのパートナー統合を有効にするためにFacebook Server-Side Events Connector Setup Guideで説明されている手順に従っていることを確認してください。
- 追加情報については、Facebook Pixelセットアップガイドを参照してください。
接続のテスト
- ピクセルがTealiumにホワイトリスト化され、Tealiumで有効になっている場合、TealiumTestConnectorイベントがピクセルでトラッキングされます。テスト接続をクリックして、TealiumConnectorTestという名前のテストイベントを送信します。
- Facebookイベントマネージャーピクセルの概要を確認して、イベントが受信されたことを確認します。
- テストが失敗した場合は、Facebook Server-Side Events Connector Setup Guideで説明されている手順を再確認してください。

アクションの構成 - パラメータとオプション

次へをクリックするか、アクションタブをクリックします。アクションのパラメータとオプションをアクションタブで構成します。

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

Facebook PixelおよびFacebookコンバージョンAPIの重複排除

このコネクタアクションを構成して、Facebook PixelタグからiQ Tag ManagementアカウントでイベントIDを受け取るようにするには、次の命名規則を使用してイベント属性を構成します：

fb_event_id_<Facebook Event>_<Tag UID>

例：fb_event_id_Purchase_32またはfb_event_id_PageView

以前はfb_event_id_<Facebook Event>として生成されたIDがありました。これらのIDは引き続き生成されますが、レガシーと見なされます。新しいIDは、単一のページで複数のFacebookタグが発火する場合に使用でき、関連するタグにより強力な関連付けが可能です。レガシーバージョンを使用している場合は、コネクタを新しいIDに変更する必要があります。

各タイプのイベントIDに対して別個のアクションを使用します。イベント固有のイベントID属性をイベントIDにマッピングし、マッチングイベント名をイベント名にマッピングします。例：

Tealium属性/値	Facebookパラメータ
`fb_event_id_Purchase`	イベントID
“Purchase” (カスタムテキスト)	イベント名

Facebook Pixelタグセットアップガイドを参照してください。

自動重複排除

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

コネクタは次の操作順序を使用します：

自動重複排除が入力されており、データレイヤーでその値が見つかった場合（たとえば、fb_event_id_ViewContent_30）、この値はイベントIDでマッピングされたものよりも優先されます。
自動重複排除が入力されており、タグIDバージョンが見つからない場合、ただし、レガシーバージョン（IDが添付されていないバージョン）が見つかる場合、その値が使用されます（たとえば、fb_event_id_ViewContent）。
自動重複排除が入力されており、値が見つからない場合、マッピングされたイベントIDが入力されている場合は、それが使用されます。

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

新しい統合には、Facebookオフラインコンバージョンコネクタの代わりにFacebookコンバージョンコネクタを使用することをお勧めします。

Facebookコンバージョンコネクタを使用してオフラインおよびストアイベントを処理するには、action_sourceパラメータをphysical_storeに構成します。

アクション - イベントを送信する

パラメータ

ユーザーデータパラメータについては、次の表にいくつかのパラメータの重要度レベルを示します。重要度レベルは、イベントの一致品質に対するパラメータの影響度を示します。たとえば、Email (em)の重要度レベルは最高であり、Phone Number (ph)の重要度レベルは高です。

パラメータ	説明
イベントソースURL	オプションアクションソースがwebsiteに構成されている場合は必須です。イベントが発生したブラウザのURL。 EventStream - アクションソースがwebsiteに構成されており、このフィールドがマッピングされていない場合、EventStreamのCurrent URL属性に自動的にマッピングされます。 AudienceStream - アクションソースがwebsiteに構成されており、このフィールドがマッピングされていない場合、AudienceStreamのLast Event URL属性に自動的にマッピングされます。
テストイベントコード	オプションテストイベントウィンドウでイベントアクティビティを表示するために、`test_event_code`パラメータでテストIDを送信します。 `test_event_code`で送信されたイベントは破棄されず、代わりにイベントマネージャーにフローし、ターゲティングおよび広告測定の目的で使用されます。
データ処理オプション	必須値をLDUにマッピングして、Facebookが制限付きデータ使用でイベントを処理するようにします。それ以外の場合は、`None`をマッピングして、イベントを制限付きデータ使用で処理しないように指定します。詳細については、Facebookデータ処理オプションを参照してください。
イベント名	必須 Facebookピクセルの標準またはカスタムイベント名。
デバッグレベル	オプションイベントのトレースレベルを指定します。 `1`：エラー `2`：情報 `3`：デバッグデータのハッシュ化を検証するためにTraceを使用する場合、Traceの上部に表示されるuser_data - EMAILなどのデータは、コネクタに入力されたデータであり、Facebookに送信されたデータではありません。Facebookに送信されたデータは、TraceのRequest Bodyセクションに表示されます。
アクションソース	必須。変換が発生した場所を指定できるフィールドです。有効なアクションソースは次のとおりです： `email` `website` `app` `phone_call` `chat` `physical_store` `system_generated` `other`
データセットIDオーバーライド	オプション文字列初期コネクタ構成で使用される値を上書きするために使用できます。指定しない場合、コネクタ構成からデータセットIDが使用されます。
データ処理オプション国	データ処理オプションがLDUにマッピングされている場合は必須です。ユーザーイベントに関連する国コードをマッピングします。受け入れられるコード値：米国の場合は`1` Facebookによるジオロケーションをリクエストする場合は`0` ジオロケーションには、Client IP Address属性のマッピングも必要です。
イベントID	オプション Facebookがサーバーとブラウザの両方から送信された同じイベントを重複排除するために使用するIDです。これがブラウザとサーバーから送信された1つのイベントのユニークなIDであることを確認してください。
イベント時間	オプション実際のイベントが発生したUnixタイムスタンプ（秒単位）（欠落している場合は実行時に自動的に初期化されます）。
データ処理オプション州	データ処理オプションがLDUにマッピングされている場合は必須です。ユーザーイベントに関連する州コードをマッピングします。受け入れられるコード値：カリフォルニア州の場合は`1000` Facebookによるジオロケーションをリクエストする場合は`0` ジオロケーションには、Client IP Address属性のマッピングも必要です。
オプトアウト	オプトアウトフラグ。このイベントを広告配信の最適化に使用しないようにするために使用します。広告配信の属性にこのイベントのみを使用するには、これをtrueに構成します。
郵便番号 (zip)	郵便番号。例：`94035`。重要度: 中
FBログインID	アプリに初めてログインしたときにFacebookから発行されるID。これはまた、App-Scoped IDとしても知られています。ハッシュ化しないでください。
パートナーID	パートナーのID。このパラメータは、LiverampやTradeDeskなどのサードパーティIDプロバイダが追加のユーザー識別子として使用できます。ハッシュ化しないでください。
パートナー名	パートナーの名前。このパラメータは、LiverampやTradeDeskなどのサードパーティIDプロバイダが追加のユーザー識別子として使用できます。ハッシュ化しないでください。
クライアントユーザーエージェント (ua)	オプションアクションソースがwebsiteに構成されている場合は必須です。イベントに対応するブラウザのユーザーエージェント。ハッシュ化しないでください。 EventStream - アクションソースがwebsiteに構成されており、このフィールドがマッピングされていない場合、EventStreamのUser Agent属性に自動的にマッピングされます。 AudienceStream - アクションソースがwebsiteに構成されており、このフィールドがマッピングされていない場合、AudienceStreamの訪問の最後のUser Agentに自動的にマッピングされます。重要度: 高
クライアントIPアドレス (ip)	ハッシュ化しないでください。イベントに対応するブラウザのIPアドレス。TealiumはクライアントIPアドレスをキャプチャできますが、デフォルトでは使用できません。この機能を有効にするには、カスタマーサクセスマネージャーに連絡してください。詳細については、サーバーサイドTealium製品でのIPアドレスの収集の有効化を参照してください。重要度: 高
電話番号 (ph)	電話番号。国コード、市外局番、番号を含めて数字のみを使用します。例：16505551212 重要度: 高
州 (st)	米国の州の略称。例：ca。重要度: 中
メールアドレス (em)	メールアドレス。例：`user@example.com`。重要度: 最高
姓 (ln)	姓（小文字）。例：`smith`。重要度: 中
名 (fn)	名（小文字）。例：`joe`。重要度: 中
リードID	Facebookのリード広告で生成されたリードに関連するID。ハッシュ化しないでください。
都市 (ct)	スペースや句読点を含まない都市名（小文字）。例：menlopark。重要度: 中
国 (country)	小文字の2文字の国コード。例：`us`。重要度: 中
外部ID	ハッシュ化しないでください。広告主からの一意のID（ロイヤリティメンバーシップID、ユーザーID、外部クッキーIDなど）。
ブラウザID (fpb)	ハッシュ化しないでください。 Facebookの`_fbp`クッキーに格納されているブラウザID値。重要度: 高
サブスクリプションID	ハッシュ化しないでください。このトランザクションのユーザーのサブスクリプションID。これは個々の製品の注文IDに類似しています。例：anid1234
性別	小文字。オプションは次のとおりです：女性の場合はf 男性の場合はm
誕生日	年、月、日で指定された誕生日。例：19971226は1997年12月26日を表します。
クリックID (fbc)	ハッシュ化しないでください。 Facebookの`_fbc`クッキーに格納されているFacebookクリックID値。このパラメータは自動的にマッピングされますが、無効になっている場合は手動でマッピングする必要があります。重要度: 高
ユーザーデータはすでにハッシュ化されています	Facebookコンバージョンコネクタでは、Facebook Pixelタグが必要であり、ユーザーデータを自動的にハッシュ化します。このピクセルの機能は変更できません。データを再度ハッシュ化しないようにするには、このオプションを選択します。
通貨	該当する場合に指定された値の通貨。通貨は有効なISO 4217の3桁の通貨コードである必要があります。例：usd
コンテンツ名	イベントに関連するページまたは製品の名前。例：lettuce
アイテム数	InitiateCheckoutイベントでのみ使用します。ユーザーがチェックアウト中に購入しようとするアイテムの数。例：4
検索文字列	ユーザーが行った検索クエリ。 Searchイベントとのみ使用します。例：lettuce
注文ID	このトランザクションの注文ID。例：order1234
コンテンツタイプ	productまたはproduct_groupのいずれかである必要があります。 Content IDsまたはContent Productに送信するキーがある場合は、productに構成します。 Content Productは製品を表します。 Content IDsに送信するキーがある場合は、product_groupに構成します。 Content Productは製品グループを表します。
予測されるライフタイムバリュー	コンバージョンイベントの予測されるライフタイムバリュー。例：432.12
コンテンツID	イベントに関連するコンテンツID（AddToCartイベントのアイテムの製品SKUなど）。例：[‘ABC123’, ‘XYZ789’]。非配列のイベント属性が提供された場合、それは単一アイテムの配列に変換されます。 Content Typeがproductの場合、このマッピングされた値は非配列のイベント属性または単一要素配列である必要があります。
値	このイベントに関連する数値の値。これは通貨の値または他のメトリックの値である場合があります。例：142.54
コンテンツカテゴリ	イベントに関連するコンテンツのカテゴリ。例：grocery
数量	製品の数量。
価格	製品の個別の価格。
ID	製品のID。
JSONテンプレート変数	テンプレート変数をデータ入力として提供します。テンプレート変数ガイドを参照してください。ネストされたテンプレート変数はドット表記法で名前付けします。例 `items.name`。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
JSONテンプレート	有効なJSONテンプレートを提供して、カスタムデータセクションで参照されるようにします。テンプレートは、名前を二重中括弧で囲んでサポートされるフィールドに挿入されます。例：`{{SomeTemplateName}}`。詳細については、Webhook - カスタムリクエストの送信 - Trimouテンプレートエンジンガイドを参照してください。
Tealium iQタグID	Facebook PixelタグID。
自動マッピングの無効化	パラメータの自動マッピングを無効にします。
自動重複排除	Tealium iQタグIDが指定されている場合、Tealium iQから送信されたEvent ID値を自動的に検索します。
広告主トラッキングの有効化	必須。iOS 14.5+デバイスでのATTパーミッションを指定するためにこのフィールドを使用します。無効にする場合は`0`、有効にする場合は`1`に構成します。
アプリトラッキングの有効化	必須。アプリレベルで広告トラッキングを有効にすることができます。SDKはアプリ開発者がアプリにオプトアウト構成を入れることができるようにする必要があります。このフィールドを使用して、ユーザーの選択肢を指定します。無効にする場合は`0`、有効にする場合は`1`を使用します。
アプリバージョン	必須。Androidの場合はバージョンは`a2`、iOSの場合は`i2`である必要があります。
OSバージョン	必須。OSバージョン、例：`13.4.1`。
アプリパッケージ名	アプリのパッケージ名、例：`com.facebook.sdk.samples.hellofacebook`。
ショートバージョン	ショートバージョン、例：`1.0`。
ロングバージョン	ロングバージョン、例：`1.0 long`。
デバイスモデル名	デバイスモデル名、例：`iPhone5,1`。
ロケール	ロケール、例：`En_US`。
タイムゾーンの略称	タイムゾーンの略称、例：`PDT`。
キャリア	キャリア、例：`AT&T`。
画面の幅	画面の幅、例：`320`。
画面の高さ	画面の高さ、例：`568`。
画面の密度	画面の密度、例：`2`。
CPUコア数	CPUコア数、例：`2`。
保存サイズ（GB）	外部保存のサイズ（GB）、例：`13`。
空き容量（GB）	外部保存の空き容量（GB）、例：`8`。
デバイスタイムゾーン	デバイスのタイムゾーン、例：`USA/New York`。
キャンペーンID	FacebookからリンクをクリックしたユーザーがアウトバウンドURL（たとえば、`ad_destination_url`）またはディープリンク（App Aggregated Event Managerの場合）に追加される暗号化された文字列と非ユーザーメタデータ。
インストールリファラ	サードパーティのインストールリファラ。現在はAndroidのみで利用可能です。詳細については、キャンペーン測定を参照してください。
インストーラーパッケージ	Android SDKの内部で使用されます。
URLスキーム（配列）	iOSおよびAndroidのSDKで内部的に使用されます。
WindowsのアトリビューションID	Windows 10で使用されるアトリビューショントークン。
Anon ID	インストールID。このフィールドは、一意のアプリケーションインストールインスタンスを表します。
MADID	モバイル広告主ID。通常、Androidデバイスの広告IDまたはAppleデバイスの広告識別子（IDFA）です。

アクション - リードイベントを送信する

バッチ制限

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

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

パラメータ

パラメータ	説明
リードID	（必須）ダウンロードしたリードから取得したFacebookが生成した15または16桁の`leadgen_id`。この番号は、リードジェネレーションWebフックの`leadgen_id`フィールドから取得し、`user_data`パラメータに含まれます。
イベント名	（必須）CRMで使用するリードステージをキャプチャします。`event_name`パラメータは、CRMのセールスファネルを通過するリードを示す必要があります。更新されるたびにすべてのステージを送信し、生のリードも含めて送信してください。
イベント時間	CRMによって更新されたリードステージの更新イベントが更新されたUnixタイムスタンプ（秒単位）。タイムスタンプはリード生成時間の後に発生する必要があります。このフィールドがマッピングされていない場合、現在のタイムスタンプで初期化されます。
テストイベントコード	Facebookがサーバーイベントを正しく受信しているかどうかを確認するために、イベントマネージャのテストイベント機能を使用できます。ツールを見つけるには、イベントマネージャ > データソース > ピクセル > テストイベントに移動します。