Facebook Pixel構成ガイド（レガシー版）

これはタグのレガシーバージョンであり、間もなく非推奨となり、Facebook Pixelタグに置き換えられます。

前提条件

Facebook広告アカウント
アップグレードされたFacebook Pixel（またはレガシーのカスタムオーディエンスピクセル）
コンバージョンピクセル（レガシー）

タグ構成

まず、Tealiumのタグマーケットプレイスにアクセスし、プロファイルにFacebook Pixelタグを追加します。詳細については、タグの管理を参照してください。

標準のPageViewとイベントトラッキングのために、ピクセルIDごとに単一のタグインスタンスを構成することがベストプラクティスです。

タグを追加した後、以下の表に記載されている構成を構成します：

構成	説明
タイトル	タグを識別するためのユニークな名前を入力しますこのタグの複数のインスタンスを追加する場合に重要です
Facebook Pixel ID	あなたのFacebook Pixel IDですこれはコードスニペット内で長い数字のシリーズとして表示されますカンマ区切りのリストとして複数のピクセルIDを追加することができます例：`fbq('init', '12345678901234')`
コンバージョンピクセルID	レガシーのコンバージョンピクセルのトラッキングのみに必要です（非推奨） IDはコードスニペットに次のように表示されます： `fb_param.pixel_id = '12345';` または `fbq('track', '12345')` または `fbq.push(['track', '12345', { }]);`
デフォルトのページビューを許可	すべてのページでPageViewイベントをトリガーします `True` デフォルト値コンバージョンイベント以外の自動PageViewトラッキングをオンにします `False` コンバージョンイベントのトラッキング時にPageViewのトリガーをオフにしますヒント：このデフォルト動作を望まない場合は、`disablePushState`フラグを使用してオフにすることができます。このフラグを`true`に構成すると、履歴状態の変更時に`PageView`イベントの送信を停止します。
デフォルトで送信するイベント	デフォルトでトリガーするイベントを選択しますこれは主にコンバージョンピクセルの使用に関連します
アドバンストマッチング	Facebookのアドバンストマッチングサービスを有効にします。(詳細を学ぶ) これはデフォルトで有効ですが、アドバンストマッチングの利点を享受するためには、顧客はデータマッピングを追加する必要があります。
アイテム数の自動計算	チェックアウト時のアイテム数を自動的にカウントするかどうかを選択しますデフォルト値は`True`です
trackSingleを有効にする	FacebookイベントトラッキングコールのためのtrackSingleおよびtrackSingleCustomの使用を有効にします。これらは、複数のFacebookピクセルがロードされているシナリオで、このタグで構成されたピクセルIDのみに対してトラッキングコールをトリガーします。デフォルト値は`True`です例：`fbq('trackSingle', 'FB_PIXEL_ID', 'Purchase', customData )` - または - `fbq('trackSingleCustom', 'FB_PIXEL')`
trackCustomを有効にする	Facebookイベントトラッキングコールのための`trackCustom`の使用を有効にします。カスタムイベントをトラッキングするために、カスタムイベント名と（オプションで）JSONオブジェクトをパラメータとして`fbq('trackCustom')`ピクセル関数を呼び出すことができます。例：プロモーションを共有して割引を得る訪問をトラッキングする場合、次の例に示すカスタムを使用してトラッキングすることができます：`fbq('trackCustom','ShareDiscount',{promotion:'share_discount_10%'});`

ロードルール

ロードルールは、サイト上のどこでこのタグのインスタンスをロードするかを決定します。

推奨されるロードルール：

標準のPageViewとイベントのトラッキングのために、デフォルトのすべてのページルールを使用します
レガシーのコンバージョンピクセルのトラッキングのために、特定のコンバージョンページにタグをロードするカスタムルール条件を適用します。

データマッピング

マッピングは、データレイヤー変数からベンダータグの対応する宛先変数にデータを送信するプロセスです。Facebook Pixelタグの宛先変数はデータマッピングタブに組み込まれています。変数をタグの宛先にマッピングする方法については、データマッピングを参照してください。以下のセクションでは利用可能なカテゴリについて説明します：

標準

これらのマッピングを使用して、タグ構成を動的に上書きすることができます。これは、データレイヤーに基づいて値を動的に構成したい場合に便利です。

