Facebook Conversions コネクタ構成ガイド

前提条件

Web イベントに Facebook Conversions コネクタを使用する場合は、クライアント側の Facebook Pixel タグが Web ブラウザで実行されている必要があります。詳細については、Facebook ヘルプセンターを参照してください。

Facebook 広告アカウントの構成で Tealium パートナー連携を有効にするには、次の手順を実行します。

Facebook 広告マネージャアカウントにログインし、メニューから イベントマネージャを選択します。
メニューでデータソースを選択し、Pixel を選択してから構成タブをクリックします。
サーバー側 API セクションまで下にスクロールします。
パートナー連携セクションで、パートナーを選択をクリックします。
Tealium 接続を承認を選択し、続行をクリックして Tealium を有効にします。

パートナー連携を切り替えるオプションが表示されない場合は、Tealium アカウントマネージャにお問い合わせください。

Facebook Pixel タグはユーザーデータを自動的にハッシュ化します。Facebook Pixel タグの値や、すでにハッシュ化されたその他の値を変換する場合は、二重にハッシュ化されないよう、それらのパラメータの Already SHA256 Hashed バリアントにマッピングしてください。

API 情報

このコネクタは、次のベンダー API を使用します。

API 名：Facebook Graph API - Facebook Pixel
API バージョン：v25.0
API エンドポイント：https://graph.facebook.com

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

コネクタを追加した後、次の構成を構成します。

Pixel / Dataset ID
- Facebook Pixel ID。
- Facebook Pixel が正しく動作するように、前提条件に記載されている手順に従って、Facebook Pixel のパートナー連携を有効にしてください。
- 詳細については、Meta Pixel の構成とインストール方法を参照してください。

コネクタを構成したら、完了をクリックします。

接続のテスト

Facebook への接続をテストするには、次の手順を実行します。

Pixel が許可リストに追加され、Tealium に対して有効になっている場合、TealiumTestConnector イベントが Pixel でトラッキングされます。接続をテストをクリックして、TealiumConnectorTest という名前のテストイベントを送信します。
Facebook イベントマネージャの Pixel の概要を確認し、イベントが受信されたことを確認します。
テストに失敗した場合は、構成構成を再確認してください。

Web イベントの重複排除

このコネクタを構成し、Facebook Pixel タグからのイベントの重複を排除するには、次の命名規則に従ってイベント属性として送信されるイベント ID を使用します。

fb_event_id_{FACEBOOK_EVENT}_{TAG_UID}

タグの UID は、タグ管理のタグテーブルまたはタグの詳細画面で確認できます。

たとえば、UID が 168 のタグから購入イベントが送信される場合、次の属性値が送信されます。

{
  "fb_event_id_Purchase_168": "028b2ade7478..."
}

同じタグからページビューイベントが送信される場合、次の属性値が送信されます。

{
  "fb_event_id_PageView_168": "084b1cda7461..."
}

イベントの種類ごとに個別のアクションを使用します。イベント固有のイベント ID 属性を Event ID にマッピングし、対応するイベント名を Event Name にマッピングします。例：

Tealium 属性	Facebook パラメータ
`fb_event_id_Purchase_168`（属性）	Event ID
`"Purchase"`（カスタムテキスト）	Event Name

タグ UID を含まない fb_event_id_{FACEBOOK_EVENT} 形式のイベント ID 属性のみを受信している場合は、タグを更新することをお勧めします。詳細については、Facebookピクセルタグ構成ガイドを参照してください。

自動重複排除

自動重複排除の値が入力されている場合、コネクタは対応するイベント ID 属性を検索します。このセクションに値が入力され、タグ管理を使用している場合は、Event ID を追加する必要はありません。ただし、タグ管理を使用せずにイベントストリーミングを使用する場合は、引き続き次の方法が必要になることがあります。

コネクタは、次の優先順位で処理します。

自動重複排除に値が入力され、その値がデータレイヤーに存在する場合、この値が Event ID にマッピングされた値より優先されます。例：fb_event_id_ViewContent_30。
自動重複排除に値が入力されているものの、タグ ID を含むバージョンが見つからず、レガシーバージョン（ID がエンリッチメントされていないもの）が見つかった場合は、その値が使用されます。例：fb_event_id_ViewContent。
自動重複排除に値が入力されているものの、その値が見つからない場合は、マッピングされた Event ID に値が入力されていれば、その値が使用されます。

オフラインコンバージョン

Facebook Conversions コネクタを介してオフラインイベントと店舗イベントを処理するには、必須パラメータが含まれるようにコネクタを構成します。

前提条件

Facebook Conversions API を介して送信されるオフラインイベントは、Facebook イベントマネージャ内のデータセットに関連付けられている必要があります。
すべてのオフラインイベントと店舗イベントで、広告主はイベント内の action_source パラメータを physical_store に構成する必要があります。
オフラインイベントには、すべての必須イベントパラメータを含める必要があります。詳細については、Meta：サーバーイベントパラメータを参照してください。

