Facebook Pixel タグ構成ガイド | クライアントサイドタグ

従来の Facebook Pixel についての情報は、Facebook Pixel 構成ガイド（レガシー）をご覧ください。

動作方法

注文 ID が入力されると、購入追跡が自動的に行われます。
Pixel ID フィールドには、カンマ区切りの Pixel ID リストを入力できます。
イベント ID の生成: trueに構成すると、Facebook Pixel で event_id パラメータが生成され、これらのイベント ID がサーバーサイド属性として利用可能になります。
- 最新バージョンの Tealium Collect タグが必要です。
- event_id にカスタム変数をマッピングする場合は、true に構成する必要があります。
- 詳細については、Web 用コンバージョン API を参照してください。
テンプレートは自動的に num_items 値を計算しようとします。製品数量配列が存在する場合です。
マッピングを使用して以下を行います：
- trackSingle の切り替え（デフォルトでは true）
- disablePushState の切り替え（デフォルトでは false）
- タグ構成を動的に構成
- E-Commerce 拡張の値を上書き
次の E-Commerce 拡張パラメータをサポートします：
- 注文 ID
- 小計
- 通貨
- 製品 ID のリスト
- 製品カテゴリのリスト
- 製品価格のリスト
- 製品数量のリスト
- 製品名のリスト
Pixel タグは自動的にユーザーデータをハッシュ化します。

Web 用コンバージョン API

この機能にはアクティブな Tealium Collect タグが必要です。

Web 用 Facebook コンバージョン API をサポートするには、イベント ID の生成 を true に構成します。イベント ID の生成 が有効になると、このタグは各イベントを追跡するための一意のイベント ID を生成し、それを Tealium EventStream に属性として送信し、Facebook コンバージョンコネクタで使用し、Facebook Pixel に event_id パラメータとして渡します。このイベント ID 属性は、コネクタでマッピングされ、Web ベースのタグをサーバーサイド統合と同期させることができます。

タグは次の命名規則を使用してイベント ID を送信します：

fb_event_id_{FACEBOOK_EVENT}_{TAG_UID}

例えば、タグ #32 からの購入イベントは次の属性と値を送信します：

{
  "fb_event_id_Purchase_32": "028b2ade7478..."
}

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

{
  "fb_event_id_PageView_32": "084b1cda7461..."
}

重複排除

適切なイベントの重複排除を確保するために、Facebook Pixel タグからのイベント ID を Tealium Collect タグによって送信されるペイロードに含める必要があります。これを行うには、次の手順を実行します：

タグタイミング ドロップダウンから優先を選択します。
バンドルフラグ トグルを オン に構成します。
ロードオーダーマネージャー画面を使用して、Tealium Collect タグの前に Facebook Pixel タグを発火させます。Tealium Collect タグは最後に発火させることをお勧めします。

これらのイベント ID 属性の使用に関する情報は、Facebook コンバージョンコネクタ：Web イベントの重複排除を参照してください。

レガシーイベント ID

Facebook Pixel タグの古いバージョンでは、イベント ID 属性は fb_event_id_{FACEBOOK_EVENT} の形式で生成されていました。例えば fb_event_id_Purchase です。これらの古い属性名はタグによって引き続き生成されますが、同じページ上で複数の Facebook タグをサポートしないため、レガシーと見なされます。

Facebook Pixel タグの最新バージョンは、生成された属性名にタグ UID を含めることで、ページ上で複数の Facebook タグの発火をサポートします。もしまだレガシー形式のイベント ID 属性を使用している場合は、タグの最新バージョンに更新し、新しいイベント ID 属性を参照することをお勧めします。

タグ構成

まず、Tealium タグマーケットプレースにアクセスして Facebook Pixel タグを追加します（タグの追加方法について詳しくはこちら）。

タグを追加した後、次の構成を構成します：

