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用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 | 文字列 |
|
auto_page_view |
自動ページビューの切り替え | ブール値 |
|
advanced_matching |
アドバンスドマッチングの切り替え | ブール値 |
|
generate_event_id |
イベントIDの生成 | ブール値 |
|
calc_items |
アイテム数の自動計算 | ブール値 |
|
track_single |
trackSingle使用の切り替え | ブール値 |
|
disablePushState |
disablePushState使用の切り替え | ブール値 |
|
アドバンスドマッチング
変数 | 宛先 | タイプ | 説明 |
---|---|---|---|
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-commerce対応しているため、デフォルトでE-Commerce Extensionのマッピングを自動的に使用します。このカテゴリで手動マッピングが必要なのは、拡張マッピングを上書きしたい場合や、希望するe-commerce変数が拡張に含まれていない場合だけです。
変数 | 宛先 | 説明 | E-Commerce Extension変数の上書き |
---|---|---|---|
order_id |
注文ID | 最終注文に割り当てられた一意の識別子 | _corder |
sub_total |
小計 | 最終注文の小計金額 | _csubtotal |
order_currency |
通貨 | 支払いに使用される通貨 | _ccurrency |
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
パラメータを以下のサポートされている値のいずれかに条件付きで構成できます:
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 |
連絡 |
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 |
文字列 | 出発日 |
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はカリフォルニア) |
ブール値 |
|
ベンダーのドキュメンテーション
詳細については、以下のベンダーのドキュメンテーションを参照してください:
最終更新日 :: 2024年December月5日