Facebook Pixel タグ構成ガイド
この記事では、Tealium iQ タグ管理アカウントで Facebook Pixel タグを構成する方法について説明します。
従来の Facebook Pixel についての情報は、Facebook Pixel 構成ガイド(レガシー)を参照してください。
動作方法
注文IDが入力されると、購入追跡が自動的に行われます。
Pixel ID フィールドには、カンマ区切りの Pixel ID リストを入力できます。
イベントIDの生成:
trueに構成すると、Facebook Pixel でevent_idパラメータが生成され、これらのイベントIDがサーバーサイド属性として利用可能になります。- 最新バージョンの Tealium Collect タグが必要です。
event_idにカスタム変数をマッピングする予定の場合は、trueに構成する必要があります。- 詳細については、Web用コンバージョンAPIを参照してください。
テンプレートは、製品数量の配列が存在する場合に自動的に
num_items値を計算しようとします。マッピングを使用して以下を行います:
trackSingleの切り替え(デフォルトではfalse)— 有効にすると、fbq('trackSingle')を使用して明示的にマッピングされたピクセルIDにのみイベントを送信し、無効にすると、fbq('track')を使用して初期化されたすべてのピクセルIDにイベントをブロードキャストします。disablePushStateの切り替え(デフォルトではfalse)- タグ構成を動的に構成
- E-Commerce 拡張の値を上書き
次の E-Commerce 拡張パラメータをサポート:
- 注文 ID
- 小計
- 通貨
- 製品IDのリスト
- 製品カテゴリのリスト
- 製品価格のリスト
- 製品数量のリスト
- 製品名のリスト
Facebook Pixel タグは自動的にユーザーデータをハッシュ化します。この機能は変更できません。
Web 用コンバージョン API
この機能にはアクティブな Tealium Collect タグが必要です。
Web用FacebookコンバージョンAPIをサポートするには、イベントIDの生成をtrueに構成します。イベントIDの生成が有効になっている場合、このタグは追跡された各イベントに対して一意のイベントIDを生成し、それをTealium EventStreamのFacebookコンバージョンコネクタで使用する属性として送信し、event_idパラメータでFacebook Pixelに渡します。このイベントID属性は、サーバーサイド統合とWebベースのタグを同期するためにコネクタでマッピングできます。
タグは次の命名規則を使用してイベント ID を送信します:
fb_event_id_{FACEBOOK_EVENT}_{TAG_UID}
たとえば、タグ#32からの購入イベントは次の属性と値を送信します:
{
"fb_event_id_Purchase_32": "028b2ade7478..."
}
同じタグからのページビューイベントは次の属性と値を送信します:
{
"fb_event_id_PageView_32": "084b1cda7461..."
}
重複排除
適切なイベントの重複排除を確保するために、Facebook Pixel タグからのイベントIDをTealium Collect タグによって送信されるペイロードに含める必要があります。これを行うには、次の手順を実行します:
- タグタイミングドロップダウンから優先を選択します。
- バンドルフラグトグルを
オンに構成します。 - ロードオーダーマネージャー画面を使用して、Tealium Collect タグの前に Facebook Pixel タグを発火させます。Tealium Collect タグは最後に発火させることをお勧めします。
これらのイベントID属性の使用に関する情報については、Facebook Conversions コネクタ:Webイベントの重複排除を参照してください。
レガシーイベント ID
Facebook Pixel タグの古いバージョンでは、fb_event_id_{FACEBOOK_EVENT}の形式でイベントID属性が生成されていました。たとえば、fb_event_id_Purchaseです。これらの古い属性名はタグによって引き続き生成されますが、同じページ上で複数のFacebookタグをサポートしないため、レガシーと見なされます。
Facebook Pixel タグの最新バージョンは、生成された属性名にタグUIDを含めることで、ページ上で複数のFacebookタグが発火するのをサポートします。もしまだレガシー形式のイベントID属性を使用している場合は、タグの最新バージョンに更新し、新しいイベントID属性を参照することをお勧めします。
タグ構成
タグマーケットプレースにアクセスして新しいタグを追加します。タグを追加する方法についての詳細は、タグの管理を参照してください。
タグを追加した後、次の構成を構成します:
- Pixel ID
- あなたのFacebook Pixel ID。
- Pixel IDはコードスニペット内で長い数字のシリーズとして表示されます。
- 複数のPixel IDをスペースなしのカンマ区切りリストで入力できます。
- 例:
fbq("init", "12345678901234");
- 高度なマッチング
- Facebook Advanced Matchingサービスにデータを送信して有効にします。
- 例:
fbq("init", "12345678901234", {em:"6dd8b7d7..."}); - 高度なマッチングを有効にして個人を特定できる情報(PII)のパラメータをマッピングする場合は、Meta Events Managerで自動高度なマッチングを無効にし、パラメータを手動でのみマッピングすることを強くお勧めします。自動高度なマッチングは、必要および範囲外の追加のPIIパラメータをマッピングする可能性があり、セキュリティおよびプライバシーの問題を引き起こす可能性があります。詳細については、Facebookのウェブサイトまたはモバイルアプリの自動高度なマッチングの構成を参照してください。
- イベントIDの生成
- Tealium Collect タグがサーバーサイドでイベントIDを送信するために必要です。
- すべてのFacebookトラッキングイベントに対して自動的にイベントIDを生成します。
- イベントID属性は次の命名規則に従います:
fb_event_id_{FACEBOOK_EVENT}_{TAG_UID} - 例:
"fb_event_id_Purchase_32" : "028b2ade7478..."
- 自動ページビューイベント:
Trueに構成すると、ページビューイベントを自動的に追跡します。
イベントマッピング
Facebook Pixel イベントは、イベントにマッピングする変数を選択し、トリガーを入力することでデータマッピングを通じて構成されます。次のユースケースで示されるように、変数が特定の値と等しい場合にイベントがトリガーされます。
ユースケース:購入イベント
購入イベントを構成するには:
- 変数ドロップダウンリストから
tealium_eventを選択し、宛先を選択をクリックします。 - カテゴリセクションで、イベントを選択します。
- マッピングされた変数が等しい場合フィールドに
Purchaseを構成します。これはtealium_eventが購入をトリガーするために等しくなければならない値です。 - トリガーイベントドロップダウンリストで、
Purchaseを選択します。これはtealium_eventが購入と等しい場合にトリガーされるイベントです。 購入イベントに送信する必要がある追加データが、組み込みの E-Commerce 拡張マッピングによってカバーされていない場合は、カスタムパラメータを使用して追加の購入データをマッピングします。
次の例では、購入イベントに製品ブランドを渡します:
- 変数ドロップダウンリストから
product_brandを選択し、宛先を選択をクリックします。 - カテゴリセクションで、イベント固有のパラメータを選択します。
- 宛先フィールドにカスタムパラメータの名前
brandを構成します。 - イベントのためにドロップダウンリストで、カスタムパラメータが収集するイベント
Purchaseを選択します。
Facebook Pixel Helper またはブラウザが提供する開発者ツールを使用してマッピングをテストします。
- ネットワークパネルを使用し、Facebookをキーワードに含むすべてのネットワークリクエストを表示するためにFacebookでフィルタリングします。
- リクエストの名前を見て、購入イベントが成功したことを確認します。
- リクエストを開き、クエリ文字列パラメータまでスクロールダウンして、構成されたデータマッピングの値を確認します:
purchase、product_id、およびproduct_brand。
データマッピング
データマッピングは階層構造を持ち、特定のマッピング(例えばイベント固有のパラメーター)は一般的なマッピングよりも優先されます。例えば、標準トラッキングパラメーター タブで変数を Currency 宛先にマッピングし、ViewContent イベントのためにも Currency 宛先にマッピングした場合、ViewContent のマッピングが一般的なマッピングよりも優先されますが、これは ViewContent イベントにのみ適用されます。他のすべてのイベントでは、標準トラッキングマッピングが使用されます。
マッピングとは、データレイヤー変数からベンダータグの対応する宛先変数へデータを送信するプロセスです。変数をタグ宛先にマッピングする方法については、データマッピングを参照してください。
利用可能なカテゴリーは以下の通りです:
タグ構成
| 変数 | 宛先 | タイプ | 説明 |
|---|---|---|---|
pixel_id | ピクセルID | 文字列 |
|
autoConfig | 自動構成の切り替え | ブール値 |
|
auto_page_view | 自動ページビューの切り替え | ブール値 |
|
advanced_matching | 高度なマッチングの切り替え | ブール値 |
|
generate_event_id | イベントIDの生成 | ブール値 |
|
calc_items | アイテム数の自動計算 | ブール値 |
|
track_single | trackSingleの使用の切り替え | ブール値 |
|
disablePushState | disablePushStateの使用の切り替え | ブール値 |
|
useContentsObject | コンテンツオブジェクトの使用の切り替え | ブール値 |
|
event_id | イベントID | 文字列 |
|
高度なマッチング
| 変数 | 宛先 | タイプ | 説明 |
|---|---|---|---|
am.em | メール | 文字列 |
|
am.fn | 名 | 文字列 | 名。 |
am.ln | 姓 | 文字列 | 姓。 |
am.ph | 電話番号 | 文字列 | 電話番号。 |
am.ge | 性別 | 文字列 |
|
am.db | 生年月日 | 文字列 |
|
am.ct | 市 | 文字列 | 市。 |
am.st | 州 | 文字列 | 州。 |
am.zp | 郵便番号 | 文字列 |
|
am.external_id | 外部ID | 文字列 | 外部ID。 |
Eコマース
Facebook Pixelタグは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 | コンテンツタイプ | 文字列 |
|
contents | コンテンツ | JSONオブジェクトの配列 | 数量とコンテンツIDを含むJSONオブジェクトの配列。 |
predicted_ltv | 予測生涯価値 | 数値 | 広告主によって定義された購読者の予測生涯価値で、正確な値として表現されます。 |
search_string | 検索文字列 | 文字列 | Searchイベントのために訪問が入力した文字列。 |
status | ステータス | 文字列 | completeRegistrationイベントの登録状況。 |
num_items | アイテム数 | 整数 |
|
value | 価値 | 数値 | このイベントを実行するユーザーのビジネスへの価値 |
コンテンツタイプ
標準トラッキングパラメータタブまたはイベント固有パラメータマッピングで直接content_typeパラメータにマッピングして構成します。
コンテンツタイプタブでは、以下のサポートされている値のいずれかにcontent_typeパラメータを条件付きで構成できます:
destinationflighthome_listinghotelproductproduct_groupvehicle
マッピングされた変数がフィールドに入力した値と等しい場合、ドロップダウンリストから選択したタイプに値が構成されます。ほとんどの場合、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 | 文字列 | 地域 |
クッキー同意
| 変数 | 説明 |
|---|---|
grant | クッキー同意を与える |
revoke | クッキー同意を取り消す |
限定データ使用
| 変数 | タイプ | 説明 |
|---|---|---|
lmt_data.use_ldu (LDUを使用) | ブール値 |
|
lmt_data.ldu_types.geolocate (LDUがジオロケートするべきか) | ブール値 |
|
lmt_data.ldu_types.california (LDUがカリフォルニアである) | ブール値 |
|
ストアデータ
| 変数 | タイプ/値 | 説明 |
|---|---|---|
store_data.store_page_id | 数値 | FacebookストアページID |
store_data.brand_page_id | 数値 | FacebookブランドページID |
store_data.store_code | 文字列 | Facebookストアコード |
ベンダー文書
以下のベンダー文書を参照してください:
最終更新日 :: 2026年March月31日