Facebook App Events Connectorのセットアップガイド | サーバーサイドコネクタ

API情報

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

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

コネクタのアクション

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

動作原理

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

構成の構成

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

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

アプリケーションID
- Facebook for DevelopersのアプリダッシュボードにリストされているApp IDです。

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

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

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

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

パラメータ

パラメータ	説明
データ処理オプション	必須 Facebookが制限付きデータ使用でイベントを処理するために値をLDUにマップします。それ以外の場合は、イベントを制限付きデータ使用で処理しないことを指定するために`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` Facebookによる地理位置の取得をリクエストする場合は`0` 地理位置情報を使用する場合は、「クライアントIPアドレス」属性もマッピングする必要があります。
データ処理オプションの州	データ処理オプションがLDUにマップされている場合は必須。ユーザーイベントに関連する州コードをマップします。受け入れられるコード値：カリフォルニアの場合は`1000` Facebookによる地理位置の取得をリクエストする場合は`0` 地理位置情報を使用する場合は、「クライアント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、メール、Twitterなど。
`fb_search_string`	オプション。検索されたテキスト文字列。
`fb_success`	オプション。値は`1`（はい）または`0`（いいえ）です。
IDs	オプション。製品ID。配列の値は同じ長さである必要があり、Facebookに送信する際に順番にペアになります。
Quantities	オプション。製品の数量。配列の値は同じ長さである必要があり、Facebookに送信する際に順番にペアになります。
Email	オプション。メールアドレス。
First Name	オプション。名前。
Last Name	オプション。姓。
Phone	オプション。電話番号。
External ID	オプション。広告主からの任意の一意のID、例えばロイヤリティメンバーシップID、ユーザーID、外部クッキーIDなど。
Gender	オプション。オプションは、女性の場合は`f`、男性の場合は`m`です。不明の場合は空白のままにしてください。
Birthdate	オプション。誕生年、月、日の順番。
City	オプション。都市名。
State or Province	オプション。 2文字の州または県コード。
Zip or Postal Code	オプション。数字の郵便番号。
Country	オプション。小文字の2文字の国コード。
User Data is Already SHA256 Hashed	オプション。ユーザーデータがすでにSHA256ハッシュ化されている場合はチェックボックスをオンにします。