---
title: Facebookアプリイベントコネクタ構成ガイド
description: この記事では、Facebookアプリイベントコネクタの構成方法について説明します。
url: https://docs.tealium.com/ja/server-side-connectors/facebook-app-events-connector/
---
## API情報

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

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

## 動作原理

このAPIを通じてアプリのインストールとアプリ内コンバージョンを報告し、データをFacebook Analyticsに送信します。Facebook SDKを使用せずにモバイルデバイスでこれを使用します。詳細については、[FacebookアプリイベントAPI](https://developers.facebook.com/docs/marketing-api/app-event-api#install_parameters)のドキュメントを参照してください。

## 構成

コネクタマーケットプレイスにアクセスして新しいコネクタを追加します。コネクタの追加方法については、[コネクタ概要](https://docs.tealium.com/about-connectors/)の記事を読んでください。

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

* **アプリケーションID**：Facebook for Developersのアプリダッシュボードに記載されているアプリID。

## アクション

| アクション名      | AudienceStream | EventStream|
|:----------------|:-------------------|:----------------|
| イベントを送信      | ✓                  | ✓               |

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

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

### イベントを送信


#### パラメータ

| パラメータ                      | 説明                                                                                                                                                                                                                                                                                                                                                                              |
|:-----------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| データ処理オプション            | <ul><li>(必須) LDUにマップされた値を指定して、Facebookが限定データ使用制限でイベントを処理するようにします。</li><li>それ以外の場合は、イベントを限定データ使用制限で処理しないことを指定するために`None`をマップします。</li><li>詳細については、[Facebookデータ処理オプション](https://developers.facebook.com/docs/marketing-apis/data-processing-options)を参照してください。</li></ul> |
| 広告主ID                      | <ul><li>(必須) Apple IDFAまたはGoogle広告ID。</li></ul>                                                                                                                                                                                                                                                                                                                     |
| 広告主トラッキング有効        | <ul><li>(必須) オプションは`0`が無効、`1`が有効です。</li></ul>                                                                                                                                                                                                                                                                                                           |
| アプリトラッキング有効               | <ul><li>(必須) オプションは`0`が無効、`1`が有効です。</li></ul>                                                                                                                                                                                                                                                                                                           |
| アトリビューション                        | <ul><li>(必須) デバイスのモバイルクッキー。</li><li>AndroidおよびiOS 6以前のデバイスに適用されます。</li><li>他のデバイスでは`advertiser_id`を使用します。</li></ul>                                                                                                                                                                                                                           |
| クライアントIPアドレス                  | <ul><li>(必須) IPv4またはIPv6形式のデバイスのIPアドレス。</li></ul>                                                                                                                                                                                                                                                                                                              |
| イベント                              | <ul><li>(必須) App Events APIを通じて送信されるイベントのタイプ。</li></ul>                                                                                                                                                                                                                                                                                                         |
| アプリユーザーID                        | <ul><li>(任意) ユーザーのデバイスに保存されている100文字以内の英数字のユニークな組み合わせ。</li></ul>                                                                                                                                                                                                                                           |
| バンドルID                          | <ul><li>(任意) システムにアプリケーションを識別するためのユニークな文字列。</li></ul>                                                                                                                                                                                                                                                                                          |
| バンドル短縮バージョン               | <ul><li>(任意) アプリの公開されているバージョン。</li></ul>                                                                                                                                                                                                                                                                                                                |
| バンドルバージョン                     | <ul><li>(任意) アプリの内部バージョン番号。</li></ul>                                                                                                                                                                                                                                                                                                                 |
| データ処理オプション国    | <ul><li>データ処理オプションがLDUにマップされている場合は必須。</li><li>ユーザーイベントに関連する国コードをマップします。</li><li>受け入れられるコード値:  <ul><li>`1`はアメリカ合衆国</li><li>`0`は国をFacebookによるジオロケーションを要求</li></ul> </li><li>ジオロケーションは「クライアントIPアドレス」属性のマッピングも必要です。</li></ul>                                 |
| データ処理オプション州      | <ul><li>データ処理オプションがLDUにマップされている場合は必須。</li><li>ユーザーイベントに関連する州コードをマップします。</li><li>受け入れられるコード値: <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></li><li>ジオロケーション（`0`）は「クライアントIPアドレス」属性のマッピングが必要です。</li><li>クライアントIPアドレスが利用できないオフラインイベントの場合は、明示的な州コード(`1000`–`1013`)を使用します。</li></ul>                                              |
| アプリパッケージ名                   | <ul><li>(必須) アプリパッケージ名の文字列。</li></ul>                                                                                                                                                                                                                                                                                                                         |
| 利用可能な保存サイズ             | <ul><li>(必須) 利用可能な外部保存スペースの整数値、GB単位。</li></ul>                                                                                                                                                                                                                                                                                           |
| キャリア名                       | <ul><li>(必須) キャリア名の文字列。</li><li>キャリア名が利用できない場合は`NoCarrier`を使用します。</li></ul>                                                                                                                                                                                                                                                              |
| CPUコア                            | <ul><li>(必須) CPUコアの数を示す整数。</li></ul>                                                                                                                                                                                                                                                                                                                     |
| デバイスのロケール                  | <ul><li>(必須) ロケール言語を表す2文字の小文字と、アンダースコア (`_`)、国コードを表す2文字の大文字で構成される文字列。</li></ul>                                                                                                                                                                                                                             |
| デバイスモデル名                    | <ul><li>(必須) デバイスのモデル名を示す文字列。</li></ul>                                                                                                                                                                                                                                                                                                            |
| デバイスのタイムゾーン              | <ul><li>(必須) デバイスのタイムゾーンを示す文字列。</li></ul>                                                                                                                                                                                                                                                                                                        |
| デバイスのタイムゾーン略称          | <ul><li>(必須) デバイスのタイムゾーン略称を示す文字列。</li></ul>                                                                                                                                                                                                                                                                                                    |
| 外部保存サイズ                | <ul><li>(必須) 外部保存の合計サイズをGBで示す整数。</li></ul>                                                                                                                                                                                                                                                                                                  |
| OSバージョン                       | <ul><li>(必須) オペレーティングシステムのバージョンを示す文字列。</li></ul>                                                                                                                                                                                                                                                                                         |
| Pkg Infoバージョンコード            | <ul><li>(必須) PackageInfoのバージョンコードを示す整数。</li></ul>                                                                                                                                                                                                                                                                                                  |
| Pkg Infoバージョン名                | <ul><li>(必須) PackageInfoのバージョン名を示す文字列。</li></ul>                                                                                                                                                                                                                                                                                                    |
| 画面密度                           | <ul><li>(必須) 画面密度を `%.2f` 形式の浮動小数点数で示す。</li><li>小数点はドットでなければならない。</li></ul>                                                                                                                                                                                                                                                  |
| 画面の高さ                         | <ul><li>(必須) 画面の高さをピクセルで示す整数。</li></ul>                                                                                                                                                                                                                                                                                                           |
| 画面の幅                           | <ul><li>(必須) 画面の幅をピクセルで示す整数。</li></ul>                                                                                                                                                                                                                                                                                                            |
| 拡張情報フォーマット               | <ul><li>(オプション) 拡張情報のフォーマットバージョンとソースインジケータ。</li><li>デフォルト値は `a2`。</li></ul>                                                                                                                                                                                                                                               |
| イベント名                         | <ul><li>ドロップダウンリストからイベントを選択するか、新しいイベントを作成する。</li></ul>                                                                                                                                                                                                                                                                             |
| `_logTime`                         | <ul><li>(オプション) イベントの時間をUnix時間で指定する推奨パラメータ。</li></ul>                                                                                                                                                                                                                                                                                     |
| `_valueToSum`                      | <ul><li>(オプション) 報告で合計される個々のイベントの数値値。</li><li>上記の推奨イベントに添付することを参照。</li></ul>                                                                                                                                                                                                                                             |
| `fb_content_id`                    | <ul><li>(オプション) 適用可能な場合は国際記事番号(EAN)、または他の製品またはコンテンツ識別子。</li></ul>                                                                                                                                                                                                                                                             |
| `fb_content_type`                  | <ul><li>(オプション) 例えば、音楽、ビデオ、または製品説明など。</li></ul>                                                                                                                                                                                                                                                                                           |
| `fb_currency`                      | <ul><li>(オプション) ISO 4217コード。</li><li>例: `EUR`, `USD`, `JPY`。</li><li>`_valueToSum`を価格または購入額として渡す場合は必須。</li></ul>                                                                                                                                                                                                                       |
| `fb_description`                   | <ul><li>(オプショナル) 文字列の説明。</li></ul>                                                                                                                                                                                                                                                                                                                                    |
| `fb_level`                         | <ul><li>(オプショナル) ゲームのレベル。</li></ul>                                                                                                                                                                                                                                                                                                                                         |
| `fb_max_rating_value`              | <ul><li>(オプショナル) 評価スケールの上限。</li><li>例：5つ星スケールの`5`。</li></ul>                                                                                                                                                                                                                                                                                  |
| `fb_num_items`                     | <ul><li>(オプショナル) アイテムの数。</li></ul>                                                                                                                                                                                                                                                                                                                                         |
| `fb_payment_info_available`        | <ul><li>(オプショナル) 値は `1` がはい、`0` がいいえ。</li></ul>                                                                                                                                                                                                                                                                                                                      |
| `fb_registration_method`           | <ul><li>(オプショナル) Facebook、Email、X など。</li></ul>                                                                                                                                                                                                                                                                                                                           |
| `fb_search_string`                 | <ul><li>(オプショナル) 検索されたテキスト文字列。</li></ul>                                                                                                                                                                                                                                                                                                                   |
| `fb_success`                       | <ul><li>(オプショナル) 値は `1` がはい、`0` がいいえ。</li></ul>                                                                                                                                                                                                                                                                                                                      |
| IDs                                | <ul><li>(オプショナル) 製品ID。</li><li>同じ長さの配列値のみ、Facebookに送信される際に順番にペアになります。</li></ul>                                                                                                                                                                                                                                               |
| Quantities                         | <ul><li>(オプショナル) 製品の数量。</li><li>同じ長さの配列値のみ、Facebookに送信される際に順番にペアになります。</li></ul>                                                                                                                                                                                                                                        |
| Email                              | <ul><li>(オプショナル) メールアドレス。</li></ul>                                                                                                                                                                                                                                                                                                                                           |
| First Name                         | <ul><li>(オプショナル) 名前。</li></ul>                                                                                                                                                                                                                                                                                                                                              |
| Last Name                          | <ul><li>(オプショナル) 姓。</li></ul>                                                                                                                                                                                                                                                                                                                                               |
| Phone                              | <ul><li>(オプショナル) 電話番号。</li><li>国コード、地域コード、番号のみの数字を含む。例えば、`16505551212`。</li></ul>                                                                                                                                                                                                                                                                                                                                            |
| External ID                        | <ul><li>(オプショナル) 広告主からの任意の一意のID、例えばロイヤルティ会員ID、ユーザーID、外部クッキーIDなど。</li></ul>                                                                                                                                                                                                                                                       |
| Gender                             | <ul><li>(オプショナル) オプションは `f` が女性、`m` が男性。</li><li>不明な場合は空白のままにする。</li></ul>                                                                                                                                                                                                                                                                               |
| Birthdate                          | <ul><li>(オプショナル) 生年月日。</li></ul>                                                                                                                                                                                                                                                                                                                            |
| City                               | <ul><li>(オプショナル) 市名。</li></ul>                                                                                                                                                                                                                                                                                                                                               |
| State or Province                  | <ul><li>(オプショナル) 州または省の2文字コード。</li></ul>                                                                                                                                                                                                                                                                                                                       |
| 郵便番号または郵便番号                 | <ul><li>(オプション) 数字の郵便番号または郵便番号。</li></ul>                                                                                                                                                                                                                                                                                                                              |
| 国                                  | <ul><li>(オプション) 小文字の2文字の国コード。</li></ul>                                                                                                                                                                                                                                                                                                                       |
| ユーザーデータは既にSHA256でハッシュ化されています | <ul><li>(オプション) ユーザーデータが既にSHA256でハッシュ化されている場合はチェックボックスをオンにします。</li></ul>                                                                                                                                                                                                                                                                                                         |