Facebook オフラインコンバージョンコネクタ構成ガイド | サーバーサイドコネクタ

新しい統合には、Facebook オフラインコンバージョンコネクタの代わりに Facebook Conversions connector を推奨します。Facebook Conversions コネクタを通じてオフラインおよびストアイベントを処理するには、action_source パラメータを physical_store に構成します。詳細については、Facebook Conversions connector を参照してください。

API情報

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

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

コネクタアクション

アクション名	AudienceStream	EventStream
コンバージョンの送信	✓	✓

構成の構成

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

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

アクセストークン
- 必須。
- 広告アカウントとオフラインイベントセットにアクセスできるFacebookシステムユーザーのアクセストークン。
ビジネスマネージャーID
- 必須。
- この値は Facebook Business Manager > Business Settings > Business Info > Business Manager Info ページで見つけることができます。

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

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

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

アクション - コンバージョンの送信

パラメータ

パラメータ	説明
オフラインイベントセット	必須。コンバージョンを送信するオフラインイベントセットを選択します。作成タブで新しいオフラインイベントセットを作成するか、Facebook Event Managerを通じて作成できます。 Facebook オフラインコンバージョンのドキュメンテーションの詳細を参照してください。
クライアントIPアドレス	データ処理オプションがLDUにマッピングされ、ジオロケーションが要求される場合は必須。
コンテンツID	オフラインイベントセットの各トランザクションまたは注文の一意の識別子またはレシート。例：`ATN10001`
コンテンツタイプ	ダイナミック広告に必須。有効なダイナミック広告のコンテンツタイプ。例：`product`
通貨	“Purchase"イベントに必須。 3文字のISO通貨コード
データ処理オプション	必須 Facebookがイベントを限定データ使用制限で処理するようにLDUに値をマップします。それ以外の場合は、イベントが限定データ使用制限で処理されないように`None`をマップします。詳細については、Facebook Data Processing Optionsを参照してください。
データ処理オプション国	データ処理オプションがLDUにマッピングされている場合は必須。ユーザーイベントに関連する国コードをマップします。受け入れられるコード値： `1`はアメリカ合衆国 `0`はFacebookによる国のジオロケーションを要求するジオロケーションには、“クライアントIPアドレス"属性のマッピングも必要です。
データ処理オプション州	データ処理オプションがLDUにマッピングされている場合は必須。ユーザーイベントに関連する州コードをマップします。受け入れられるコード値： `1000`はカリフォルニア `0`はFacebookによる州のジオロケーションを要求する。ジオロケーションには、“クライアントIPアドレス"属性のマッピングも必要です。
イベント名	必須。文字列。標準的なFacebook Pixelイベントのうちの1つ。
イベント時間	必須 Unixタイムスタンプ、秒単位。
アイテム番号	同じ注文またはトランザクションのイベントを区別するための一意の識別子、例えば`1`または`a`。
ネームスペースID	サードパーティのユーザーIDまたはリードIDを解決するための数値スコープ。マッチキーを参照してください。
注文ID	オフラインイベントセットの各トランザクションまたは注文の一意の識別子またはレシート。例：`ATN10001`
アップロードタグ	必須。イベントアップロードを追跡するための文字列。例：`monthly`または`in-store uploads`
値	“Purchase"イベントに必須。コンバージョンイベントの金額。
市区町村	小文字。句読点やスペースは含まない。
国	ISO 3166-1 alpha-2形式の2文字の国コード。
生年月日の日	`01`から`31`までの`DD`。
メールアドレス	ユーザーをそのメールアドレスに基づいて識別します。アドレスは小文字に変換されます。
名の頭文字	小文字。句読点や特殊文字は含まない。 UTF-8形式。
名	小文字。句読点や特殊文字は含まない。 UTF-8形式。
性別	値は： `m`は男性 `f`は女性大文字の値は小文字に変換されます。
姓	小文字。句読点や特殊文字は含まない。 UTF-8形式。
リード広告からのリードID	リードIDの値。
モバイル広告ID	Apple Advertising IDまたはAndroid Advertising IDのいずれかの値を指定して、モバイルユーザーをターゲットにします。
生年月日の月	`01`から`12`までの`MM`。
電話番号	ユーザーをその電話番号に基づいて識別します。国コード、地域コード、番号を含む数字のみを含めます。例えば、`16505551212`。
サードパーティユーザーID	外部システムのID
US州	2文字のANSI省略コード、小文字。
生年	`1900`から現在の年までの`YYYY`。
郵便番号	郵便番号。正確な形式は国によります。
このボックスをチェックすると、ターゲットユーザー識別データはすでにハッシュ化されている	ターゲットユーザー識別データがすでにハッシュ化されている場合はチェックします。
カスタムデータプロパティ	オプション Facebookによって指定されていないカスタムプロパティ
テンプレート変数	オプション。カスタムデータプロパティセクションでサポートされています。テンプレートのデータ入力としてテンプレート変数を提供します。詳細については、Template Variables Guideを参照してください。ドット表記法を使用してネストしたテンプレート変数を名付けます。例えば、items.name。ネストしたテンプレート変数は通常、データレイヤーリスト属性から作成されます。
テンプレート	オプションカスタムデータプロパティセクションで参照される有効なJSONテンプレートを提供しますテンプレートは、`{{SomeTemplateName}}`のように、二重中括弧で囲まれた名前でサポートされるフィールドに注入されます。詳細については、Templates Guideを参照してください。