---
title: Facebook Conversionsコネクタ構成ガイド
description: この記事では、アカウントでFacebook Conversionsコネクタを構成する方法について説明します。
url: https://docs.tealium.com/ja/server-side-connectors/facebook-conversions-connector/
---
## 前提条件

Facebook ConversionsコネクタをWebイベント用に使用する場合、クライアント側の[Facebook Pixelタグ](https://docs.tealium.com/facebook-pixel-tag/)がWebブラウザで実行されている必要があります。詳細については、[Facebookヘルプセンター](https://www.facebook.com/business/help/2041148702652965)を参照してください。

Facebook広告アカウントの構成でTealiumパートナー統合を有効にするには、次の手順を使用します：

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

パートナー統合のオプションが表示されない場合は、Tealiumアカウントマネージャーに連絡してサポートを受けてください。


<blockquote>
Facebook Pixelタグは自動的にユーザーデータをハッシュ化します。この機能は変更できません。Facebook Pixelタグデータまたは既にハッシュ化されている他のデータを変換する場合は、データを二重にハッシュ化しないように**ユーザーデータは既にハッシュ化されている**オプションを有効にしてください。
</blockquote>


## API情報

このコネクタは以下のベンダーAPIを使用します：

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

## 構成

コネクタマーケットプレイスにアクセスして新しいコネクタを追加します。コネクタを追加する一般的な手順については、[コネクタについて](https://docs.tealium.com/about-connectors/)を参照してください。

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

* **ピクセル/データセットID**
  * Facebook Pixel ID。
  * Facebook Pixelが正しく機能するためには、[前提条件]()で説明されている手順に従って、Facebook Pixelのパートナー統合を有効にすることを確認してください。
  * 詳細については、[Meta Pixelの構成とインストール方法](https://www.facebook.com/business/m/pixel-set-up-step-1#step-1)を参照してください。

### 接続テスト

Facebookへの接続をテストするには：

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

## Webイベントの重複排除

このコネクタを[Facebook Pixelタグ](https://docs.tealium.com/facebook-pixel-tag/)からのイベントの重複排除に構成するには、次の命名規則でイベント属性として送信されるイベントIDを使用します：

```nohl
fb_event_id_{FACEBOOK_EVENT}_{TAG_UID}
```

Tealium iQの**タグ**テーブルまたはタグ詳細画面でタグのUIDを見つけることができます：

![](https://docs.tealium.com/images/server-side-connectors/facebook-pixel-tag-uid.png)

たとえば、UIDが`168`のタグからの購入イベントは、次の属性値を送信します：

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

同じタグからのページビューイベントは、次の属性値を送信します：

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

各タイプのイベントに対して別のアクションを使用します。イベント固有のイベントID属性を`Event ID`にマッピングし、一致するイベント名を`Event Name`にマッピングします。たとえば：

| Tealium属性  | Facebookパラメータ |
|:-------------------------|:-------------------|
| `fb_event_id_Purchase_168` (属性)   | Event ID           |
| `"Purchase"` (カスタムテキスト) | Event Name         |


<blockquote>
イベントID属性を`fb_event_id_{FACEBOOK_EVENT}`（タグUIDなし）の命名形式でのみ受け取っている場合は、タグを更新することをお勧めします。詳細については、を参照してください。
</blockquote>


### 自動重複排除

**自動重複排除**値が入力されている場合、コネクタは対応するイベントID属性を探します。このセクションが入力されていてTealium iQを使用している場合、`Event ID`を追加する必要はありません。ただし、Tealium iQを使用せずにEventStreamを使用している場合は、次のアプローチが必要になる場合があります。

コネクタは次の操作順序に従います：

* **自動重複排除**が入力され、データレイヤーで値が見つかった場合、この値は`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: Server Event Parameters](https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/server-event)を参照してください。

#### 構成手順

Facebook Conversionsコネクタを使用してオフラインおよび店舗イベントを送信するための構成手順は次のとおりです：

1. Facebookイベントマネージャーで、既存のオフラインデータソースを作成または選択します。構成手順については、[Meta: Sending Offline Events Using the Conversions API](https://developers.facebook.com/docs/marketing-api/conversions-api/offline-events/)を参照してください。
1. コネクタ構成で、オフラインデータソースに関連付けられた**データセットID**を入力します。このIDは、イベントを正しいMetaデータセットに送信するために使用されます。
1. **アクション**タブで、**イベント送信**などの新しいアクションを追加します。
1. **アクションソース**パラメータを`physical_store`にマッピングします。
1. 必要なパラメータをマッピングし、イベントタイプに基づいて必要に応じてオプションのパラメータを含めます。
1. イベントを送信し、Facebookイベントマネージャーで確認します。

詳細については、[Meta: Sending Offline Events Using the Conversions API](https://developers.facebook.com/docs/marketing-api/conversions-api/offline-events/)を参照してください。

## 自動マッピング

コネクタは、デフォルトで次のパラメータを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` | 製品の価格。 |
| ブラウザID | `fbp` | Facebookの`_fbp`クッキーに保存されているブラウザID。 |
| クリックID | `fbc` | Facebookの`_fbc`クッキーに保存されているFacebookクリックID値。 |

これらのパラメータをベンダーに自動的に送信するのを防ぐには、**自動マッピング無効**を`true`に構成して有効にします。
## アクション

| アクション名 | AudienceStream | EventStream |
|:----------------|:-------------------|:----------------|
| イベントを送信 | ✓ | ✓ |
| 高度な測定イベントを送信 | ✓ | ✓ |
| CRM（CAPI）イベントを送信 | ✓ | ✓ |

**次へ**をクリックするか、**アクション**タブをクリックします。コネクタアクションは**アクション**タブで構成します。

このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

### イベントを送信

#### パラメータ

**ユーザーデータ**パラメータについて、以下の表はいくつかのパラメータの重要度を示しています。重要度は、そのパラメータがイベントマッチ品質に与える影響を説明します。例えば、**メール (em)** の重要度は**最高**であり、**電話番号 (ph)** の重要度は**高**です。

| パラメータ   | 説明                              |
|:----------------|:---------------------------------------------|
| イベントソースURL | イベントが発生したブラウザのURL。**アクションソース**が`website`に構成されている場合、このパラメータは必須です。<ul><li>**EventStream** - **アクションソース**が`website`に構成され、このフィールドがマッピングされていない場合、自動的にEventStreamの現在のURL属性にマッピングされます。</li><li>**AudienceStream** - **アクションソース**が`website`に構成され、このフィールドがマッピングされていない場合、自動的にAudienceStreamの**最後のイベントURL**属性にマッピングされます。</li></ul>                                                       |
| テストイベントコード   | `test_event_code`パラメータにテストIDを送信して、テストイベントウィンドウでイベントアクティビティを開始します。`test_event_code`で送信されたイベントは削除されず、イベントマネージャーに流れ、ターゲティングや広告測定の目的で使用されます。 |
| データ処理オプション         | (オプション) このパラメータを`LDU`の値にマッピングして、Facebookがイベントを限定データ使用制限で処理するようにします。それ以外の場合は、このパラメータを`None`の値にマッピングして、イベントが限定データ使用制限で処理されないことを指定します。詳細は、[Facebook: データ処理オプション](https://developers.facebook.com/docs/marketing-apis/data-processing-options)を参照してください。 |
| イベント名   | (必須) Facebookピクセルの標準またはカスタムイベント名。 |
| デバッグレベル | イベントのトレースレベルを指定します。<ul><li>`1` はエラー</li><li>`2` は情報</li><li>`3` はデバッグ</li></ul>データのハッシュ化を確認するためにトレースを使用する場合、トレースの最上部に表示されるデータ（例：`user_data - EMAIL`）はコネクタに入ってきたデータであり、Facebookに送信されたデータではありません。Facebookに送信されたデータはトレースの**リクエストボディセクション**に表示されます。 |
| アクションソース |(必須) あなたのコンバージョンが発生した場所を指定するフィールドです。有効なアクションソースは以下の通りです：<ul><li>`email`</li><li>`website`</li><li>`app`</li><li>`phone_call`</li><li>`chat`</li><li>`physical_store`</li><li>`system_generated`</li><li>`other`</li></ul>   |
| データセットIDオーバーライド   | 初期コネクタ構成で使用される値を上書きするために使用できる文字列値です。提供されていない場合、コネクタ構成からのデータセットIDが使用されます。  |
| データ処理オプション国 | ユーザーイベントに関連する国コードをマッピングします。このパラメータは、**データ処理オプション**が`LDU`にマッピングされている場合に必須です。受け入れられるコード値：<ul><li>`1` はアメリカ合衆国</li><li>`0` は国をFacebookによるジオロケーションを要求する</li></ul>ジオロケーションには、**クライアントIPアドレス**属性のマッピングも必要です。   |
| イベントID   | Facebookがサーバーとブラウザーの両方から送信された同じイベントの重複を排除するために使用するIDです。この値がブラウザーとサーバーから送信されたイベントのペアに対して一意のIDであることを確認してください。  |
| イベント時間  | 実際のイベントが発生したときのUnixタイムスタンプ（秒単位）。コネクタはマッピングされた日付属性を秒に変換し、属性が欠落している場合はイベント時間を自動的に構成します。     |
| データ処理オプション州   | このパラメータは、**データ処理オプション**が`LDU`にマッピングされている場合に必須です。ユーザーイベントに関連する州コードをマッピングします。受け入れられるコード値：<ul><li>`0` — Metaによるジオロケーション（クライアントIPアドレスが必要）</li><li>`1000` — カリフォルニア</li><li>`1001` — コロラド</li><li>`1002` — コネチカット</li><li>`1003` — フロリダ</li><li>`1004` — オレゴン</li><li>`1005` — テキサス</li><li>`1006` — モンタナ</li><li>`1007` — デラウェア</li><li>`1008` — ネブラスカ</li><li>`1009` — ニューハンプシャー</li><li>`1010` — ニュージャージー</li><li>`1011` — ミネソタ</li><li>`1012` — メリーランド</li><li>`1013` — ロードアイランド</li></ul>ジオロケーション（`0`）には、**クライアントIPアドレス**属性のマッピングが必要です。オフラインイベントの場合、クライアントIPアドレスが利用できない場合は、明示的な州コード（`1000`–`1013`）を使用します。   |
| オプトアウト  | このイベントを広告配信の最適化に使用しないことを示すブール値です。この値を`true`に構成すると、イベントは帰属のためにのみ使用されます。 |
| 郵便番号 (`zip`) | 郵便番号です。このパラメータは文字列または文字列の配列を受け入れます。例えば、`90120`または`["90120", "90121"]`。**重要度: 中**  |
| FBログインID  | アプリのインスタンスに初めてログインしたときにFacebookが発行するIDです。このパラメータは[アプリスコープID](https://developers.facebook.com/docs/development/support#app-scoped-ids)としても知られています。この値をハッシュ化しないでください。   |
| パートナーID  | パートナーのIDです。このパラメータはLiverampやTradeDeskのような第三者IDプロバイダーによって追加のユーザー識別子として使用することができます。この値をハッシュ化しないでください。  |
| パートナー名  | パートナーの名前です。このパラメータはLiverampやTradeDeskのような第三者IDプロバイダーによって追加のユーザー識別子として使用することができます。この値をハッシュ化しないでください。  |
| クライアントユーザーエージェント (`ua`)    | **アクションソース**がwebsiteに構成されている場合に必要なパラメータです。イベントに対応するブラウザのユーザーエージェントです。この値をハッシュ化しないでください。<ul><li>**EventStream** - **アクションソース**がwebsiteに構成され、このフィールドがマッピングされていない場合、自動的にEventStreamのユーザーエージェント属性にマッピングされます。</li><li>**AudienceStream** - **アクションソース**がwebsiteに構成され、このフィールドがマッピングされていない場合、自動的に訪問の最後のユーザーエージェントにAudienceStreamでマッピングされます。</li></ul> **重要度: 高** |
| クライアントIPアドレス (`ip`)          |   イベントに対応するブラウザのIPアドレスです。TealiumはクライアントIPアドレスをキャプチャすることができますが、デフォルトでは利用できません。詳細は、[サーバーサイドTealium製品でのIPアドレス収集の有効化](https://support.tealiumiq.com/en/support/solutions/articles/36000363403-enabling-ip-address-collection-in-server-side-tealium-products)を参照してください。この値をハッシュ化しないでください。**重要度: 高**    |
| 電話 (`ph`)   | 電話番号です。国コード、エリアコード、番号のみの数字を含めてください。このパラメータは文字列または文字列の配列を受け入れます。例えば、`16505551212`または`["16505551212", "16505551213"]`。**重要度: 高**    |
| 州 (`st`)  |  米国の州の略称です。このパラメータは文字列または文字列の配列を受け入れます。例えば、`ca`または`["ca", "tx"]`。**重要度: 中**   |
| メール (`em`)| メールアドレスです。このパラメータは文字列または文字列の配列を受け入れます。例えば、`user@example.com`または`["user@example.com", "user2@example.com"]`。**重要度: 最高**    |
| 姓 (`ln`) |  姓を小文字で入力します。このパラメータは文字列または文字列の配列を受け入れます。例えば、`smith`または`["smith", "jones"]`。**重要度: 中**   |
| 名 (`fn`)  |  名を小文字で入力します。このパラメータは文字列または文字列の配列を受け入れます。例えば、`joe`または`["joe", "jane"]`。**重要度: 中**   |
| リードID | Facebook [リード広告](https://developers.facebook.com/docs/marketing-api/guides/lead-ads)によって生成されたリードに関連するIDです。この値をハッシュ化しないでください。  |
| 市 (`ct`)  |  市を小文字で、スペースや句読点なしで入力します。このパラメータは文字列または文字列の配列を受け入れます。例えば、`menlopark`または`["menlopark", "sandiego"]`。**重要度: 中** |
| 国 (`country`)  | 二文字の国コードを小文字で入力します。このパラメータは文字列または文字列の配列を受け入れます。例えば、`us`または`["us", "ca"]`。**重要度: 中**   |
| 外部ID  |  広告主からの任意の一意のID、例えばロイヤルティ会員ID、ユーザーID、外部クッキーIDなどです。複数のIDを追加するために配列タイプの属性をマッピングします。このマッピングは自動的にTealium訪問IDで自動的に構成されますが、自動マッピングが無効にされている場合は除きます。  |

| ブラウザID (`fpb`) | Facebookの`_fbp`クッキーに保存されているブラウザID値。このパラメーターは自動的にマッピングされますが、自動マッピングを無効にすることもできます。この値をハッシュ化しないでください。**重要度：高** |
| サブスクリプションID | この取引におけるユーザーのサブスクリプションID。個々の製品の注文IDに似ています。この値をハッシュ化しないでください。例：`anid1234`。 |
| 性別 | 性別のための小文字の単一文字値。このパラメーターは文字列または文字列の配列を受け入れます。例：`["<first value>", "<second value>"]`。オプションは以下の通りです：<ul><li>`f` 女性用</li><li>`m` 男性用</li></ul> |
| 生年月日 | 年、月、日として与えられる生年月日。このパラメーターは文字列または文字列の配列を受け入れます。例：`19971226`（1997年12月26日）または`["19971226", "19971227"]`。 |
| クリックID (`fbc`) | Facebookの`_fbc`クッキーに保存されているFacebookクリックID値。このパラメーターは自動的にマッピングされますが、自動マッピングが無効にされている場合は除きます。この値をハッシュ化しないでください。Facebookは`fbclid`クッキーの保存と永続化を推奨しています。**重要度：高** |
| ユーザーデータは既にハッシュ化されています | Webイベントの場合、Facebook ConversionsコネクタはFacebook Pixelタグを使用し、自動的にユーザーデータをハッシュ化します。このピクセル機能は変更できません。データを再度ハッシュ化することを避けるためにこのオプションを選択してください。ただし、Tealium Collectなどの他のソースからハッシュ化されていないデータが来る場合は、このオプションを選択しないでください。 |
| 通貨 | 適用される場合の指定された値の通貨。通貨は有効なISO 4217の3桁の通貨コードでなければなりません。イベントに表示されるとき、コネクタは自動的にこのパラメーターをマッピングします。例：`usd`。 |
| コンテンツ名 | イベントに関連するページまたは製品の名前。コネクタはイベントに表示されるとき、自動的にこのパラメーターをマッピングします。例：`lettuce`。|
| アイテム数 | **InitiateCheckout**イベントでのみ使用します。チェックアウト中にユーザーが購入しようとするアイテムの数。例：`4`。 |
| 検索文字列 | ユーザーによって行われた検索クエリ。検索イベントでのみ使用します。例：**lettuce** |
| ステータス | **CompleteRegistration**イベントでのみ使用します。登録イベントのステータス。例：`registered`。 |
| 注文ID | この取引の注文ID。コネクタはイベントに表示されるとき、自動的にこのパラメーターをマッピングします。例：`order1234`。 |
| コンテンツタイプ | この値は`product`または`product_group`のいずれかでなければなりません。<ul><li>送信するキーが**Content IDs**または**Content Product**にある場合は`product`に構成します。**Content Product**は製品を表します。</li><li>送信するキーが**Content IDs**にある場合は`product_group`に構成します。**Content Product**は製品グループを表します。</li></ul> |
| 予測される生涯価値 | 変換イベントの予測される生涯価値。例：`432.12`。 |
| コンテンツID | イベントに関連するコンテンツID、例えばAddToCartイベントのアイテムの製品SKUなど。例：`['ABC123', 'XYZ789']`。非配列イベント属性が提供された場合、それは単一アイテム配列に変換されます。**コンテンツタイプ**が`product`の場合、このマッピングされた値は非配列イベント属性または単一要素配列でなければなりません。コネクタはイベントに表示されるとき、自動的にこのパラメーターをマッピングします。 |
| 値 | このイベントに関連する数値。これは金銭的価値または他の指標の値かもしれません。コネクタはイベントに表示されるとき、自動的にこのパラメーターをマッピングします。例：`142.54`。 |
| コンテンツカテゴリ | イベントに関連するコンテンツのカテゴリ。コネクタはイベントに表示されるとき、自動的にこのパラメーターをマッピングします。例：`grocery`。 |
| 数量 | 製品の数量。コネクタはイベントに表示されるとき、自動的にこのパラメーターをマッピングします。 |
| 価格 | 製品の個々の価格。コネクタはイベントに表示されるとき、自動的にこのパラメーターをマッピングします。 |
| ID | 製品ID。コネクタはイベントに表示されるとき、自動的にこのパラメーターをマッピングします。 |
| JSONテンプレート変数 | テンプレートにデータ入力としてテンプレート変数を提供します。詳細については、[connector-template-variables](https://docs.tealium.com/connector-template-variables/)を参照してください。ドット表記でネストされたテンプレート変数に名前を付けます。例：`items.name`。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。 |
| JSONテンプレート | Custom Dataセクションで参照される有効なJSONテンプレートを提供します。テンプレートは名前で二重中括弧でサポートされるフィールドに注入されます。例：`{{SomeTemplateName}}`。詳細については、[about-connector-templates](https://docs.tealium.com/about-connector-templates/)を参照してください。 |
| Tealium iQタグID | Facebook PixelタグUID。 |
| 自動マッピングを無効にする | パラメーターの自動マッピングを無効にします。 |
| 自動重複排除 | Tealium iQタグIDを提供すると、コネクタは自動的にTealium iQが送信する**イベント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`）またはディープリンク（App Aggregated Event Manager用）に追加される暗号化された文字列および非ユーザーメタデータ。 |
| インストールリファラー | 現在Androidのみで利用可能なサードパーティのインストールリファラー。詳細については、[キャンペーン測定](https://developers.google.com/analytics/devguides/collection/android/v4/campaigns?fbclid=IwAR0vdnDVr5OsK-VRvhw5qCOwOwVSFbs-pqgU_MIrQwdLGtZzbWIjjT2ttnA)を参照してください。 |
| インストーラーパッケージ | Android SDK内部で使用されます。 |
| URLスキーム(配列) | iOSおよびAndroid SDK内部で使用されます。 |
| WindowsアトリビューションID | Windows 10用のアトリビューショントークン。 |
| Anon ID | あなたのインストールID。このフィールドはユニークなアプリケーションインストールインスタンスを表します。 |
| MADID | 通常はAndroidデバイスの広告IDまたはAppleデバイスの広告識別子(IDFA)であるモバイル広告ID。 |

### 高度な測定イベントの送信

このFacebookアクションは限定的に利用可能です。アクセスをリクエストするには、Facebook担当者に連絡してください。このアクションがFacebookアカウントで有効化されていない場合、"このAPIコールを行う機能がアプリケーションにはありません。"または"このピクセルはサーバーイベントの報告を許可されていません。"などのエラーが返されます。
#### イベントデータ

| パラメータ | 説明 |
| --- | --- |
| イベント名 | (必須) Facebookピクセルの標準イベント名。|
| イベント時間 | 実際のイベントが発生したときのUnixタイムスタンプ（秒）。マッピングされた日付属性を秒に変換し、イベント時間がない場合は自動的に入力されます。 |
| イベントソースURL | イベントが発生したブラウザのURL。**アクションソース**が`website`に構成されている場合は必須です。**アクションソース**が`website`に構成され、このフィールドがマッピングされていない場合、EventStreamでは`Current URL`属性に、AudienceStreamでは`Last Event URL`属性に自動マッピングされます。 |
| オプトアウト | このイベントを広告配信の最適化に使用しないことを示すフラグ。このイベントを属性のみで使用するには、これを`true`に構成します。 |
| イベントID | サーバーとブラウザの両方から送信された同じイベントの重複を排除するためにFacebookが使用するID。これがブラウザとサーバーから送信された一組のイベントに固有のIDであることを確認してください。 |
| デバッグレベル | イベントの`trace`レベルを構成します。受け入れられる値: `1`はエラー、`2`は情報、`3`はデバッグ。 |
| テストイベントコード | `test_event_code`パラメータとしてテストIDを送信して、テストイベントウィンドウにイベントアクティビティが表示されるようにします。`test_event_code`で送信されたイベントは削除されません。これらはイベントマネージャーに流れ込み、ターゲティングと広告測定の目的で使用されます。|
| ピクセル/データセットIDオーバーライド | 提供されていない場合は、コネクタ構成からのピクセルIDが使用されます。 |

#### ユーザーデータ

すべてのユーザーデータパラメータは文字列または文字列の配列を受け入れます。例: `["<first value>", "<second value>"]`。

| パラメータ | 説明 |
| --- | --- |
| メール | 未ハッシュの小文字またはSHA-256でハッシュ化されたもの。 |
| 名 | 名前を小文字で。 |
| 姓 | 姓を小文字で。 |
| 電話 | 国コードと市外局番を含む数字のみの電話番号。例: `16505554444`。 |
| 性別 | 未知の場合は空白のままにする、`f`または`m`の単一の小文字。 |
| 生年月日 | 年、月、日で与えられる生年月日。例: `19971226`は1997年12月26日。 |
| 市区町村 | スペースや句読点なしの小文字の市区町村。例: `menlopark`。 |
| 州または省 | 小文字の2文字の州コード。例: `ca`。 |
| 郵便番号 | 5桁の郵便番号。例: `94035`。 |
| 国 | 小文字の2文字の国コード。例: `us`。 |
| 高度な測定テーブル | 高度な測定APIのデータテーブル。 |

#### カスタムデータ

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

| パラメータ | 説明 |
| --- | --- |
| 値 | このイベントに関連する数値。これは金額またはその他の指標の値である可能性があります: `142.54`。コネクタはこのパラメータがイベントに表示されると自動的にマッピングします。|
| 通貨 | 指定された値の通貨。適用される場合、通貨は有効なISO 4217の3桁の通貨コードでなければなりません。例: `usd`。コネクタはこのパラメータがイベントに表示されると自動的にマッピングします。 |
| コンテンツ名 | イベントに関連するページまたは製品の名前。例: `lettuce`。コネクタはこのパラメータがイベントに表示されると自動的にマッピングします。 |
| コンテンツカテゴリ | イベントに関連するコンテンツのカテゴリ。例: `grocery`。コネクタはこのパラメータがイベントに表示されると自動的にマッピングします。 |
| コンテンツID | <ul><li>イベントに関連するコンテンツID、例えばAddToCartイベントのアイテムの製品SKUなど。例: `[ABC123, XYZ789]`。</li> <li>非配列イベント属性が提供された場合、単一アイテム配列に変換されます。</li> <li><b>コンテンツタイプ</b>が`product`の場合、このマッピングされた値は非配列イベント属性または単一要素配列でなければなりません。</li><li>コネクタはこのパラメータがイベントに表示されると自動的にマッピングします。</li></ul> |
| コンテンツタイプ | <ul><li>許可される値は`product`または`product_group`です。</li> <li>**コンテンツID**または**コンテンツ製品**で送信するキーが製品を表している場合は`product`に構成します。</li> <li>**コンテンツID**で送信するキーが製品グループを表している場合は`product_group`に構成します。</li></ul> |
| 注文ID | この取引の注文ID。例: `order1234`。コネクタはこのパラメータがイベントに表示されると自動的にマッピングします。 |
| 予測される生涯価値 | 変換イベントの予測される生涯価値。例: `432.12`。 |
| アイテム数 | `InitiateCheckout`イベントでのみ使用します。チェックアウト中にユーザーが購入しようとするアイテムの数。例: `4`。 |
| 検索文字列 | 検索イベントでのみ使用します。ユーザーによって行われた検索クエリ。例: `lettuce`。 |
| ステータス | `CompleteRegistration`イベントでのみ使用します。登録イベントのステータス。例: `registered`。|

#### コンテンツデータ

| パラメータ | 説明 |
| --- | --- |
| ID | 製品ID。コネクタはこのパラメータがイベントに表示されると自動的にマッピングします。 |
| 数量 | 製品の数量。コネクタはこのパラメータがイベントに表示されると自動的にマッピングします。|
| 価格 | 製品の個別価格。コネクタはこのパラメータがイベントに表示されると自動的にマッピングします。|

#### 自動重複排除

| パラメータ | 説明 |
| --- | --- |
| Tealium iQタグID | Tealium iQタグUIDが提供されると、TealiumはTealium iQから送信されたイベント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) > Campaign Measurement](https://developers.google.com/analytics/devguides/collection/android/v4/campaigns?fbclid=IwAR0vdnDVr5OsK-VRvhw5qCOwOwVSFbs-pqgU_MIrQwdLGtZzbWIjjT2ttnA)を参照してください。 |
| インストーラーパッケージ | Android SDK内部で使用されます。 |
| URLスキーム (配列) | iOSおよびAndroid SDK内部で使用されます。 |
| WindowsアトリビューションID | Windows 10用のアトリビューショントークン。 |

### CRM (CAPI) イベントの送信


#### バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。並列処理により、イベントが順不同でベンダーに到達する可能性があります。順序が重要な場合はイベントにシーケンス値を追加してください。詳細については、[バッチアクション](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

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

#### パラメータ

| パラメータ | 説明 |
| --- | --- |
| リードID | (必須) Facebookが生成した15または16桁の`leadgen_id`で、ダウンロードしたリードから取得します。この番号はリード生成ウェブフックの`leadgen_id`フィールドから取得され、`user_data`パラメータに含まれます。 |
| イベント名 | (必須) CRMで使用するリードステージをキャプチャします。`event_name`パラメータはCRMでの販売ファネルを通じてリードが移動することを示します。更新されるすべてのステージを送信してください、生のリードも含めて。 |
| イベント時間 | リードステージ更新イベントがCRMによって更新されたときのUnixタイムスタンプ（秒）。タイムスタンプはリード生成時間の後に発生する必要があります。そうでない場合、イベントは破棄される可能性があります。このフィールドがマッピングされていない場合、現在のタイムスタンプで初期化されます。 |
| テストイベントコード | **イベントマネージャー**の**テストイベント**機能を使用して、Facebookによってサーバーイベントが正しく受信されていることを確認します。ツールを見つけるには、**イベントマネージャー > データソース > あなたのピクセル > テストイベント**に移動します。 |
| リードイベントソース | イベントが発信されるCRMの名前です。 |

## 構成

FacebookとのTealiumサーバーサイドAPIパートナー統合を構成および管理するためのいくつかのオプションがあります。
* [**Facebookパートナー統合ギャラリー**](https://www.facebook.com/events_manager2/partner_integrations/tealium)  
![](https://docs.tealium.com/images/server-side-connectors/facebook-partner-integration-gallery.png)
* **パートナーを選択**ボタンを通じてピクセルの**構成**タブ：![](https://docs.tealium.com/images/server-side-connectors/choosepartner.png)
* ウェブシグナル構成フローとサーバーサイドAPIガイダンスカード：![](https://docs.tealium.com/images/server-side-connectors/setup.png)

## イベントの確認

イベントを送信した後、概要と詳細ビューでFacebookがそれらを受信したことを確認します：

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

![](https://docs.tealium.com/images/server-side-connectors/datasources.png)

### 概要タブ

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

![](https://docs.tealium.com/images/server-side-connectors/overview.png)

### 詳細タブ

**詳細**タブでは、正常に送信されたイベントの内訳を表示します。ドロップされたイベントは`サーバーイベント受信`列に表示されません。

![](https://docs.tealium.com/images/server-side-connectors/breakdown.png)


<blockquote>
イベントはサーバーから送信してから20分以内に確認できます。
</blockquote>


### 検証

イベント構造を検証するには、Facebookの[ペイロードヘルパー](https://developers.facebook.com/docs/marketing-api/server-side-api/payload-helper)をデータパラメータフィールドと共に使用します。このツールは、サーバーからFacebookにイベントを送信する際の構造を示します。問題のトラブルシューティングについては、Facebookの[サポート](https://developers.facebook.com/docs/marketing-api/server-side-api/support)ページを参照してください。

Conversions APIについての詳細は、Facebookの[Conversions APIの使用](https://developers.facebook.com/docs/marketing-api/conversions-api/using-the-api)を参照してください。