Facebook Pixelタグのセットアップガイド

Facebook Pixelの旧バージョンに関する情報は、Facebook Pixelセットアップガイド（旧バージョン）を参照してください。

動作原理

• 注文IDが入力されると、自動的に購入トラッキングが行われます。

• Pixel IDフィールドには、Pixel IDをカンマ区切りのリストで入力できます。

• Facebook PixelイベントIDをサーバーサイド属性として利用するには、Generate Event IDをtrueに設定し、最新バージョンのTealium Collectタグを使用します。

• テンプレートは、製品数量の配列が存在する場合、num_itemsの値を自動的に計算しようとします。

• マッピングを使用して次のことができます：

  • trackSingleの切り替え（デフォルトはtrue）
  • disablePushStateの切り替え（デフォルトはfalse）
  • タグの設定を動的に設定する
  • E-コマース拡張の値を上書きする

• 以下のE-コマース拡張パラメーターをサポートしています：

  • 注文ID
  • サブトータル
  • 通貨
  • 製品IDのリスト
  • 製品カテゴリーのリスト
  • 製品価格のリスト
  • 製品数量のリスト
  • 製品名のリスト

  Pixelタグはユーザーデータを自動的にハッシュ化します。

Web向けのConversions API

Facebook Conversions API for Webをサポートするために、タグは各イベントに対して一意のイベントIDを生成し、Facebook Conversionsコネクタで使用するためにTealium EventStreamに送信します。イベントIDはコネクタでマッピングされ、Webベースのサーバーベースの統合と同期されます。この機能には、アクティブなTealium Collectタグが必要です。

タグは、次の命名規則を使用して新しいイベント属性を生成します：

fb_event_id_{FACEBOOK_EVENT}_{TAG_UID}

例：fb_event_id_Purchase_32 : "028b2ade7478..."またはfb_event_id_PageView_32

以前は、fb_event_id_{FACEBOOK_EVENT}としてIDが生成されていました。これらのIDは引き続き生成されますが、レガシーと見なされます。新しいIDは、単一のページで複数のFacebookタグが発火する場合に使用でき、関連するタグにより強力な関連付けが提供されます。レガシーバージョンを使用している場合は、コネクタを新しいIDに変更する必要があります。

Facebook Conversionsコネクタのセットアップガイドを参照してください。

タグの設定

まず、Tealium Tag Marketplaceに移動し、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のウェブサイトまたはモバイルアプリの自動高度なマッチングの設定方法を参照してください。
• Generate Event ID
  • 各Facebookトラッキングイベントに対してイベントIDを自動的に生成します。
  • イベントID属性は、fb_event_id_{FACEBOOK_EVENT}という命名規則に従います。
  • 例： fb_event_id_Purchase : "028b2ade7478..."

イベントマッピング

Facebook Pixelイベントは、データマッピングを使用して変数をイベントにマップし、トリガーを入力することでイベントを開始します。変数が特定の値に等しい場合、トリガーが発生し、イベントが開始されます。以下のユースケースで説明します。

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

購入イベントを設定するには：

1. 変数のドロップダウンリストからtealium_eventを選択し、Select a Destinationをクリックします。
2. CategoryセクションでEventsを選択します。
3. When mapped variable equalsフィールドをPurchaseに設定します。これは、tealium_eventが購入をトリガーするために等しくなければならない値です。
4. Trigger eventドロップダウンリストでPurchaseを選択します。これは、tealium_eventが購入と等しい場合にトリガーされるイベントです。

   

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

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

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

   

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

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

   

データマッピング

データマッピングは、特定のマッピング（例：イベント固有のパラメーター）が一般的なマッピングより優先される階層構造に従います。たとえば、標準のトラッキングパラメータータブとViewContentイベントの通貨宛先の両方に変数をマッピングする場合、ViewContentマッピングは一般的なマッピングより優先されますが、他のすべてのイベントでは標準のトラッキングマッピングが使用されます。

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

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

タグの設定

