Facebookアプリイベントコネクタ構成ガイド | サーバーサイドコネクタ

API情報

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

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

コネクタアクション

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

動作方法

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

構成の構成

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

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

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

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

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

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

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

パラメータ

パラメータ	説明
データ処理オプション	必須 Facebookがイベントを限定データ使用制限で処理するようにLDUに値をマップします。それ以外の場合は、イベントが限定データ使用制限で処理されないように`None`をマップします。詳細情報については、Facebookデータ処理オプションを参照してください。
広告主ID	必須。 Apple IDFAまたはGoogle広告ID。
広告主トラッキング有効	必須。オプションは`0`は無効、`1`は有効。
アプリトラッキング有効	必須。オプションは`0`は無効、`1`は有効。
アトリビューション	必須。デバイスからのモバイルクッキー。 Androidとpre-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`が男性。不明な場合は空白にしてください。
生年月日	任意。生年、月、日の順。
市区町村	任意。市区町村の名前。
州または県	任意。州または県の二文字コード。
郵便番号または郵便コード	任意。数字の郵便番号または郵便コード。
国	任意。小文字の二文字国コード。
ユーザーデータはすでにSHA256でハッシュ化されている	任意。ユーザーデータがすでにSHA256でハッシュ化されている場合はチェックボックスをチェック。