Pixel ID
- あなたの Facebook Pixel ID。
- Pixel ID はコードスニペット内で長い数字のシリーズとして表示されます。
- 複数の Pixel ID をカンマ区切りリストで入力できます。スペースは入れません。
- 例：fbq("init", "12345678901234");
高度なマッチング
- Facebook Advanced Matching サービスにデータを渡して有効にします。
- 例：fbq("init", "12345678901234", {em:"6dd8b7d7..."});
- 高度なマッチング を有効にして個人識別情報（PII）を含むパラメータをマッピングする場合は、自動高度なマッチング を Meta Events Manager で無効にし、パラメータを手動でのみマッピングすることを強くお勧めします。自動高度なマッチング は、必要とされる範囲外の追加の PII パラメータをマッピングする可能性があり、セキュリティおよびプライバシーの問題を引き起こす可能性があります。詳細については、Facebook のウェブサイトまたはモバイルアプリの自動高度なマッチングの構成を参照してください。
イベント ID の生成
- サーバーサイドでイベント ID を送信するために Tealium Collect タグが必要です。
- すべての Facebook トラッキングイベントに対して自動的にイベント ID を生成します。
- イベント ID 属性は次の命名規則に従います：fb_event_id_{FACEBOOK_EVENT}_{TAG_UID}
- 例："fb_event_id_Purchase_32" : "028b2ade7478..."

イベントマッピング

Facebook Pixel イベントは、イベントにマップする変数を選択し、トリガーを入力することによってデータマッピングを通じて構成されます。トリガーは、変数が特定の値に等しい場合にイベントを開始します。次のユースケースで示されています。

ユースケース：購入イベント

購入イベントを構成するには：

変数ドロップダウンリストから tealium_event を選択し、宛先を選択 をクリックします。
カテゴリ セクションで イベント を選択します。
マップされた変数が等しい場合 フィールドに Purchase を構成します。これは tealium_event が購入をトリガーするために等しくなければならない値です。
トリガーイベント ドロップダウンリストで Purchase を選択します。これは tealium_event が購入に等しい場合にトリガーされるイベントです。

購入イベントに送信する追加データが必要な場合は、カスタムパラメータ を使用して追加の購入データをマッピングします。

次の例では、購入イベントに製品ブランドを渡します：

変数ドロップダウンリストから product_brand を選択し、宛先を選択 をクリックします。
カテゴリ セクションで イベント固有のパラメータ を選択します。
宛先フィールドにカスタムパラメータの名前 brand を構成します。
イベントのために ドロップダウンリストで Purchase イベントを選択します。このカスタムパラメータはそのイベントで収集されます。

Facebook Pixel Helper またはブラウザの開発者ツールを使用してマッピングをテストします。

ネットワークパネル を使用し、Facebook をキーワードとして含むすべてのネットワークリクエストを表示するために Facebook でフィルタリングします。
リクエストの名前を見て、購入イベントが成功したことを確認します。
リクエストを開き、クエリ文字列パラメータ までスクロールダウンして、構成されたデータマッピングの値を確認します：purchase , product_id , product_brand。

データマッピング

データマッピングは階層構造を持ち、特定のマッピング（例えばイベント固有のパラメーター）は一般的なマッピングよりも優先されます。例えば、標準トラッキングパラメーター タブで変数を Currency 宛先にマッピングし、ViewContent イベントのためにも Currency 宛先にマッピングした場合、ViewContent のマッピングが一般的なマッピングよりも優先されますが、これは ViewContent イベントにのみ適用されます。他のすべてのイベントには、標準トラッキングマッピングが使用されます。

マッピングとは、データレイヤー変数からベンダータグの対応する宛先変数へデータを送信するプロセスです。変数をタグ宛先にマッピングする方法については、データマッピングを参照してください。

利用可能なカテゴリーは以下の通りです：

タグ構成