構成手順

Facebook Conversions コネクタを構成してオフラインイベントと店舗イベントを送信するには、次の手順を実行します。

Facebook イベントマネージャで、新しいオフラインデータソースを作成するか、既存のものを選択します。構成手順については、Meta：Conversions API を使用したオフラインイベントの送信を参照してください。
コネクタの構成で、オフラインデータソースに関連付けられている Dataset ID を入力します。この ID は、イベントを正しい Meta データセットに送信するために使用されます。
アクションタブで、イベントを送信などの新しいアクションを追加します。
Action Source パラメータを physical_store にマッピングします。
必須パラメータをマッピングし、イベントの種類に応じて必要な任意パラメータを含めます。
イベントを送信し、Facebook イベントマネージャで確認します。

詳細については、Meta：Conversions API を使用したオフラインイベントの送信を参照してください。

自動マッピング

デフォルトでは、コネクタは e コマース拡張機能から次のパラメータを自動的にマッピングします。

Tealium 属性	Facebook パラメータ	説明
`_csubtotal`	`value`	イベントの小計値。
`_ccurrency`	`currency`	イベントの通貨。
`_cprod`	`contents[].id`	イベントに関連付けられた製品 ID。
`_csku`	`contents[].content_ids`	製品の SKU。
`_cquan`	`contents[].quantity`	製品の数量。
`_corder`	`order_id`	イベントに関連付けられた注文 ID。
`_ccat`	`contents[].category`	製品のカテゴリ。
`_cprodname`	`contents[].content_name`	製品名。
`_cprice`	`contents[].item_price`	製品の価格。
Browser ID	`fbp`	Facebook の `_fbp` Cookie に保存されているブラウザ ID。
Click ID	`fbc`	Facebook の `_fbc` Cookie に保存されている Facebook クリック ID の値。

コネクタからベンダーへこれらのパラメータが自動送信されないようにするには、自動マッピングを無効化を true に構成して有効にします。

ユーザーデータのハッシュ化

ハッシュ化可能な各識別子フィールドには、次の2つのマッピング先があります。

SHA256ハッシュを適用：値がプレーンテキストの場合に使用します。コネクタは、Metaに送信する前に値を正規化し、SHA-256でハッシュ化します。
SHA256でハッシュ化済み：MetaのParamBuilder SDKや独自のハッシュ化パイプラインなどにより、上流ですでに値が正規化およびハッシュ化されている場合に使用します。コネクタは値を変更せずに転送します。

同じフィールドに両方の形式をマッピングしないでください。何らかの理由で両方が存在する場合（古いプロファイルバージョンを復元した場合など）は、SHA256でハッシュ化済みの値が優先されます。

アクション

アクション名	訪問プロファイル	イベントデータ
イベントを送信	✓	✓
高度な測定イベントを送信	✓	✓
CRM（CAPI）イベントを送信	✓	✓

続行をクリックして、コネクタのアクションを構成します。アクションの名前を入力し、リストからアクションタイプを選択します。

イベントを送信

パラメータ

ユーザーデータパラメータについて、次の表に一部のパラメータの重要度を示します。重要度は、イベントのマッチ品質に対するパラメータの影響を表します。たとえば、メールアドレス（em）の重要度は最高で、電話番号（ph）の重要度は高です。

フィールドごとのハッシュパラメータが導入される前にこのアクションを構成していた場合、アクションは自動的に移行されます。ユーザーデータはすでにハッシュ化済みが有効になっていたアクションは、対応する Already SHA256 Hashed パラメータに移行されます。それ以外のすべてのアクションは、Apply SHA256 Hash パラメータに移行されます。移行後も送信ペイロードは変更されません。