宛先	変数	タイプ	説明
Pixel ID	pixel_id	[String]	Facebook PixelのIDです。 Pixel IDはコードスニペット内の長い数字のシリーズとして表示されます。 スペースなしのカンマ区切りのリストで複数のPixel IDを入力できます。 例：fbq("init", "12345678901234");
Toggle Automatic PageView	auto_page_view	Boolean [true/false]	自動的なPageViewトラッキングの有効化または無効化を切り替えます。 ページの読み込み時に自動的にPageViewイベントをトリガーするかどうかを切り替えます。 デフォルト値はtrueです。
Toggle Advanced Matching	advanced_matching	Boolean [true/false]	Advanced Matchingデータの収集を有効化または無効化します。 キャプチャして送信するかどうかを切り替えます。 デフォルト値はtrueです。
Generate Event IDs	generate_event_id	Boolean [true/false]	各Facebookトラッキングイベントに対してイベントIDを自動的に生成するかどうかを切り替えます。 各Facebookトラッキングイベントに対して一意のイベントIDが生成されるかどうかを切り替えます。 IDを生成するには、最新バージョンのutag.jsファイルが必要です。 デフォルト値はfalseです。
Automatically Calculate Number of Items	calc_items	Boolean [true/false]	イベントのアイテム数を自動的に決定するかどうかを制御するために切り替えます。 製品数量にマップされたデータを使用して数を決定します。 product_quantityの値に基づいてFacebookトラッキングイベントのアイテム数を自動的に計算するかどうかを切り替えます。 デフォルト値はtrueです。
Toggle trackSingle Usage	track_single	Boolean [true/false]	FacebookトラッキングイベントでtrackSingleの使用を有効または無効にします。 Facebook PixelトラッキングコールにtrackSingleを使用するかどうかを切り替えます。 デフォルト値はtrueです。 falseに設定すると、すべてのFacebookトラッキングコールに対してtrackが使用されます。
Toggle disablePushState Usage	disablePushState	Boolean [true/false]	disablePushState設定を切り替えます。 同じページで複数のPageViewがトリガーされないようにするかどうかを切り替えます（シングルページアプリケーション用）。 デフォルト値はfalseです。

Advanced Matching

宛先	変数	タイプ	説明
Email	am.em	[String]	メールアドレス コネクタはこの値を小文字に自動変換します。 この値はプレーンテキスト、または正規化およびSHA-256ハッシュ化された値である場合があります。
First Name	am.fn	[String]	名
Last Name	am.ln	[String]	姓
Phone Number	am.ph	[String]	電話番号
Gender	am.ge	[String]	性別 コネクタはこの値を小文字に自動変換します。 この値はmまたはfである必要があります。
Date of Birth	am.db	[String]	生年月日 コネクタはこの値を小文字に自動変換します。 この値は8文字である必要があります。
City	am.ct	[String]	都市
State	am.st	[String]	州
Zip	am.zp	[String]	郵便番号 コネクタはこの値を小文字に自動変換します。 この値は5文字以下である必要があります。
External ID	am.external_id	[String]	外部ID

E-コマース

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

宛先	変数	説明	E-コマース拡張変数
Order ID	order_id	最終注文に割り当てられた一意の識別子です。	_corderを上書きします。
Sub Total	sub_total	最終注文の小計金額です。	_csubtotalを上書きします。
Currency	order_currency	支払いに使用される通貨です。	_ccurrencyを上書きします。
List of Product IDs	product_id	製品配列内の各製品の一意の識別子です。	_cprodを上書きします。
List of Product Names	product_name	製品配列内の各製品の名前です。	_cprodnameを上書きします。
List of Product Quantities	product_quantity	製品配列内の製品の数量です。	_cquanを上書きします。
List of Categories	product_category	製品配列内の各製品のカテゴリです。	_ccatを上書きします。
List of Prices	product_unit_price	製品配列内の各製品の単価です。	_cpriceを上書きします。

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

