Facebook App Events コネクタ構成ガイド | サーバーサイドコネクター

API 情報

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

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

コネクタアクション

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

動作原理

この API を通じてアプリのインストールとアプリ内コンバージョンを報告し、データを Facebook Analytics に送り返します。Facebook SDK なしでモバイルデバイス上で使用します。詳細は Facebook App Events API のドキュメントを参照してください。

構成の構成

コネクタマーケットプレイスに移動して新しいコネクタを追加します。コネクタの追加方法については、コネクタ概要の記事を読んでください。

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

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

アクション構成 - パラメータとオプション

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

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

アクション - イベントを送信

パラメータ

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