パラメータ	説明
イベントソースURL	イベントが発生したブラウザーのURLです。アクションソースが `website` に構成されている場合、このパラメータは必須です。イベントストリーミング - アクションソースが `website` に構成され、このフィールドがマッピングされていない場合、イベントストリーミングの「現在のURL」属性に自動的にマッピングされます。顧客データプラットフォーム（CDP） - アクションソースが `website` に構成され、このフィールドがマッピングされていない場合、CDPの最終イベントURL属性に自動的にマッピングされます。
テストイベントコード	テストイベントウィンドウでイベントアクティビティを確認するには、`test_event_code` パラメータでテストIDを送信します。`test_event_code` とともに送信されたイベントは破棄されず、イベントマネージャに送られ、ターゲティングおよび広告測定に使用されます。
データ処理オプション	（任意）Facebookがデータ利用制限に従ってイベントを処理するようにするには、このパラメータを値 `LDU` にマッピングします。それ以外の場合、データ利用制限を適用せずにイベントを処理するよう指定するには、このパラメータを値 `None` にマッピングします。詳細については、Facebook：データ処理オプションを参照してください。
イベント名	（必須）Facebookピクセルの標準イベント名またはカスタムイベント名です。
デバッグレベル	イベントのトレースレベルを指定します。エラーの場合は `1` 情報の場合は `2` デバッグの場合は `3` データのハッシュ化を確認するためにトレースを使用する場合、トレースの上部に表示される `user_data - EMAIL` などのデータは、Facebookに送信されたデータではなく、コネクターに入力されたデータです。Facebookに送信されたデータは、トレースのリクエスト本文セクションに表示されます。
アクションソース	（必須）コンバージョンが発生した場所を指定します。有効なアクションソースは次のとおりです。 `email` `website` `app` `phone_call` `chat` `physical_store` `system_generated` `other`
データセットIDの上書き	コネクター構成のデータセットIDをこの文字列で上書きします。指定しない場合は、コネクター構成のデータセットIDが使用されます。
データ処理オプションの国	ユーザーイベントに関連付けられた国コードをマッピングします。データ処理オプションが `LDU` にマッピングされている場合、このパラメータは必須です。使用可能なコード値：アメリカ合衆国の場合は `1` Facebookに国の位置情報判定を要求する場合は `0` 位置情報の判定には、クライアントIPアドレス属性のマッピングも必要です。
イベントID	サーバーとブラウザーの両方から送信された同一イベントをFacebookが重複排除するために使用するIDです。この値が、ブラウザーとサーバーから送信される1組のイベントに固有のIDであることを確認してください。このフィールドはJSONテンプレートをサポートしています。テンプレートを参照するには `{{template_name}}` を使用します。
イベント時刻	実際にイベントが発生した時刻を示す、秒単位のUnixタイムスタンプです。コネクターは、マッピングされた日付属性を秒単位に変換します。属性が存在しない場合は、イベント時刻を自動的に構成します。
データ処理オプションの州	データ処理オプションが `LDU` にマッピングされている場合、このパラメータは必須です。ユーザーイベントに関連付けられた州コードをマッピングします。使用可能なコード値： `0`：Metaによる位置情報判定（クライアントIPアドレスが必要） `1000`：カリフォルニア州 `1001`：コロラド州 `1002`：コネチカット州 `1003`：フロリダ州 `1004`：オレゴン州 `1005`：テキサス州 `1006`：モンタナ州 `1007`：デラウェア州 `1008`：ネブラスカ州 `1009`：ニューハンプシャー州 `1010`：ニュージャージー州 `1011`：ミネソタ州 `1012`：メリーランド州 `1013`：ロードアイランド州位置情報判定（`0`）には、クライアントIPアドレス属性のマッピングが必要です。クライアントIPアドレスを使用できないオフラインイベントでは、明示的な州コード（`1000`～`1013`）を使用してください。
郵便番号（`zip`）	郵便番号です。このパラメータには、文字列または文字列の配列を指定できます。例：`90120` または `["90120", "90121"]`。重要度：中
FacebookログインID	ユーザーがアプリのインスタンスに初めてログインしたときにFacebookによって発行されるIDです。このパラメータは、アプリスコープIDとも呼ばれます。この値はハッシュ化しないでください。
パートナーID	パートナーのIDです。LiverampやTradeDeskなどのサードパーティIDプロバイダーは、このパラメータを追加のユーザー識別子として使用できます。この値はハッシュ化しないでください。
パートナー名	パートナーの名前です。LiverampやTradeDeskなどのサードパーティIDプロバイダーは、このパラメータを追加のユーザー識別子として使用できます。この値はハッシュ化しないでください。
クライアントユーザーエージェント（`ua`）	アクションソースがwebsiteに構成されている場合、このパラメータは必須です。イベントに対応するブラウザーのユーザーエージェントです。この値はハッシュ化しないでください。イベントストリーミング - アクションソースがwebsiteに構成され、このフィールドがマッピングされていない場合、イベントストリーミングのユーザーエージェント属性に自動的にマッピングされます。 CDP - アクションソースがwebsiteに構成され、このフィールドがマッピングされていない場合、CDPにおける訪問の最後のユーザーエージェントに自動的にマッピングされます。重要度：高
クライアントIPアドレス（`ip`）	イベントに対応するブラウザーのIPアドレスです。TealiumはクライアントIPアドレスを取得できますが、デフォルトでは使用できません。詳細については、サーバーサイドTealium製品でのIPアドレス収集の有効化を参照してください。この値はハッシュ化しないでください。重要度：高
メールアドレスにSHA256ハッシュを適用	平文のメールアドレスです。コネクターは、この値を正規化してハッシュ化してから送信します。このパラメータには、文字列または文字列の配列を指定できます。例：`user@example.com` または `["user@example.com", "user2@example.com"]`。重要度：最高
メールアドレスはSHA256でハッシュ化済み	すでに正規化され、SHA-256でハッシュ化されているメールアドレスです。コネクターは、この値を変更せずに転送します。このパラメータには、文字列または文字列の配列を指定できます。重要度：最高
電話番号にSHA256ハッシュを適用	平文の電話番号です。国番号、市外局番、電話番号を数字のみで指定します。コネクターは、この値を正規化してハッシュ化してから送信します。このパラメータには、文字列または文字列の配列を指定できます。例：`16505551212` または `["16505551212", "16505551213"]`。重要度：高
電話番号はSHA256でハッシュ化済み	すでに正規化され、SHA-256でハッシュ化されている電話番号です。コネクターは、この値を変更せずに転送します。このパラメータには、文字列または文字列の配列を指定できます。重要度：高
名にSHA256ハッシュを適用	小文字の平文で表記された名です。コネクターは、この値を正規化してハッシュ化してから送信します。このパラメータには、文字列または文字列の配列を指定できます。例：`joe` または `["joe", "jane"]`。重要度：中
名はSHA256でハッシュ化済み	すでに正規化され、SHA-256でハッシュ化されている名です。コネクターは、この値を変更せずに転送します。このパラメータには、文字列または文字列の配列を指定できます。重要度：中
姓（SHA256 ハッシュを適用）	小文字のプレーンテキストで表した姓。コネクタは、送信前にこの値を正規化してハッシュ化します。このパラメータには、文字列または文字列の配列を指定できます。例：`smith` または `["smith", "jones"]`。重要度：中
姓（SHA256 ハッシュ化済み）	正規化および SHA-256 ハッシュ化がすでに行われている姓。コネクタは、この値を変更せずに転送します。このパラメータには、文字列または文字列の配列を指定できます。重要度：中
市区町村（SHA256 ハッシュを適用）	スペースや句読点を含まない、小文字のプレーンテキストで表した市区町村。コネクタは、送信前にこの値を正規化してハッシュ化します。このパラメータには、文字列または文字列の配列を指定できます。例：`menlopark` または `["menlopark", "sandiego"]`。重要度：中
市区町村（SHA256 ハッシュ化済み）	正規化および SHA-256 ハッシュ化がすでに行われている市区町村。コネクタは、この値を変更せずに転送します。このパラメータには、文字列または文字列の配列を指定できます。重要度：中
州（SHA256 ハッシュを適用）	小文字のプレーンテキストで表した米国の州略称。コネクタは、送信前にこの値を正規化してハッシュ化します。このパラメータには、文字列または文字列の配列を指定できます。例：`ca` または `["ca", "tx"]`。重要度：中
州（SHA256 ハッシュ化済み）	正規化および SHA-256 ハッシュ化がすでに行われている州。コネクタは、この値を変更せずに転送します。このパラメータには、文字列または文字列の配列を指定できます。重要度：中
郵便番号（SHA256 ハッシュを適用）	プレーンテキストで表した郵便番号。コネクタは、送信前にこの値を正規化してハッシュ化します。このパラメータには、文字列または文字列の配列を指定できます。例：`90120` または `["90120", "90121"]`。重要度：中
郵便番号（SHA256 ハッシュ化済み）	正規化および SHA-256 ハッシュ化がすでに行われている郵便番号。コネクタは、この値を変更せずに転送します。このパラメータには、文字列または文字列の配列を指定できます。重要度：中
国（SHA256 ハッシュを適用）	小文字のプレーンテキストで表した2文字の国コード。コネクタは、送信前にこの値を正規化してハッシュ化します。このパラメータには、文字列または文字列の配列を指定できます。例：`us` または `["us", "ca"]`。重要度：中
国（SHA256 ハッシュ化済み）	正規化および SHA-256 ハッシュ化がすでに行われている国コード。コネクタは、この値を変更せずに転送します。このパラメータには、文字列または文字列の配列を指定できます。重要度：中
生年月日（SHA256 ハッシュを適用）	年、月、日の順で指定した、プレーンテキストの生年月日。コネクタは、送信前にこの値を正規化してハッシュ化します。このパラメータには、文字列または文字列の配列を指定できます。たとえば、1997年12月26日は `19971226` と指定します。
生年月日（SHA256 ハッシュ化済み）	正規化および SHA-256 ハッシュ化がすでに行われている生年月日。コネクタは、この値を変更せずに転送します。このパラメータには、文字列または文字列の配列を指定できます。
性別（SHA256 ハッシュを適用）	小文字の1文字値（`f` または `m`）で表した、プレーンテキストの性別。コネクタは、送信前にこの値を正規化してハッシュ化します。このパラメータには、文字列または文字列の配列を指定できます。
性別（SHA256 ハッシュ化済み）	正規化および SHA-256 ハッシュ化がすでに行われている性別。コネクタは、この値を変更せずに転送します。このパラメータには、文字列または文字列の配列を指定できます。
外部 ID（SHA256 ハッシュを適用）	ロイヤルティプログラムの会員 ID、ユーザー ID、外部 Cookie ID など、広告主が使用する任意の一意な ID をプレーンテキストで指定します。コネクタは、送信前にこの値を正規化してハッシュ化します。複数の ID を追加するには、配列型属性をマッピングします。
外部 ID（SHA256 ハッシュ化済み）	正規化および SHA-256 ハッシュ化がすでに行われている、広告主が使用する任意の一意な ID。コネクタは、この値を変更せずに転送します。複数の ID を追加するには、配列型属性をマッピングします。
リード ID	Facebook リード獲得広告によって生成されたリードに関連付けられている ID。この値はハッシュ化しないでください。
ブラウザー ID（`fpb`）	Facebook の `_fbp` Cookie に保存されているブラウザー ID の値。識別子の自動マッピングを無効にしない限り、このパラメータは自動的にマッピングされます。この値はハッシュ化しないでください。重要度：高
クリック ID（`fbc`）	Facebook の `_fbc` Cookie に保存されている Facebook クリック ID の値。識別子の自動マッピングが無効になっていない限り、このパラメータは自動的にマッピングされます。この値はハッシュ化しないでください。Facebook は、`fbclid` Cookie を保存して永続化することを推奨しています。重要度：高
サブスクリプション ID	このトランザクションにおけるユーザーのサブスクリプション ID。このフィールドは、個々の商品の注文 ID に相当します。この値はハッシュ化しないでください。例：`anid1234`。
通貨	該当する場合、指定した値に使用する通貨。有効な ISO 4217 の3文字通貨コードを指定する必要があります。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。例：`usd`。
コンテンツ名	イベントに関連付けられているページまたは商品の名前。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。例：`lettuce`。
アイテム数	InitiateCheckout イベントでのみ使用します。ユーザーがチェックアウト中に購入しようとしているアイテムの数。例：`4`。
検索文字列	ユーザーが実行した検索クエリ。検索イベントでのみ使用します。例：lettuce
ステータス	CompleteRegistration イベントでのみ使用します。登録イベントのステータス。例：`registered`。
注文 ID	このトランザクションの注文 ID。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。例：`order1234`。
コンテンツタイプ	この値には `product` または `product_group` のいずれかを指定する必要があります。送信するキーがコンテンツ ID またはコンテンツ商品に含まれている場合は、`product` に構成します。コンテンツ商品は商品を表します。送信するキーがコンテンツ ID に含まれている場合は、`product_group` に構成します。コンテンツ商品は商品グループを表します。
予測顧客生涯価値	コンバージョンイベントの予測顧客生涯価値。例：`432.12`。
純収益	コンバージョンイベントの利益額。このフィールドとともに通貨をマッピングします。例：`20`。
コンテンツ ID	AddToCart イベント内のアイテムの商品 SKU など、イベントに関連付けられているコンテンツ ID。例：`['ABC123', 'XYZ789']`。配列ではないイベント属性を指定すると、要素が1つの配列に変換されます。コンテンツタイプが `product` の場合、このマッピング値は配列ではないイベント属性か、要素が1つの配列である必要があります。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。
値	このイベントに関連付けられている数値。金額、または別の指標の値を指定できます。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。例：`142.54`。
コンテンツカテゴリー	イベントに関連付けられているコンテンツのカテゴリー。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。例：`grocery`。
数量	商品の数量。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。
価格	商品ごとの価格。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。
ID	商品 ID。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。
JSON テンプレート変数	テンプレートのデータ入力としてテンプレート変数を指定します。詳細については、コネクターテンプレート変数を参照してください。ネストされたテンプレート変数にはドット表記で名前を付けます。例：`items.name`。ネストされたテンプレート変数は通常、データレイヤーのリスト属性から構築されます。
JSON テンプレート	カスタムデータセクションで参照する有効な JSON テンプレートを指定します。テンプレートは、サポートされているフィールドに二重波括弧を使用して名前で挿入されます。例：`{{SomeTemplateName}}`。詳細については、コネクタテンプレートについてを参照してください。
Tealium iQ タグ ID	Facebook Pixel タグの UID。
自動マッピングを無効化	パラメータの自動マッピングを無効にします。
自動重複排除	Tealium iQ タグ ID を指定すると、コネクタはタグ管理から送信されたイベント ID の値を自動的に検索します。
広告主トラッキング有効	（必須）iOS 14.5 以降のデバイスにおける ATT 権限を指定します。無効にする場合は `0`、有効にする場合は `1` に構成します。
アプリケーショントラッキング有効	（必須）このパラメータは、アプリレベルで広告トラッキングを有効にします。SDK では、アプリ開発者がオプトアウト構成をアプリに組み込めるようにする必要があります。このフィールドを使用してユーザーの選択を指定します。無効にする場合は `0`、有効にする場合は `1` を使用します。
OS バージョン	（必須）OS のバージョン。例：`13.4.1`。
アプリパッケージ名	アプリのパッケージ名。例：`com.facebook.sdk.samples.hellofacebook`。
ショートバージョン	ショートバージョン。例：`1.0`。
ロングバージョン	ロングバージョン。例：`1.0 long`。
デバイスモデル名	デバイスのモデル名。例：`iPhone5,1`。
ロケール	ロケール。例：`En_US`。
タイムゾーンの略称	タイムゾーンの略称。例：`PDT`。
通信事業者	通信事業者。例：`AT&T`。
画面幅	画面の幅。例：`320`。
画面の高さ	画面の高さ。例：`568`。
画面密度	画面密度。例：`2`。
CPU コア数	CPU コア数。例：`2`。
保存サイズ（GB）	外部保存のサイズ（GB）。例：`13`。
空き保存（GB）	外部保存の空き容量（GB）。例：`8`。
デバイスのタイムゾーン	デバイスのタイムゾーン。例：`USA/New York`。
キャンペーン ID	ユーザーが Facebook のリンクをクリックした際に、送信先 URL（例：`ad_destination_url`）またはディープリンク（アプリ用の集約イベントマネージャーの場合）にエンリッチメントされる暗号化文字列および非ユーザーメタデータ。
インストールリファラー	サードパーティのインストールリファラー。現在は Android でのみ使用できます。詳細については、キャンペーン測定を参照してください。
インストーラーパッケージ	Android SDK によって内部的に使用されます。
URL スキーム（配列）	iOS および Android SDK によって内部的に使用されます。
Windows アトリビューション ID	Windows 10 で使用されるアトリビューショントークン。
匿名 ID	インストール ID。このフィールドは、アプリケーションの一意のインストールインスタンスを表します。
MADID	モバイル広告主 ID。通常は、Android デバイスの広告 ID、または Apple デバイスの広告識別子（IDFA）です。

