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

レガシーFacebook Pixelについての情報は、Facebook Pixel構成ガイド（レガシー）を参照してください。

仕組み

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

Web用Conversions API

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

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

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

fb_event_id_{FACEBOOK_EVENT}_{TAG_UID}

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

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

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

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

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

レガシーイベント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");
Advanced Matching
- Facebook Advanced Matchingサービスにデータを有効にして渡します。
- 例：fbq("init", "12345678901234", {em:"6dd8b7d7..."});
- Advanced Matchingを有効にし、個人を特定可能な情報（PII）を含むパラメータをマッピングした場合、Meta Events ManagerのAutomatic Advanced Matchingを無効にし、パラメータを手動でのみマッピングすることを強く推奨します。Automatic Advanced Matchingは、あなたのニーズと範囲を超えた追加の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を選択し、Select a Destinationをクリックします。
CategoryセクションでEventsを選択します。
When mapped variable equalsフィールドをPurchaseに構成します。これは、tealium_eventが購入に等しくなければならない値です。
Trigger eventドロップダウンリストでPurchaseを選択します。これは、tealium_eventが購入に等しいときにトリガーされるイベントです。

購入イベントに追加のデータを送信する必要があり、既に組み込まれているE-Commerce拡張のマッピングでカバーされていない場合は、Custom Parametersを使用して追加の購入データをマッピングします。

以下の例では、商品のブランドを購入イベントと一緒に送信します：

変数のドロップダウンリストからproduct_brandを選択し、Select a Destinationをクリックします。
CategoryセクションでEvent specific Parametersを選択します。
Destinationフィールドをカスタムパラメータの名前brandに構成します。
For eventドロップダウンリストで、カスタムパラメータが収集するイベントPurchaseを選択します。

マッピングをテストするには、Facebook Pixel Helperまたはお使いのブラウザが提供する開発者ツールを使用します。
Network Panelを使用し、Facebookをフィルタリングして、Facebookをキーワードに含むすべてのネットワークリクエストを表示します。
リクエストの名前を見て、購入イベントが成功したことを確認します。
リクエストを開き、Query String Parametersまでスクロールして、構成したデータマッピングの値を確認します：purchase , product_id , product_brand。

データマッピング

データマッピングは階層構造を持ち、特定のマッピング（例えば、Event-Specific Parameters）が一般的なマッピングよりも優先されます。例えば、Standard Tracking ParametersタブのCurrency宛先に変数をマッピングし、ViewContentイベントのCurrency宛先にマッピングした場合、ViewContentマッピングは一般的なマッピングよりも優先されますが、これはViewContentイベントに対してのみです。他のすべてのイベントでは、Standard Trackingマッピングが使用されます。

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

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

タグ構成

変数	宛先	タイプ	説明
`pixel_id`	ピクセルID	文字列	あなたのFacebookピクセルID。ピクセルIDは、コードスニペット内で長い一連の数字として表示されます。カンマ区切りのリストを使用して、複数のピクセルIDを入力することができます。スペースは不要です。例：`fbq("init", "12345678901234");`
`autoConfig`	自動構成の切り替え	ブール値	自動構成の切り替え。
`auto_page_view`	自動ページビューの切り替え	ブール値	ページのロード時に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`の使用を有効または無効にする。デフォルト値は`true`です。 `false`に構成すると、すべてのFacebookトラッキング呼び出しに`track`の値が使用されます。
`disablePushState`	disablePushState使用の切り替え	ブール値	`disablePushState`構成の切り替え。これは、同じページ上で複数のPageViewsをトリガーするのを防ぐかどうかを制御します（シングルページアプリケーション用）。デフォルト値は`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-Commerce Extensionのマッピングを自動的に使用します。このカテゴリで手動でマッピングする必要は、拡張マッピングを上書きしたい場合や、希望する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`	ViewContentタイプ	文字列	ViewContentタイプ。
`vin`	VIN	文字列	車両識別番号。
`year`	年	数値	車両の年式。

目的地パラメータ

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

フライトパラメータ

変数	タイプ	説明
`departing_arrival_date`	文字列	出発フライトの到着日。
`departing_departure_date`	String	出発フライトの出発日
`destination_ids`	Array	目的地ID
`num_adults`	Number	大人の数
`num_children`	Number	子供の数
`num_infants`	Number	幼児の数
`preferred_num_stops`	Number	優先する停止数
`price`	Number	価格
`returning_arrival_date`	Date	帰りのフライトの到着日
`returning_departure_date`	Date	帰りのフライトの出発日
`travel_class`	String	旅行クラス
`user_score`	Number	ユーザースコア

ホテルのパラメータ

変数	タイプ	説明
`checkin_date`	Date	チェックイン日
`checkout_date`	Date	チェックアウト日
`city`	String	都市
`country`	String	国
`destination_ids`	Array	目的地ID
`hotel_score`	Number	ホテルスコア
`num_adults`	Number	大人の数
`num_children`	Number	子供の数
`preferred_neighborhoods`	Array	優先する地区の配列
`preferred_price_range`	Array	最小価格と最大価格の範囲の配列
`preferred_star_ratings`	String	優先する星評価
`region`	String	地域
`user_score`	Number	ユーザースコア

映画のパラメータ

変数	タイプ	説明
`movieref`	String	映画の参照

不動産のパラメータ

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

クッキーの同意

変数	説明
`grant`	クッキーの同意を与える
`revoke`	クッキーの同意を取り消す

限定データ使用

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

ベンダーのドキュメンテーション

詳細については、以下のベンダーのドキュメンテーションを参照してください：