宛先名	宛先変数	説明
Facebook Pixel ID	`cust_pixel`	Facebook Pixelの数値識別子
コンバージョンピクセルID	`conv_pixel`	レガシーのコンバージョンピクセルの数値識別子
初期ページビューを許可 [`true`/`false`]	`page_view`	‘init’ トラックコール
発火するイベントのリスト	`evt_list`	コンマ区切りの値または変数内の配列としてリストされたイベント
trackSingleを有効にする [`true`/false]	`track_single`	`trackSingle`および`trackSingleCustom`のイベントトラッキングの使用を有効にします。複数のFacebookピクセルがロードされている状況で、Tealium iQで追加されたピクセルIDにイベントトラッキングを制限します。
trackCustomを有効にする [`true`/`false`]	`track_custom`	Facebookイベントトラッキングコールのための`trackCustom`の使用を有効にします。カスタムイベント名は文字列でなければならず、50文字を超えることはできません。

アドバンストマッチング

この追加データを使用すると、より多くのコンバージョンを報告および最適化し、より大きなリマーケティングオーディエンスを構築することができます。チェックアウト、アカウントサインイン、または登録プロセス中にウェブサイトから収集した顧客識別子をピクセルのパラメータとして渡すことができます。

アドバンストマッチングでは、既に認識されている項目を除き、入力された用語のケースは正規化されます。

宛先名	宛先変数	説明
メール	`em`	メール
名	`fn`	名前
姓	`ln`	姓
電話番号	`ph`	電話番号の数値
性別	`ge`	`f` または `m`
生年月日	`db`	[ `yyyymmdd`]
市	`ct`	市
州	`st`	2文字のコード
郵便番号	`zp`	郵便番号

E-Commerce

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

宛先名	宛先変数	説明	Eコマースエクステンション変数
注文ID	`order_id`	最終注文に割り当てられたユニークな識別子	`_corder`
小計	`sub_total`	最終注文の小計額	`_csubtotal`
通貨	`order_currency`	支払いに使用される通貨	`_ccurrency`
製品IDリスト	`product_id`	製品配列内の各製品のユニークな識別子	`_cprod`
製品名リスト	`product_name`	製品配列内の各製品の名前	`_cprodname`
カテゴリリスト	`product_category`	製品配列内の各製品のカテゴリ	`_ccat`
価格リスト	`product_unit_price`	製品配列内の各製品の単価	`_cprice`

データ使用制限

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

イベント

特定のイベントをページ上でトリガーするためにこれらの目的地にマッピングします。イベントはコンバージョンの追跡とFacebook広告のターゲット可能なオーディエンスの構築に使用されます。

購入イベントは、Eコマース拡張機能を通じて、または直接データマッピングを通じて注文ID値が利用可能な場合に自動的にトリガーされます。

イベントをマッピングするには、以下の手順に従ってください：

トリガーフィールドに、選択したイベントに対応する目的地にマッピングする変数の値を入力します。例えば、UDO内でevent_name="order"の場合に購入イベントをトリガーしたい場合、orderを入力します（現在event_name変数をマッピングしていると仮定します）。
イベントフィールドで、ドロップダウンリストから希望のイベント（例：購入）を選択します。
+ 追加をクリックします。

カスタムイベント

カスタムイベントの場合、カスタムを選択し、カスタムイベントの名前を入力します。

次の例では、変数event_nameがinbound_lead_eventに等しい場合にカスタムイベント"InboundLead"がトリガーされます。

カスタムイベントを編集するには、イベント名を直接編集するために目的地入力フィールドをクリックします。値は次の形式で入力されます：{VARIABLE_VALUE}:{DESTINATION_EVENT}。

コロンの左側はイベントをトリガーする変数値です、例えば inbound_lead_event
コロンの右側はカスタムイベント名です、例えば InboundLead.

カスタムイベントデータ

イベントタブでマッピングしたカスタムイベントにカスタムパラメータを渡したい場合、これらの目的地にマッピングします。

カスタムイベントデータ変数をマッピングするには、以下の手順に従ってください：

イベント名フィールドに、イベントタブで指定されたカスタムイベントの名前を正確に入力します。
パラメータフィールドに、送信したいパラメータの名前を入力します。
+ 追加をクリックします。

標準イベントの完全なリスト