高度な測定イベントを送信する

この Facebook アクションは限定的に提供されています。アクセスをリクエストするには、Facebook の担当者にお問い合わせください。このアクションが Facebook アカウントで有効化されていない場合、「Application does not have the capability to make this API call.」や「This pixel is not authorized to report server events.」などのエラーが返されます。

イベントデータ

パラメータ	説明
イベント名	（必須）Facebook ピクセルの標準イベント名。
イベント時刻	実際にイベントが発生した時刻を示す、秒単位の Unix タイムスタンプ。コネクタは、マッピングされた日付属性を秒単位に変換します。属性が存在しない場合は、イベント時刻を自動的に構成します。
イベントソース URL	イベントが発生したブラウザの URL。アクションソースが `website` に構成されている場合は必須です。アクションソースが `website` に構成され、このフィールドがマッピングされていない場合、イベントストリーミングでは属性 `Current URL` に自動的にマッピングされます。アクションソースが `website` に構成され、このフィールドがマッピングされていない場合、CDP では属性 `Last Event URL` に自動的にマッピングされます。
イベント ID	サーバーとブラウザの両方から送信された同一イベントの重複を Facebook が排除するために使用する ID。ブラウザとサーバーから送信された一組のイベントに対して一意の ID であることを確認してください。このフィールドは JSON テンプレートをサポートします。テンプレートを参照するには `{{template_name}}` を使用します。
デバッグレベル	イベントの `trace` レベルを構成します。使用できる値は、エラーの場合は `1`、情報の場合は `2`、デバッグの場合は `3` です。
テストイベントコード	テスト ID を `test_event_code` パラメータとして送信すると、テストイベントウィンドウにイベントアクティビティが表示されるようになります。`test_event_code` とともに送信されたイベントは破棄されません。イベントマネージャーに送られ、ターゲティングおよび広告測定に使用されます。
ピクセル／データセット ID のオーバーライド	指定しない場合は、コネクタ構成のピクセル ID が使用されます。

