Facebookピクセルタグ構成ガイド

従来のFacebookピクセルについては、Facebookピクセル構成ガイド（従来版）を参照してください。

仕組み

注文IDが構成されると、購入トラッキングが自動的に実行されます。
「Pixel ID」フィールドには、ピクセルIDをカンマ区切りのリストで入力できます。
イベントIDを生成：Facebookピクセルでevent_idパラメータを生成し、これらのイベントIDをサーバーサイド属性として利用できるようにするには、trueに構成します。
- 最新バージョンのTealium Collectタグが必要です。
- カスタム変数をevent_idにマッピングする場合は、trueに構成する必要があります。
- 詳細については、Web向けConversions APIを参照してください。
商品数量の配列が存在する場合、テンプレートはnum_itemsの値を自動的に計算しようとします。
マッピングを使用して、以下を実行できます。
- trackSingleを切り替える（デフォルトはfalse）— 有効にすると、fbq('trackSingle')を使用して、明示的にマッピングされたピクセルIDにのみイベントを送信します。無効にすると、fbq('track')を使用して、初期化されたすべてのピクセルIDにイベントを配信します
- disablePushStateを切り替える（デフォルトはfalse）
- タグ構成を動的に構成する
- Eコマース拡張機能の値を上書きする
以下のEコマース拡張機能パラメータをサポートしています。
- 注文ID
- 小計
- 通貨
- 商品IDのリスト
- 商品カテゴリのリスト
- 商品価格のリスト
- 商品数量のリスト
- 商品名のリスト
Facebookピクセルタグは、ユーザーデータを自動的にハッシュ化します。この機能は変更できません。

Web向けConversions API

この機能を使用するには、有効なTealium Collectタグが必要です。

Facebook Conversions API for Webをサポートするには、イベントIDを生成をtrueに構成します。イベントIDを生成を有効にすると、このタグはトラッキングされるイベントごとに一意のイベントIDを生成し、Facebook Conversionsコネクタで使用できるように属性としてEventStreamに送信するとともに、event_idパラメータでFacebookピクセルに渡します。このイベントID属性をコネクタでマッピングすることで、Webベースのタグとサーバーサイド統合を同期できます。

タグは、以下の命名規則に従って生成されたイベント属性を使用して、イベントIDを送信します。

fb_event_id_{FACEBOOK_EVENT}_{TAG_UID}

たとえば、タグ#32の購入イベントでは、次の属性と値が送信されます。

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

同じタグのページビューイベントでは、次の属性と値が送信されます。

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

重複排除

イベントを適切に重複排除するには、FacebookピクセルタグのイベントIDを、Tealium Collectタグから送信されるペイロードに含める必要があります。そのためには、次の手順を実行します。

タグタイミングドロップダウンから、優先を選択します。
バンドルフラグトグルをOnに構成します。
読み込み順序マネージャー画面を使用して、FacebookピクセルタグをTealium Collectタグより先に発火させます。Tealium Collectタグを最後に発火させることをお勧めします。

これらのイベントID属性の使用方法については、Facebook Conversionsコネクタ：Webイベントの重複排除を参照してください。

従来のイベントID

以前のバージョンのFacebookピクセルタグでは、イベントID属性はfb_event_id_Purchaseなど、fb_event_id_{FACEBOOK_EVENT}という形式で生成されていました。これらの古い属性名は引き続きタグによって生成されますが、同じページ上の複数のFacebookタグをサポートしていないため、従来形式と見なされます。

最新バージョンのFacebookピクセルタグでは、生成される属性名にタグUIDを含めることで、ページ上で複数のFacebookタグを発火できます。イベントID属性に従来形式を引き続き使用している場合は、タグを最新バージョンに更新し、新しいイベントID属性を参照することをお勧めします。

タグの構成

新しいタグを追加するには、タグマーケットプレイスに移動します。詳細については、タグについてを参照してください。

タグを追加するときは、以下の構成を構成します。

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

イベントマッピング

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

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

購入イベントを構成するには、次の手順を実行します。

