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-Commerce拡張の値を上書きする

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

  • 注文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は、単一のページで複数の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..."});
• 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-Commerce拡張のマッピングでカバーされていない追加の購入データを送信する場合は、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]	メールアドレス
First Name	am.fn	[String]	名
Last Name	am.ln	[String]	姓
Phone Number	am.ph	[String]	電話番号
Gender	am.ge	[String]	性別
Date of Birth	am.db	[String]	生年月日
City	am.ct	[String]	市区町村
State	am.st	[String]	都道府県
Zip	am.zp	[String]	郵便番号
External ID	am.external_id	[String]	外部ID

E-Commerce

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

宛先	変数	説明	E-Commerce Extension変数
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パラメータを直接マッピングするには、標準トラッキングパラメータタブまたはイベント固有のパラメータマッピングで直接マッピングします。

コンテンツタイプタブでは、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