ユーザーデータ

すべてのユーザーデータパラメータには、文字列または文字列の配列を指定できます。

パラメータ	説明
メールアドレスに SHA256 ハッシュを適用	小文字の平文メールアドレス。コネクタは、送信前にこの値を正規化してハッシュ化します。
SHA256 ハッシュ化済みメールアドレス	正規化および SHA-256 ハッシュ化がすでに行われているメールアドレス。コネクタは、この値を変更せずに転送します。
電話番号に SHA256 ハッシュを適用	平文の電話番号。国番号と市外局番を含む数字のみを使用します。例：`16505554444`。コネクタは、送信前にこの値を正規化してハッシュ化します。
SHA256 ハッシュ化済み電話番号	正規化および SHA-256 ハッシュ化がすでに行われている電話番号。コネクタは、この値を変更せずに転送します。
名に SHA256 ハッシュを適用	小文字の平文の名。コネクタは、送信前にこの値を正規化してハッシュ化します。
SHA256 ハッシュ化済みの名	正規化および SHA-256 ハッシュ化がすでに行われている名。コネクタは、この値を変更せずに転送します。
姓に SHA256 ハッシュを適用	小文字の平文の姓。コネクタは、送信前にこの値を正規化してハッシュ化します。
SHA256 ハッシュ化済みの姓	正規化および SHA-256 ハッシュ化がすでに行われている姓。コネクタは、この値を変更せずに転送します。
市区町村に SHA256 ハッシュを適用	スペースや句読点を含まない、小文字の平文の市区町村名。例：`menlopark`。コネクタは、送信前にこの値を正規化してハッシュ化します。
SHA256 ハッシュ化済みの市区町村	正規化および SHA-256 ハッシュ化がすでに行われている市区町村名。コネクタは、この値を変更せずに転送します。
州または都道府県に SHA256 ハッシュを適用	小文字の平文による2文字の州コード。例：`ca`。コネクタは、送信前にこの値を正規化してハッシュ化します。
SHA256 ハッシュ化済みの州または都道府県	正規化および SHA-256 ハッシュ化がすでに行われている州または都道府県。コネクタは、この値を変更せずに転送します。
ZIP コードまたは郵便番号に SHA256 ハッシュを適用	平文の郵便番号。例：`94035`。コネクタは、送信前にこの値を正規化してハッシュ化します。
SHA256 ハッシュ化済みの ZIP コードまたは郵便番号	正規化および SHA-256 ハッシュ化がすでに行われている郵便番号。コネクタは、この値を変更せずに転送します。
国に SHA256 ハッシュを適用	小文字の平文による2文字の国コード。例：`us`。コネクタは、送信前にこの値を正規化してハッシュ化します。
SHA256 ハッシュ化済みの国	正規化および SHA-256 ハッシュ化がすでに行われている国コード。コネクタは、この値を変更せずに転送します。
生年月日に SHA256 ハッシュを適用	年、月、日の順で指定する平文の生年月日。たとえば、1997年12月26日は `19971226` とします。コネクタは、送信前にこの値を正規化してハッシュ化します。
SHA256 ハッシュ化済みの生年月日	正規化および SHA-256 ハッシュ化がすでに行われている生年月日。コネクタは、この値を変更せずに転送します。
性別に SHA256 ハッシュを適用	小文字1文字（`f` または `m`）の平文で表した性別。コネクタは、送信前にこの値を正規化してハッシュ化します。
SHA256 ハッシュ化済みの性別	正規化および SHA-256 ハッシュ化がすでに行われている性別。コネクタは、この値を変更せずに転送します。
高度な測定テーブル	Advanced Measurement API 用のデータテーブル。