目的地イベント	イベント説明
AddPaymentInfo	訪問がチェックアウトプロセス中に支払い詳細を追加する
AddToCart	訪問がカートにアイテムを追加する
AddToWishlist	訪問がウィッシュリストにアイテムを追加する
CompleteRegistration	訪問が登録フォームを完了する例：訪問がニュースレターに成功して登録する
Contact	人が電話、SMS、メール、チャット、またはその他の方法でビジネスに連絡を取る場合。
Conversion	レガシーConversion Pixelのみ；Conversion Pixel IDの構成が必要です
Custom	訪問のアクションはカスタムイベントとして扱われるカスタムオーディエンスとカスタムコンバージョンのレポートに使用できる
CustomizeProduct	人が製品をカスタマイズする場合。
InitiateCheckout	訪問がチェックアウトプロセスを開始する最初のステップを踏む例：訪問がチェックアウトに進むボタンをクリックする
Lead	訪問のアクションが彼または彼女の購入意向を示す例：訪問が試用製品にサインアップする
PageView	訪問がサイトの任意のページを閲覧する
Purchase	訪問がチェックアウトプロセスの最後のステップを成功裏に完了する注意：このイベントはコンバージョンの追跡に必要です。イベントタブでマッピングしてください
Schedule	人があなたのロケーションのいずれかを訪問するための予約をする場合。
Search	訪問が検索アクションを実行する
StartTrial	人があなたが提供する製品またはサービスの無料試用を開始する場合。
SubmitApplication	人があなたが提供する製品、サービス、またはプログラムに応募する場合。
Subscribe	人があなたが提供する製品またはサービスの有料サブスクリプションを開始するために申し込む場合。
ViewContent	訪問が特定のページを閲覧し、その閲覧行動を示す

パラメータ

以前にマッピングしたイベントに追加データを渡したい場合、これらの目的地にマッピングします。

パラメータは事前定義されたイベントでのみ使用されます。カスタムイベントにパラメータを渡す方法については、カスタムイベントデータセクションを参照してください。

事前定義されたイベントにパラメータを渡すには、以下の手順に従ってください：

イベントフィールドで、ドロップダウンリストからFacebookイベントを選択します。
パラメータフィールドで、Facebookパラメータをドロップダウンリストから選択します。 カスタムパラメータの場合、パラメータを識別する名前を入力します。
+ 追加をクリックします。

事前定義されたパラメータの完全なリスト

目的地パラメータ	説明
Value	イベントに関連する値
Currency	Valueパラメータに関連する通貨
Content Name	製品またはページの名前
Content Type	イベントに関連する製品またはページのタイプ
Content IDs	イベントに関連する識別子
Content Category	製品またはページのカテゴリ
Number of Items	チェックアウト時のアイテム数
Search String	検索アクションで使用されるキーワード/用語
Order ID	最終注文の一意の識別子
Status	CompleteRegistrationイベントの状態
Custom	事前定義されたイベントで渡されるカスタムパラメータ

ホテルパラメータ

以前にマッピングしたイベントにホテル関連の検索およびホテル予約の詳細を送信するために、次の表にリストされている目的地にマッピングします。

ホテルパラメータの完全なリスト

パラメータ	説明
Content Type	(必須) ホテルに関連する製品またはページのタイプ。注意：変数値が`hotel`と等しいことを確認してください。
Content IDs	(必須) ホテルに関連する一意の識別子。
Destination	(必須) ホテルが位置する市、州、または国を説明する文字列値。例：`San Fransisco`。
Check-in Date	(必須) 訪問がホテルにチェックインする日付ホテルのタイムゾーンに対応サポートされる日付形式： `YYYYMMDD` `YYYY-MM-DD` `YYYY-MM-DDThh:mmTZD` `YYYY-MM-DDThh:mm:ssTZD`
Check-out Date	(必須) 訪問がホテルからチェックアウトする日付ホテルのタイムゾーンに対応サポートされる日付形式： `YYYYMMDD` `YYYY-MM-DD` `YYYY-MM-DDThh:mmTZD` `YYYY-MM-DDThh:mm:ssTZD`
Value	(必須) 広告主にとってのイベントの相対的な価値購入イベントに必須
Currency	(必須) Valueパラメータに関連する通貨購入イベントに必須

オプショナルホテルパラメータ

パラメータ	説明
市区町村	(オプショナル) ホテルが位置する市区町村
地域	(オプショナル) ホテルが位置する州・地区
国	(オプショナル) ホテルが位置する国
大人の数	(オプショナル) 予約/検索で指定された大人の数
子供の数	(オプショナル) 予約/検索で指定された子供の数
おすすめホテル	(オプショナル) 訪問に推奨される他のホテルの識別子
ユーザースコア	(オプショナル) 広告主に対する訪問の相対的価値数値を含む必要があります
ホテルスコア	(オプショナル) 広告主に対するホテルの相対的価値数値を含む必要があります
購入通貨	(オプショナル) ホテル予約取引に関連する通貨

