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 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 タグの古いバージョンでは、fb_event_id_{FACEBOOK_EVENT} という形式でイベント ID 属性が生成されていました。たとえば 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 高度なマッチングサービスにデータを渡して有効にします。
- 例：fbq("init", "12345678901234", {em:"6dd8b7d7..."});
- 高度なマッチング を有効にして個人識別情報（PII）を含むパラメータをマッピングする場合は、メタイベントマネージャー の 自動高度なマッチング を無効にし、パラメータを手動でのみマッピングすることを強くお勧めします。自動高度なマッチング は、必要および範囲外の追加の 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 をキーワードに含むすべてのネットワークリクエストを表示します。
購入イベントが成功したことをリクエストの名前で確認します。
リクエストを開き、クエリ文字列パラメータ までスクロールダウンして、構成されたデータマッピングの値を確認します：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の生成を有効にする必要があります。 `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`の場合、使用しない。
`lmt_data.ldu_types.geolocate` (LDUが地理位置を特定するべきか)	ブール値	`true`の場合、LDUがユーザーの地理位置を特定。 `false`の場合、特定しない。LDUを使用が有効な場合、LDUが地理位置を特定するべきもデフォルトで有効。
`lmt_data.ldu_types.california` (LDUがカリフォルニアである)	ブール値	`true`の場合、テンプレート内で州および国のカリフォルニア固有の値を構成。ユーザーがカリフォルニアに位置し、限定データ使用で処理する必要がある場合のみこのオプションを有効にする。 `false`の場合、テンプレート内でユーザーの州および国のカリフォルニア固有の値を構成しない。

ベンダー文書

以下のベンダー文書で詳細情報を参照してください：