変数	宛先	タイプ	説明
`pixel_id`	ピクセルID	文字列	あなたのFacebookピクセルID。ピクセルIDはコードスニペット内で長い数字のシリーズとして表示されます。カンマ区切りのリストを使用して複数のピクセルIDを入力できます（スペースなし）。例：`fbq("init", "12345678901234");`
`autoConfig`	自動構成の切り替え	ブール値	自動構成を切り替えます。
`auto_page_view`	自動ページビューの切り替え	ブール値	ページロード時にページビューイベントをトリガーする自動ページビュートラッキングを有効または無効にします。デフォルト値は `true` です。
`advanced_matching`	高度なマッチングの切り替え	ブール値	高度なマッチングデータの収集を有効または無効にします。デフォルト値は `true` です。
`generate_event_id`	イベントIDの生成	ブール値	各Facebookトラッキングイベントに対して一意のイベントIDの生成を有効または無効にします。イベントIDを生成するためには、タグ構成ページでイベントIDの生成を有効にする必要があります。 IDを生成するためには、最新バージョンの `utag.js` ファイルが必要です。デフォルト値は `false` です。
`calc_items`	アイテム数の自動計算	ブール値	イベントのアイテム数を自動的に決定するかどうかを制御する切り替えです。製品数量にマッピングされたデータを使用して数を決定します。デフォルト値は `true` です。
`track_single`	trackSingleの使用の切り替え	ブール値	Facebookトラッキングイベントのための `trackSingle` の使用を有効または無効にします。デフォルト値は `true` です。 `false` に構成されている場合、すべてのFacebookトラッキングコールに `track` の値が使用されます。
`disablePushState`	disablePushStateの使用の切り替え	ブール値	`disablePushState` 構成の切り替えで、同じページで複数のページビューがトリガーされるのを防ぐかどうかを制御します（シングルページアプリの場合）。デフォルト値は `false` です。
`event_id`	イベントID	文字列	イベントID。

高度なマッチング

変数	宛先	タイプ	説明
`am.em`	メール	文字列	メールアドレス。タグはこの値を自動的に小文字に変換します。この値はプレーンテキスト、または正規化されてSHA-256ハッシュ化されたものにすることができます。
`am.fn`	名	文字列	名。
`am.ln`	姓	文字列	姓。
`am.ph`	電話番号	文字列	電話番号。
`am.ge`	性別	文字列	性別。タグはこの値を自動的に小文字に変換します。この値は `m` または `f` でなければなりません。
`am.db`	生年月日	文字列	生年月日。タグはこの値を自動的に小文字に変換します。この値は8文字でなければなりません。
`am.ct`	市	文字列	市。
`am.st`	州	文字列	州。
`am.zp`	郵便番号	文字列	郵便番号。タグはこの値を自動的に小文字に変換します。この値は5文字以下でなければなりません。
`am.external_id`	外部ID	文字列	外部ID。

Eコマース

Facebook PixelタグはEコマース対応であり、デフォルトでEコマース拡張のマッピングを使用します。拡張マッピングを上書きするか、拡張で提供されていないEコマース変数を使用したい場合を除き、このカテゴリでの手動マッピングは必要ありません。

変数	宛先	説明	Eコマース拡張変数の上書き
`order_id`	注文ID	最終注文に割り当てられた一意の識別子。	`_corder`
`order_subtotal`	小計	最終注文の小計金額。	`_csubtotal`
`order_currency`	通貨	支払いに使用される通貨。	`_ccurrency`
`delivery_category`	配送カテゴリ	配送カテゴリ。
`product_id`	製品IDのリスト	製品配列内の各製品の一意の識別子。	`_cprod`
`product_name`	製品名のリスト	製品配列内の各製品の名前。	`_cprodname`
`product_quantity`	製品数量のリスト	製品配列内の製品の数量。	`_cquan`
`product_category`	カテゴリのリスト	製品配列内の各製品のカテゴリ。	`_ccat`
`product_unit_price`	価格のリスト	製品配列内の各製品の単価。	`_cprice`

標準トラッキングパラメータ

変数	宛先	タイプ	説明
`currency`	通貨	文字列	イベントの値の通貨。
`content_category`	コンテンツカテゴリ	配列または文字列	ページまたは製品のカテゴリ。
`content_name`	コンテンツ名	配列または文字列	ページまたは製品の名前。
`content_ids`	コンテンツID	整数または文字列の配列	イベントに関連する製品IDまたはSKU。
`content_type`	コンテンツタイプ	文字列	コンテンツIDに関連する製品タイプで、Facebook製品フィードに記載されているタイプと一致します。ほとんどの場合、この値は`product`または`product_group`です。ダイナミック広告では、各ビジネス縦断で他の正当な値があります。
`contents`	コンテンツ	JSONオブジェクトの配列	数量とコンテンツIDを含むJSONオブジェクトの配列。
`predicted_ltv`	予測生涯価値	数値	広告主によって定義された購読者の予測生涯価値で、正確な値として表現されます。
`search_string`	検索文字列	文字列	訪問が`Search`イベントのために入力した文字列。
`status`	ステータス	文字列	`completeRegistration`イベントの登録状況。
`num_items`	アイテム数	整数	イベントのアイテム数。アイテム数は、数量にマッピングされた値に基づいて自動的に計算されます。データマッピングまたは拡張機能で`calc_items` (`u.data.calc_items`)を`false`に構成することで自動計算を無効にします。
`value`	価値	数値	このイベントを実行するユーザーのビジネスへの価値