カスタムデータ

カスタムデータをプレーンテキスト値として、またはテンプレート名を {{template_name}} 形式で参照する JSON テンプレートを使用してマッピングします。

パラメータ	説明
値	このイベントに関連付けられた数値（通貨額やその他の指標値など）。例：`142.54`。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。
通貨	該当する場合、指定した値の通貨。通貨には、有効な ISO 4217 の3桁通貨コードを指定する必要があります。例：`usd`。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。
コンテンツ名	イベントに関連付けられたページまたは製品の名前。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。例：`lettuce`。
コンテンツカテゴリ	イベントに関連付けられたコンテンツのカテゴリ。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。例：`grocery`。
コンテンツ ID	イベントに関連付けられたコンテンツ ID（AddToCart イベント内の商品の SKU など）。例：`[ABC123, XYZ789]`。配列ではないイベント属性が指定された場合、コネクタによって単一項目の配列に変換されます。コンテンツタイプが `product` の場合、このマッピング値は、配列ではないイベント属性または単一要素の配列である必要があります。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。
コンテンツタイプ	使用できる値は `product` または `product_group` です。コンテンツ IDまたはコンテンツ製品で送信するキーが製品を表す場合は、`product` に構成します。コンテンツ IDで送信するキーが製品グループを表す場合は、`product_group` に構成します。
注文 ID	この取引の注文 ID。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。例：`order1234`。
予測顧客生涯価値	コンバージョンイベントの予測顧客生涯価値。例：`432.12`。
純収益	コンバージョンイベントの利益額。このフィールドとともに通貨をマッピングしてください。例：`20`。
商品数	`InitiateCheckout` イベントでのみ使用します。ユーザーがチェックアウト時に購入しようとしている商品の数。例：`4`。
検索文字列	Search イベントでのみ使用します。ユーザーが入力した検索クエリ。例：`lettuce`。
ステータス	`CompleteRegistration` イベントでのみ使用します。登録イベントのステータス。例：`registered`。

