---
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タグの値や他の事前にハッシュ化された値を変換する場合は、それらを二重にハッシュ化しないように、`Already SHA256 Hashed`バリアントのパラメータにマッピングしてください。
</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`に構成して有効にします。
## ユーザーデータのハッシュ化

ハッシュ可能な識別子フィールドには、次の2つのマッピングターゲットがあります：

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

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

## アクション

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

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

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

### イベント送信


#### パラメータ

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


<blockquote>
このアクションをフィールドごとのハッシュ化パラメータが導入される前に構成した場合、アクションは自動的に移行されます。**ユーザーデータは既にハッシュ化されている** が有効になっていたアクションは、対応する `Already SHA256 Hashed` パラメータに移行されます。その他のアクションは `Apply SHA256 Hash` パラメータに移行されます。移行後もアウトバウンドペイロードは変更されません。
</blockquote>


| パラメータ   | 説明                              |
|:----------------|:---------------------------------------------|
| イベントソース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>データのハッシュ化を確認するためにTraceを使用する場合、Traceの最上部に表示されるデータ（例：`user_data - EMAIL`）はコネクタに入ってきたデータであり、Facebookに送信されたデータではありません。Facebookに送信されたデータはTraceの**リクエストボディセクション**に表示されます。 |
| アクションソース |(必須) あなたのコンバージョンが発生した場所を指定するフィールドです。有効なアクションソースは以下の通りです：<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をオーバーライドするためにこの文字列を使用します。提供されていない場合、コネクタ構成のデータセット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です。このパラメータは [App-Scoped 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 に構成され、このフィールドがマッピングされていない場合、自動的に訪問の最後のユーザーエージェントにマッピングされます。</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) を参照してください。この値はハッシュ化しないでください。**重要度: 高**    |
| Email Apply SHA256 Hash | 平文のメールアドレスです。コネクタはこの値を正規化し、ハッシュ化してから送信します。このパラメータは文字列または文字列の配列を受け入れます。例えば、`user@example.com` または `["user@example.com", "user2@example.com"]`。**重要度: 最高** |
| Email Already SHA256 Hashed | 既に正規化され、SHA-256でハッシュ化されたメールアドレスです。コネクタはこの値を変更せずに転送します。このパラメータは文字列または文字列の配列を受け入れます。**重要度: 最高** |
| Phone Apply SHA256 Hash | 平文の電話番号です。国コード、市外局番、番号のみを含めます。コネクタはこの値を正規化し、ハッシュ化してから送信します。このパラメータは文字列または文字列の配列を受け入れます。例えば、`16505551212` または `["16505551212", "16505551213"]`。**重要度: 高** |
| Phone Already SHA256 Hashed | 既に正規化され、SHA-256でハッシュ化された電話番号です。コネクタはこの値を変更せずに転送します。このパラメータは文字列または文字列の配列を受け入れます。**重要度: 高** |
| First Name Apply SHA256 Hash | 小文字の平文の名前です。コネクタはこの値を正規化し、ハッシュ化してから送信します。このパラメータは文字列または文字列の配列を受け入れます。例えば、`joe` または `["joe", "jane"]`。**重要度: 中** |
| First Name Already SHA256 Hashed | 既に正規化され、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ハッシュ適用 | 二文字の国コードを小文字のプレーンテキストで入力します。コネクタはこの値を正規化してハッシュ化してから送信します。このパラメータは文字列または文字列の配列を受け付けます。例：`us`または`["us", "ca"]`。**重要度：中** |
| 国SHA256ハッシュ済み | すでに正規化およびSHA-256でハッシュ化された国コード。コネクタはこの値を変更せずに転送します。このパラメータは文字列または文字列の配列を受け付けます。**重要度：中** |
| 生年月日SHA256ハッシュ適用 | 年、月、日で与えられる生年月日をプレーンテキストで入力します。コネクタはこの値を正規化してハッシュ化してから送信します。このパラメータは文字列または文字列の配列を受け付けます。例：`19971226`（1997年12月26日）。 |
| 生年月日SHA256ハッシュ済み | すでに正規化およびSHA-256でハッシュ化された生年月日。コネクタはこの値を変更せずに転送します。このパラメータは文字列または文字列の配列を受け付けます。 |
| 性別SHA256ハッシュ適用 | 性別を小文字の単一文字値（`f`または`m`）でプレーンテキストで入力します。コネクタはこの値を正規化してハッシュ化してから送信します。このパラメータは文字列または文字列の配列を受け付けます。 |
| 性別SHA256ハッシュ済み | すでに正規化およびSHA-256でハッシュ化された性別。コネクタはこの値を変更せずに転送します。このパラメータは文字列または文字列の配列を受け付けます。 |
| 外部IDSHA256ハッシュ適用 | 広告主からのユニークID（ロイヤリティ会員ID、ユーザーID、外部クッキーIDなど）をプレーンテキストで入力します。コネクタはこの値を正規化してハッシュ化してから送信します。複数のIDを追加するために配列型属性をマップします。 |
| 外部IDSHA256ハッシュ済み | すでに正規化およびSHA-256でハッシュ化された広告主からのユニークID。コネクタはこの値を変更せずに転送します。複数のIDを追加するために配列型属性をマップします。 |
| リードID | Facebook [Lead Ads](https://developers.facebook.com/docs/marketing-api/guides/lead-ads)によって生成されたリードに関連付けられたID。この値をハッシュ化しないでください。 |
| ブラウザID (`fpb`) | Facebookの`_fbp`クッキーに保存されているブラウザID値。識別子の自動マッピングを無効にしない限り、このパラメータは自動的にマッピングされます。この値をハッシュ化しないでください。**重要度：高** |
| クリックID (`fbc`) | Facebookの`_fbc`クッキーに保存されているFacebookクリックID値。識別子の自動マッピングを無効にしない限り、このパラメータは自動的にマッピングされます。この値をハッシュ化しないでください。Facebookは`fbclid`クッキーの保存と永続化を推奨します。**重要度：高** |
| サブスクリプションID | この取引におけるユーザーのサブスクリプションID。個々の製品に対する注文IDに似ています。この値をハッシュ化しないでください。例：`anid1234`。 |
| 通貨 | 適用可能な場合、指定された値の通貨。通貨は有効な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']`。非配列イベント属性が提供された場合、単一アイテム配列に変換されます。**Content Type**が`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 | あなたのモバイル広告ID。通常はAndroidデバイスの広告IDまたはAppleデバイスの広告識別子（IDFA）です。 |

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

この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`で送信されたイベントは削除されません。これらはイベントマネージャーに流れ込み、ターゲティングおよび広告測定の目的で使用されます。|
| Pixel/Dataset IDオーバーライド | 提供されていない場合、コネクタ構成からのPixel IDが使用されます。 |