コンテンツタイプ

標準トラッキングパラメータタブまたはイベント固有パラメータマッピングで直接content_typeパラメータにマッピングして構成します。

コンテンツタイプタブでは、以下のサポートされている値のいずれかにcontent_typeパラメータを条件付きで構成できます：

destination
flight
home_listing
hotel
product
product_group
vehicle

マッピングされた変数がフィールドに入力した値と等しい場合、ドロップダウンリストから選択したタイプに値が構成されます。ほとんどの場合、productまたはproduct_groupが使用され、その値はFacebookにアップロードされた製品フィードのcontent_typeと一致する必要があります。他の値は主にダイナミック広告で使用されます。

変数	タイプ	説明
`destination`	文字列	目的地。
`flight`	文字列	フライト。
`home_listing`	文字列	ホームリスティング。
`hotel`	文字列	ホテル。
`product`	文字列	製品。
`product_group`	文字列	製品グループ。
`vehicle`	文字列	車両。

イベント

イベント名	説明
`AddPaymentInfo`	支払情報を追加。
`AddToCart`	カートに追加。
`AddToWishlist`	ほしい物リストに追加。
`CompleteRegistration`	登録完了。
`Contact`	連絡。
`CustomizeProduct`	製品のカスタマイズ。
`Donate`	寄付。
`FindLocation`	位置を検索。
`InitiateCheckout`	チェックアウトを開始。
`Lead`	リード。
`PageView`	ページビュー。
`Purchase`	購入。
`Schedule`	スケジュール。
`Search`	検索。
`StartTrial`	トライアル開始。
`SubmitApplication`	申請を提出。
`Subscribe`	登録。
`ViewContent`	コンテンツを表示。
`Custom`	カスタムイベント名を指定したフィールドに入力します。

イベント固有パラメータ

特定のイベント専用のパラメータをマッピングするには：

ドロップダウンリストからパラメータの名前を選択します。
構成したいパラメータの名前を入力します。
そのパラメータを構成したいイベントの名前を選択します。

カスタムイベントのパラメータをマッピングする場合、表示されるフィールドにカスタムイベントの名前を入力する必要があります。
カスタムパラメータ名を入力したい場合は、パラメータドロップダウンリストからカスタムオプションを選択し、表示されるフィールドにカスタムパラメータの名前を入力します。
イベント固有のマッピングを行うカスタムイベントを指定したい場合は、イベントドロップダウンリストからカスタムオプションを選択し、表示されるフィールドにカスタムイベントの名前を入力します。

変数	説明
`AddPaymentInfo`	支払情報を追加。
`AddToCart`	カートに追加。
`AddToWishlist`	ほしい物リストに追加。
`CompleteRegistration`	登録完了。
`Contact`	連絡。
`content_type`	コンテンツタイプ。
`CustomizeProduct`	製品のカスタマイズ。
`Donate`	寄付。
`FindLocation`	位置を検索。
`InitiateCheckout`	チェックアウトを開始。
`Lead`	リード。
`PageView`	ページビュー。
`Purchase`	購入。
`Schedule`	スケジュール。
`Search`	検索。
`StartTrial`	トライアル開始。
`SubmitApplication`	申請を提出。
`Subscribe`	登録。
`ViewContent`	コンテンツを表示。
`Custom`	カスタム。

自動車パラメータ