コンテンツデータ

パラメータ	説明
ID	製品 ID。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。
数量	製品の数量。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。
価格	製品ごとの価格。このパラメータがイベントに含まれている場合、コネクタによって自動的にマッピングされます。

自動重複排除

パラメータ	説明
Tealium iQ タグ ID	タグ管理のタグ UID が指定されると、Tealium はタグ管理から送信されたイベント ID 値を自動的に検索します。

アプリデータ

アプリイベントでは必須です。

パラメータ	説明
広告主トラッキングの有効化	（必須）iOS 14.5 以降のデバイスにおける ATT 権限を指定するには、このフィールドを使用します。無効にする場合は `0`、有効にする場合は `1` に構成します。
アプリケーショントラッキングの有効化	（必須）ユーザーはアプリレベルで広告トラッキングを有効にできます。SDK では、アプリ開発者がアプリにオプトアウト構成を組み込めるようにする必要があります。ユーザーの選択を指定するには、このフィールドを使用します。無効の場合は `0`、有効の場合は `1` を使用します。
アプリバージョン	（必須）バージョンは、Android の場合は `a2`、iOS の場合は `i2` である必要があります。
アプリパッケージ名	アプリのパッケージ名。例：`com.facebook.sdk.samples.hellofacebook`。
短縮バージョン	短縮バージョン。例：`1.0`。
ロングバージョン	ロングバージョン。例：`1.0 long`。
OS バージョン	（必須）OS のバージョン。例：13.4.1。
デバイスモデル名	デバイスのモデル名。例：`iPhone5,1`。
ロケール	ロケール。例：`En_US`。
タイムゾーンの略称	タイムゾーンの略称。例：`PDT`。
通信事業者	通信事業者。例：`AT&T`。
画面の幅	画面の幅。例：`320`。
画面の高さ	画面の高さ。例：`568`。
画面密度	画面密度。例：`2`。
CPU コア数	CPU のコア数。例：`2`。
保存容量（GB）	外部保存の容量（GB）。例：`13`。
空き保存容量（GB）	外部保存の空き容量（GB）。例：`8`。
デバイスのタイムゾーン	デバイスのタイムゾーン。例：`USA/New York`。
キャンペーン ID	ユーザーが Facebook のリンクをクリックしたときに、送信先 URL（例：`ad_destination_url`）またはディープリンク（App Aggregated Event Manager の場合）にエンリッチメントされる、暗号化された文字列およびユーザー以外のメタデータ。
インストールリファラー	サードパーティのインストールリファラー。現在は Android でのみ使用できます。詳細については、Google Analytics（Android）> キャンペーン測定を参照してください。
インストーラーパッケージ	Android SDK によって内部的に使用されます。
URL スキーム（配列）	iOS および Android SDK によって内部的に使用されます。
Windows アトリビューション ID	Windows 10 で使用されるアトリビューショントークン。