#### ユーザーデータ

すべてのユーザーデータパラメータは文字列または文字列の配列を受け入れます。


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


| パラメータ | 説明 |
| --- | --- |
| Email Apply SHA256 Hash | 小文字のプレーンテキストのメールアドレス。コネクタはこの値を正規化してハッシュ化してから送信します。 |
| Email Already SHA256 Hashed | すでに正規化およびSHA-256ハッシュ化されたメールアドレス。コネクタはこの値を変更せずに転送します。 |
| Phone Apply SHA256 Hash | プレーンテキストの電話番号。国コードとエリアコードを含む数字のみ。例：`16505554444`。コネクタはこの値を正規化してハッシュ化してから送信します。 |
| Phone Already SHA256 Hashed | すでに正規化およびSHA-256ハッシュ化された電話番号。コネクタはこの値を変更せずに転送します。 |
| First Name Apply SHA256 Hash | 小文字のプレーンテキストの名前。コネクタはこの値を正規化してハッシュ化してから送信します。 |
| First Name Already SHA256 Hashed | すでに正規化およびSHA-256ハッシュ化された名前。コネクタはこの値を変更せずに転送します。 |
| Last Name Apply SHA256 Hash | 小文字のプレーンテキストの姓。コネクタはこの値を正規化してハッシュ化してから送信します。 |
| Last Name Already SHA256 Hashed | すでに正規化およびSHA-256ハッシュ化された姓。コネクタはこの値を変更せずに転送します。 |
| City Apply SHA256 Hash | 空白や句読点のない小文字のプレーンテキストの市区町村名。例：`menlopark`。コネクタはこの値を正規化してハッシュ化してから送信します。 |
| City Already SHA256 Hashed | すでに正規化およびSHA-256ハッシュ化された市区町村名。コネクタはこの値を変更せずに転送します。 |
| State or Province Apply SHA256 Hash | 小文字のプレーンテキストの2文字の州コード。例：`ca`。コネクタはこの値を正規化してハッシュ化してから送信します。 |
| State or Province Already SHA256 Hashed | すでに正規化およびSHA-256ハッシュ化された州または県。コネクタはこの値を変更せずに転送します。 |
| Zip or Postal Code Apply SHA256 Hash | プレーンテキストの郵便番号。例：`94035`。コネクタはこの値を正規化してハッシュ化してから送信します。 |
| Zip or Postal Code Already SHA256 Hashed | すでに正規化およびSHA-256ハッシュ化された郵便番号。コネクタはこの値を変更せずに転送します。 |
| Country Apply SHA256 Hash | 小文字のプレーンテキストの2文字の国コード。例：`us`。コネクタはこの値を正規化してハッシュ化してから送信します。 |
| Country Already SHA256 Hashed | すでに正規化およびSHA-256ハッシュ化された国コード。コネクタはこの値を変更せずに転送します。 |
| Date of Birth Apply SHA256 Hash | 年、月、日で与えられたプレーンテキストの生年月日。例：`19971226`（1997年12月26日）。コネクタはこの値を正規化してハッシュ化してから送信します。 |
| Date of Birth Already SHA256 Hashed | すでに正規化およびSHA-256ハッシュ化された生年月日。コネクタはこの値を変更せずに転送します。 |
| Gender Apply SHA256 Hash | 小文字の単一文字値（`f`または`m`）のプレーンテキストの性別。コネクタはこの値を正規化してハッシュ化してから送信します。 |
| Gender Already SHA256 Hashed | すでに正規化およびSHA-256ハッシュ化された性別。コネクタはこの値を変更せずに転送します。 |
| 高度な測定テーブル | 高度な測定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は自動的にあなたのイベント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. **ビジネスマネージャー** &gt; **ピクセル**に移動します。
1. `PIXEL_ID`があなたの`POST`リクエストに対応するピクセルをクリックします。

![](https://docs.tealium.com/images/server-side-connectors/datasources.png)
### 概要タブ

**概要**タブで、表示を**すべて**から**サーバー**に変更すると、正常に送信されたイベントの数が表示されます。

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

### 内訳タブ

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

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


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


### 検証

イベント構造を検証するには、データパラメータフィールドを使用してFacebookの[Payload Helper](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)を参照してください。