変数	宛先	タイプ	説明
`body_style`	ボディスタイル	文字列	ボディスタイル
`condition_of_vehicle`	車両の状態	文字列	車両の状態
`country`	国	文字列	国
`drivetrain`	駆動方式	文字列	駆動方式
`exterior_color`	外装色	文字列	外装色
`fuel_type`	燃料タイプ	文字列	燃料タイプ
`interior_color`	内装色	文字列	内装色
`lead_type`	リードタイプ	文字列	リードタイプ
`make`	メーカー	文字列	メーカー
`model`	モデル	文字列	モデル
`postal_code`	郵便番号	文字列	郵便番号
`preferred_price_range`	希望価格範囲	配列	最小および最大の希望価格の配列
`price`	価格	数値	価格
`registration_type`	登録タイプ	文字列	登録タイプ
`search_type`	検索タイプ	文字列	検索タイプ
`state_of_vehicle`	車両の状態	文字列	車両の状態
`transmission`	トランスミッション	文字列	トランスミッション
`trim`	トリム	文字列	トリム
`viewcontent_type`	コンテンツタイプを見る	文字列	コンテンツタイプ
`vin`	VIN	文字列	車両識別番号
`year`	年	数値	車両の年

宛先パラメータ

変数	タイプ	説明
`city`	文字列	市
`country`	文字列	国
`num_adults`	数値	大人の数
`num_children`	数値	子供の数
`region`	文字列	地域
`suggested_destinations`	配列	提案された目的地の配列
`travel_start`	日付	旅行開始日
`travel_end`	日付	旅行終了日

フライトパラメータ

変数	タイプ	説明
`departing_arrival_date`	文字列	出発フライト到着日
`departing_departure_date`	文字列	出発フライト出発日
`destination_ids`	配列	目的地ID
`num_adults`	数値	大人の数
`num_children`	数値	子供の数
`num_infants`	数値	幼児の数
`preferred_num_stops`	数値	希望の停留所数
`price`	数値	価格
`returning_arrival_date`	日付	帰りのフライト到着日
`returning_departure_date`	日付	帰りのフライト出発日
`travel_class`	文字列	旅行クラス
`user_score`	数値	ユーザースコア

ホテルパラメータ

変数	タイプ	説明
`checkin_date`	日付	チェックイン日
`checkout_date`	日付	チェックアウト日
`city`	文字列	市
`country`	文字列	国
`destination_ids`	配列	目的地ID
`hotel_score`	数値	ホテルスコア
`num_adults`	数値	大人の数
`num_children`	数値	子供の数
`preferred_neighborhoods`	配列	希望の近隣地域の配列
`preferred_price_range`	配列	最小および最大の価格範囲の配列
`preferred_star_ratings`	文字列	希望の星評価
`region`	文字列	地域
`user_score`	数値	ユーザースコア

映画パラメータ

変数	タイプ	説明
`movieref`	文字列	映画リファラー

不動産パラメータ

変数	タイプ	説明
`availability`	文字列	利用可能性
`city`	文字列	市
`country`	文字列	国
`lease_start_date`	日付	リース開始日
`lease_end_date`	日付	リース終了日
`listing_type`	文字列	リスティングタイプ
`neighborhood`	文字列	近隣地域
`preferred_baths_range`	配列	最小および最大のバスルーム範囲の配列
`preferred_beds_range`	配列	最小および最大のベッドルーム範囲の配列
`preferred_price_range`	配列	最小および最大の希望価格の配列
`property_type`	文字列	物件タイプ
`region`	文字列	地域

クッキー同意

変数	説明
`grant`	クッキー同意を付与
`revoke`	クッキー同意を取り消し

限定データ使用

変数	タイプ	説明
`lmt_data.use_ldu` (LDU使用)	ブール値	`true`の場合、Facebookの限定データ使用オプションを使用。 `false`の場合、Facebookの限定データ使用オプションを使用しない。
`lmt_data.ldu_types.geolocate` (LDUはジオロケートするべき)	ブール値	`true`の場合、LDUはユーザーの位置を特定する。 `false`の場合、LDUはユーザーの位置を特定しない。LDU使用が有効な場合、LDUはジオロケートするべきもデフォルトで有効。
`lmt_data.ldu_types.california` (LDUはカリフォルニア)	ブール値	`true`の場合、テンプレート内で州および国のカリフォルニア固有の値を構成する。ユーザーがカリフォルニアに位置しており、限定データ使用で処理する必要がある場合のみこのオプションを有効にする。 `false`の場合、テンプレート内でユーザーの州および国のカリフォルニア固有の値を構成しない。

ベンダー文書

詳細については、以下のベンダー文書を参照してください：