Facebook App Events コネクタ構成ガイド

API情報

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

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

動作原理

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

構成

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

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

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

アクション

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

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

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

イベントを送信

パラメータ

パラメータ	説明
データ処理オプション	（必須）LDUにマップする値を指定し、Facebookが限定データ使用制限でイベントを処理するようにします。それ以外の場合は、`None`をマップしてイベントが限定データ使用制限なしで処理されるように指定します。詳細については、Facebookデータ処理オプションを参照してください。
広告主ID	（必須）Apple IDFAまたはGoogle広告ID。
広告主トラッキング有効	（必須）オプションは`0`が無効、`1`が有効です。
アプリトラッキング有効	（必須）オプションは`0`が無効、`1`が有効です。
アトリビューション	（必須）デバイスのモバイルクッキー。 AndroidおよびiOS 6以前のデバイスに適用されます。その他のデバイスでは`advertiser_id`を使用します。
クライアントIPアドレス	（必須）IPv4またはIPv6形式のデバイスのIPアドレス。
イベント	（必須）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でハッシュ化されている場合はチェックを入れてください。