検索イベント専用のオプショナルホテルパラメータ

パラメータ	説明
優先星評価	(オプショナル) ホテルの星評価によってフィルターされる検索基準
優先価格帯	(オプショナル) 室料によってフィルターされる検索基準
優先エリア	(オプショナル) 位置エリアによってフィルターされる検索基準

旅行パラメータ

以下の表に記載されている目的地にマップして、以前にマップしたイベントとともに訪問の旅行詳細（フライトまたはルート旅行）を送信します。

旅行パラメータの完全なリスト

パラメータ	説明
コンテンツタイプ	(必須) 旅行タイプがフライトか非フライトかを示します注意: 変数の値はフライト旅行の場合は `flight`、非フライト旅行の場合は `route` と等しくなければなりません。
出発地	(必須) 旅行が始まる都市、州、または国を説明する文字列値。例: `San Fransisco, California, USA`。
目的地	(必須) 目的地の都市、州、または国を説明する文字列値。例: `Toronto, Ontario, Canada`。
出発日	(必須) 往路の旅行が始まる日時サポートされる日付形式は以下の通りです： `YYYYMMDD` `YYYY-MM-DD` `YYYY-MM-DDThh:mmTZD` `YYYY-MM-DDThh:mm:ssTZD`
帰路出発日	(必須) 帰路の旅行が始まる日時サポートされる日付形式は以下の通りです： `YYYYMMDD` `YYYY-MM-DD` `YYYY-MM-DDThh:mmTZD` `YYYY-MM-DDThh:mm:ssTZD`
価値	(必須) 広告主に対するイベントの相対的価値購入イベントに必須です
通貨	(必須) 価値パラメータに関連する通貨購入イベントに必須です

必須のフライトパラメータ

content type の値が flight に等しい場合、以下のパラメータが必須です：

パラメータ	説明
出発空港	(必須) 出発空港の IATA コード（3文字の空港識別子）
目的地空港	(必須) 目的地空港の IATA コード（3文字の空港識別子）

オプショナルな旅行パラメータ

パラメータ	説明
出発地の都市	(オプショナル) 旅行が始まる都市の名前
出発地の地域	(オプショナル) 旅行が始まる州/地域の名前
出発地の国	(オプショナル) 旅行が始まる国の名前
目的地の都市	(オプショナル) 目的地の都市の名前
目的地の地域	(オプショナル) 目的地の州/地域の名前
目的地の国	(オプショナル) 目的地の国の名前
到着日	(オプショナル) 訪問が目的地に到着する日時サポートされる日付形式は以下の通りです： `YYYYMMDD` `YYYY-MM-DD` `YYYY-MM-DDThh:mmTZD` `YYYY-MM-DDThh:mm:ssTZD`
帰路到着日	(オプショナル) 訪問が出発地に戻る日時サポートされる日付形式は以下の通りです： `YYYYMMDD` `YYYY-MM-DD` `YYYY-MM-DDThh:mmTZD` `YYYY-MM-DDThh:mm:ssTZD`
大人の数	(オプショナル) 旅行に参加する大人の数
子供の数	(オプショナル) 旅行に参加する子供の数
幼児の数	(オプショナル) 旅行に参加する幼児の数
旅行クラス	(オプショナル) 訪問が旅行するクラスのタイプを示します。 `flight` 旅行の場合、変数は `economy`, `premium`, `business`, `first` などの列挙値を含む必要があります。 `route` 旅行の場合、変数はカスタム文字列値を含む必要があります。例: `Economy`
ユーザースコア	(オプショナル) 広告主に対する訪問の相対的価値数値を含む必要があります
購入価格	(オプショナル) 旅行予約の価格購入およびチェックアウト開始イベントに推奨されます。
購入通貨	(オプショナル) 予約取引に使用される通貨

検索イベント専用のオプショナルな旅行パラメータ

パラメータ	説明
優先停留回数	(オプショナル) 中継回数によってフィルターされる検索基準直行便の場合は変数値を `0` に構成し、訪問が中継回数を指定している場合は `1` に構成します。

ユースケース

このセクションでは、実際のシナリオを表すユースケースを提供します。

ユースケース: PageView と標準/カスタムイベントの追跡

すべてのページで自動的に発火される PageView イベントを構成し、データマッピングを介してすべての非コンバージョンイベントをトリガーします。

このユースケースを環境に構成するための手順は次のとおりです：