CRM（CAPI）イベントの送信

インタラクティブデモ

バッチ制限

このアクションでは、ベンダーへの大量データ転送に対応するため、バッチリクエストを使用します。並列処理により、イベントが順不同でベンダーに到達する場合があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチアクションを参照してください。次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストはキューに保持されます。

リクエストの最大数：1000
最も古いリクエストからの最大経過時間：10分
リクエストの最大サイズ：1 MB

パラメータ

パラメータ	説明
リード ID	（必須）ダウンロードしたリードに含まれる、Facebook が生成した15桁または16桁の `leadgen_id`。この番号は、リード生成 Webhook の `leadgen_id` フィールドから取得され、`user_data` パラメータに含められます。
イベント名	（必須）CRM で使用しているリードステージを記録します。`event_name` パラメータは、CRM のセールスファネルをリードが進行していることを示します。未処理のリードを含め、更新されたすべてのステージを必ず送信してください。
イベント時刻	CRM によってリードステージの更新イベントが更新された時刻を示す、秒単位の Unix タイムスタンプ。タイムスタンプはリード生成時刻より後である必要があります。それ以前の場合、イベントが破棄される可能性があります。このフィールドがマッピングされていない場合は、現在のタイムスタンプで初期化されます。
テストイベントコード	イベントマネージャのテストイベント機能を使用して、サーバーイベントが Facebook に正しく受信されていることを確認します。このツールを開くには、イベントマネージャ > データソース > ピクセル > テストイベントに移動します。
リードイベントソース	イベントの送信元となる CRM の名前。

セットアップ

Facebook との Tealium サーバーサイド API パートナー統合を構成および管理するには、次のオプションがあります。

Facebook パートナー統合ギャラリー
ピクセルの構成タブにあるパートナーを選択ボタン：
Web シグナルの構成フローとサーバーサイド API ガイダンスカード：

イベントの検証

イベントを送信した後、概要ビューおよび内訳ビューで Facebook がイベントを受信したことを確認します。

ビジネスマネージャ > ピクセルに移動します。
POST リクエストの PIXEL_ID に対応するピクセルをクリックします。

概要タブ

概要タブで、ビューをすべてからサーバーに変更すると、正常に送信されたイベントの数を確認できます。

内訳タブ

内訳タブには、正常に送信されたイベントの内訳が表示されます。ドロップされたイベントは、Server Events Received列には表示されません。

サーバーからイベントを送信してから20分以内に、そのイベントを確認できます。

検証

イベント構造を検証するには、データパラメータのフィールドを指定して、Facebookのペイロードヘルパーを使用します。このツールでは、サーバーからFacebookにイベントを送信する際のイベント構造を確認できます。問題のトラブルシューティングについて詳しくは、Facebookのサポートページを参照してください。

コンバージョンAPIについて詳しくは、FacebookのコンバージョンAPIの使用を参照してください。