変数ドロップダウンリストからtealium_eventを選択し、宛先を選択をクリックします。
カテゴリセクションで、イベントを選択します。
マッピングされた変数が次と等しい場合フィールドをPurchaseに構成します。これは、購入をトリガーするためにtealium_eventが一致する必要がある値です。
イベントをトリガードロップダウンリストでPurchaseを選択します。これは、tealium_eventが購入と等しい場合にトリガーされるイベントです。
購入イベントとともに送信する必要がある追加データが、組み込みのEコマース拡張機能のマッピングでまだカバーされていない場合は、カスタムパラメータを使用して追加の購入データをマッピングします。

次の例では、購入イベントとともに商品ブランドを渡します。

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

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

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

データマッピング

データマッピングは階層構造に従い、イベント固有パラメータなどの具体的なマッピングが、より一般的なマッピングより優先されます。たとえば、標準トラッキングパラメータタブで変数を通貨の宛先にマッピングし、さらに ViewContent イベントでも通貨の宛先にマッピングした場合、ViewContent のマッピングが一般的なマッピングより優先されます。ただし、これは ViewContent イベントにのみ適用されます。その他のすべてのイベントでは、標準トラッキングのマッピングが使用されます。

データマッピングは、データレイヤー変数の値をベンダータグ内の対応する変数に送信します。詳細については、データマッピングについてを参照してください。

使用可能なカテゴリは次のとおりです。

タグ構成

変数	宛先	型	説明
`pixel_id`	ピクセルID	文字列	FacebookピクセルID。ピクセルIDは、コードスニペット内に長い数字列として表示されます。複数のピクセルIDを、スペースを入れずにカンマ区切りのリストで入力できます。例：`fbq("init", "12345678901234");`
`autoConfig`	自動構成の切り替え	ブール値	自動構成を有効または無効にします。
`auto_page_view`	自動PageViewの切り替え	ブール値	ページの読み込み時にPageViewイベントをトリガーする、自動PageViewトラッキングを有効または無効にします。デフォルト値は`true`です。
`advanced_matching`	詳細マッチングの切り替え	ブール値	詳細マッチングデータの収集を有効または無効にします。デフォルト値は`true`です。
`generate_event_id`	イベントIDの生成	ブール値	Facebookトラッキングイベントごとの一意のイベントID生成を有効または無効にします。 `event_id`の生成を有効にするには、タグ構成ページでもイベントIDを生成を有効にする必要があります。 IDを生成するには、最新バージョンの`utag.js`ファイルが必要です。デフォルト値は`false`です。
`calc_items`	アイテム数の自動計算	ブール値	イベントのアイテム数を自動的に決定する機能を有効または無効にします。商品の数量にマッピングされたデータを使用してアイテム数を決定します。デフォルト値は`true`です。
`track_single`	trackSingle使用の切り替え	ブール値	Facebookトラッキングイベントでの`trackSingle`の使用を有効または無効にします。デフォルト値は`false`です。 `true`に構成すると、`fbq('trackSingle')`を使用して、明示的にマッピングされたピクセルIDのみにイベントを送信します。 `false`に構成すると、`fbq('track')`を使用して、初期化済みのすべてのピクセルIDにイベントをブロードキャストします。複数ピクセルの構成でイベントの重複を防ぐには、この構成を使用してください。
`disablePushState`	disablePushState使用の切り替え	ブール値	同じページで複数のPageViewがトリガーされるのを防ぐかどうかを制御する`disablePushState`構成を有効または無効にします（シングルページアプリケーション向け）。
`useContentsObject`	Contentsオブジェクト使用の切り替え	ブール値	該当するイベントで、`content_ids`のみに依存する代わりに、Facebookピクセルのcontents配列（`{id, quantity, item_price}`のようなオブジェクトの配列）を構築して送信する機能を有効または無効にします。デフォルト値は`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ピクセルタグは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`	文字列	地域。

Cookie同意

変数	説明
`grant`	Cookieへの同意を付与します。
`revoke`	Cookieへの同意を取り消します。

制限付きデータ使用

変数	型	説明
`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`の場合、テンプレート内でユーザーの州と国にカリフォルニア固有の値を構成しません。

ストアデータ

変数	型／値	説明
`store_data.store_page_id`	数値	FacebookストアページID。
`store_data.brand_page_id`	数値	FacebookブランドページID。
`store_data.store_code`	文字列	Facebookストアコード。

ベンダーのドキュメント

詳細については、次のベンダーのドキュメントを参照してください。