次の構成を構成します：
- Pixel ID: FB_PIXEL_ID
- デフォルトページビューを許可: True
- 送信するデフォルトイベント: None
すべてのページにタグをロードします（デフォルトルール）。
非コンバージョンイベントの選択に event_name 変数をマップします。

ユースケース: PageView とコンバージョンイベントの追跡（非推奨）

コンバージョンイベントをトリガーするには、コンバージョン Pixel ID が必要です。これは、PageView と非コンバージョンイベントを追跡するために使用している同じタグインスタンスで行うことができます。

このユースケースを環境に構成するための手順は次のとおりです：

次の構成を構成します：
- Pixel ID: FB_PIXEL_ID
- コンバージョン Pixel ID: CONVERSION_PIXEL_ID
- デフォルトページビューを許可: True
- 送信するデフォルトイベント: None
すべてのページにタグをロードします（デフォルトルール）。
コンバージョンイベントの選択に event_name 変数をマップします。

ユースケース: 旧式のコンバージョン Pixel のみの追跡（非推奨）

コンバージョン Pixel は別のタグインスタンスで追跡する必要があります。このタグインスタンスでは、Pixel ID を空白にし、自動ページビュー追跡を無効にします。特定のイベントを追跡していないため、データマッピングは必要ありません。

このユースケースを環境に構成するための手順は次のとおりです：

次の構成を構成します：
- コンバージョン Pixel ID: CONVERSION_PIXEL_ID
- デフォルトページビューを許可: False
- 送信するデフォルトイベント: Conversion
特定のコンバージョンページにこのタグをロードするためのカスタムロードルールを適用します。

使用例：1ページに複数のピクセル

以下の使用例は、1ページに複数のピクセルを使用するシナリオを示しています：

共有イベントトラッキング
- 複数のFacebookピクセルがページビューやイベントトラッキングを共有する場合、タグ構成のFacebookピクセルIDフィールドにピクセルIDのカンマ区切りリストを追加できます。
- 複数のFacebookピクセルがそれぞれのピクセルIDを持ち、他のFacebookピクセルとイベントトラッキングを共有することができますが、trackSingle構成がfalseの場合、トラッキングの挙動が一貫しない可能性があり、推奨されません。
個別イベントトラッキング
- 1ページに複数のFacebookピクセルをロードし、そのページの全てのピクセルに対してトラッキングイベントが記録されるのを防ぎたい場合は、Enable trackSingle 構成を trueにしてください。
- この構成により、そのタグに追加されたピクセルIDのみでイベントトラッキングが実行されます。
- 2018年3月以前にTealium iQでFacebookピクセルを追加した場合、trackSingle機能を利用できない可能性があります。
  - この場合、Facebookタグテンプレートを更新して最新バージョンにしてください。trackSingle構成はデフォルトでtrueに構成されています。
  - track_singleにマッピングし、この機能を無効にするために値をfalseに構成する必要があります。
2018年3月以前のバージョン
- 2018年3月以降にタグを追加した場合は、複数のFacebookピクセルを構成する際に上記の使用例を参照してください。
- 古いバージョンのFacebookピクセルは、1ページに複数回ロードされるように設計されていません。
- Facebook JavaScriptライブラリはfbqオブジェクトの単一インスタンスを初期化し、ページ上で発生するすべてのトラッキングに使用されます（同じピクセルIDを再利用します）。
- 1ページに異なるピクセルIDを持つ複数のFacebookピクセルを発火させる必要があり、タグテンプレートを更新できない場合は、Tealium Genericタグを使用して<noscript>バージョンのピクセルを実装することをお勧めします。

例示シナリオ

Facebookピクセルの<noscript>コードの例：

`<noscript><br>
<img height="1" width="1" style="display:none"<br>
 src="https://www.facebook.com/tr?id={{FACEBOOK_PIXEL_ID}}&ev=PageView&noscript=1"<br>
/><br>
</noscript>`

このシナリオでは、隠された画像ピクセルのURLは次のように構成できます：

Tealium Genericタグを追加します。
タイトルをFacebook Pixel (custom)に構成します。
ベースURLをhttps://www.facebook.com/trに構成します。
クエリストリングをid={{FACEBOOK_PIXEL_ID}}&ev=PageView&noscript=1"に構成します。
必要なロードルールとデータマッピングを構成します。
適用をクリックします。

Tealium iQのFacebookダイナミック広告

Tealium iQでFacebookダイナミック広告を構成する方法についての詳細は、TLC記事How to Set up Facebook Dynamic Ads in Tealium iQを参照してください。

ベンダー文書

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