宛先	変数	タイプ	説明
Currency	currency	[String]	イベントの値の通貨です。
Content Category	content_category	[Array,String]	ページ/製品のカテゴリです。
Content Name	content_name	[Array,String]	ページ/製品の名前です。
Content IDs	content_ids	[Array]	イベントに関連付けられた製品のIDまたはSKUです。
Content Type	content_type	[String]	コンテンツIDに関連付けられた製品タイプで、Facebookの製品フィードで指定されたタイプと一致するものです。ほとんどの場合、これはproductまたはproduct_groupです。Dynamic Adsには、各ビジネスの垂直に他の正当な値があります。
Contents	contents	[Array,JSON Object]	数量とコンテンツIDを含むJSONオブジェクトの配列です。
Predicted Lifetime Value	predicted_ltv	[String]	広告主が定義する購読者の予測寿命価値です。正確な値として表されます。
Search String	search_string	[String]	Searchイベントで使用されます。検索のために訪問者が入力した文字列です。
Status	status	[String]	completeRegistrationイベントで使用されます。登録のステータスです。
Number of Items	num_items	[Number]	イベントのアイテム数です。アイテム数は、数量のデータマッピングの値に基づいて自動的に計算されます。calc_items（u.data.calc_items）をfalseに設定するか、データマッピングまたは拡張機能を使用して自動計算を無効にできます。
Value	value	[String]	このイベントを実行するユーザーのビジネスへの価値です。

コンテンツタイプ

コンテンツタイプパラメーターを設定するには、標準のトラッキングパラメータータブまたはイベント固有のパラメーターマッピングで直接マッピングします。

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

• destination
• flight
• home_listing
• hotel
• product
• product_group
• vehicle

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

変数	説明
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	カスタムイベントの名前をフィールドに入力します。

イベント固有のパラメーター

特定のイベントのみにパラメーターをマッピングするには、まずパラメーターの名前をドロップダウンリストから選択し、その後、そのパラメーターを設定したいイベントの名前を選択します。

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

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

自動車パラメーター

宛先	変数	説明
Body Style	body_style	ボディスタイル。
Condition of Vehicle	condition_of_vehicle	車両の状態。
Country	country	国。
Drivetrain	drivetrain	駆動方式。
Exterior Color	exterior_color	外装色。
Fuel Type	fuel_type	燃料の種類。
Interior Color	interior_color	内装色。
Lead Type	lead_type	リードタイプ。
Make	make	メーカー。
Model	model	モデル。
Postal Code	postal_code	郵便番号。
Preferred Price Range	preferred_price_range	配列。希望価格範囲。最小価格と最大価格を含む配列である必要があります。
Price	price	価格。
Registration Type	registration_type	登録タイプ。
Search Type	search_type	検索タイプ。
State of Vehicle	state_of_vehicle	車両の状態。
Transmission	transmission	トランスミッション。
Trim	trim	トリム。
ViewContent Type	viewcontent_type	コンテンツの表示タイプ。
VIN	vin	VIN番号。
Year	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。目的地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 Consent

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

Limited Data Use

変数	説明
lmt_data.use_ldu (Use LDU)	trueの場合、FacebookのLimited Data Useオプションを使用します。falseの場合、FacebookのLimited Data Useオプションを使用しません。
lmt_data.ldu_types.geolocate (LDU should Geolocate)	trueの場合、LDUはユーザーの位置情報を取得します。falseの場合、LDUはユーザーの位置情報を取得しません。“Use LDU"が有効になっている場合、“LDU should Geolocate"もデフォルトで有効になります。
lmt_data.ldu_types.california (LDU is California)	trueの場合、テンプレート内の州と国のCalifornia固有の値を設定します。ユーザーがCaliforniaに位置しており、Limited Data Useで処理する必要がある場合にのみ、このオプションを有効にします。falseの場合、テンプレート内のユーザーの州と国のCalifornia固有の値は設定されません。

ベンダーのドキュメント

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

• Facebook Pixel Developer Documentation.
• Migrating from Deprecated Pixels
• Reference: Standard and Custom Events
• The Facebook Pixel FAQ
• Advertiser Help Center: Using Facebook Pixel with Tealium
• Conversion Tracking with the Pixel