Facebookオーディエンスコネクタ構成ガイド

API情報

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

• API名：Facebook Graph API - Marketing API
• APIバージョン：v22.0
• APIエンドポイント：https://graph.facebook.com
• ドキュメント：FacebookマーケティングAPI

バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数：10000
• 最古のリクエストからの最大時間：10分
• リクエストの最大サイズ：1 MB

構成

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

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

• 認証タイプ：Facebookに接続するために使用する認証タイプを選択します。このオプションは、レガシーコネクタインターフェースでは利用できません。

  • SUAT（システムユーザー認証トークン）：（推奨）より安定した持続的な認証方法としてこのオプションを選択します。詳細については、Facebook: システムユーザーアクセストークンの取得を参照してください。
  • OAuth2：この接続は通常60日以内に期限切れになり、すべてのFacebook広告アクションに予測不可能な結果をもたらす可能性があります。問題を避けるために、期限切れになる前に接続を再認証する必要があります。このオプションを選択した場合、接続を確立をクリックしてFacebookで認証を行います。

  接続を確立ボタンをクリックする前に、使用している広告アカウントIDにリンクされているアカウントでFacebookにサインインしていることを確認してください。そうでない場合、生成されるトークンに問題が生じる可能性があります。

• 広告アカウントID：（必須）管理したいFacebookオーディエンスアカウントIDです。詳細については、Facebook: Facebook広告アカウントID番号の検索を参照してください。

このコネクタを使用してFacebookでカスタムオーディエンスを構築する前に、Facebookカスタムオーディエンス規約に同意する必要があります。

カスタムオーディエンスの作成

コネクタを通じてカスタムオーディエンスを作成する前に、Facebookサイトで最初のカスタムオーディエンスを作成し、規約に同意する必要があります。

カスタムオーディエンスを使用するには、最低20エントリを含む必要があります。オーディエンスが正常に作成された場合、ボタンの横に小さなチェックアイコンが表示されます。

カスタムオーディエンスの作成をクリックし、次の構成を構成します：

• 新しいカスタムオーディエンス名：（必須）カスタムオーディエンスの名前。
• 新しいカスタムオーディエンスの説明：カスタムオーディエンスの説明。
• 顧客ファイルソース：
  • USER_PROVIDED_ONLY：顧客から直接収集した広告主の情報を使用します。
  • PARTNER_PROVIDED_ONLY：代理店やデータプロバイダーなどのパートナーから直接提供された広告主の情報を使用します。
  • BOTH_USER_AND_PARTNER_PROVIDED：顧客から直接収集した広告主の情報と、代理店などのパートナーから提供された情報を使用します。
• オーディエンスタイプ：
  • VALUE_BASED_AUDIENCE：最高価値の顧客と同様の行動を共有する顧客を特定します。
  • CUSTOMER_FILE_AUDIENCE：（デフォルト）顧客ファイルの情報、例えばメールアドレス、電話番号、または他の識別子に基づいて顧客を特定します。

Facebookオーディエンスサイトでは、顧客リスト、ウェブサイトのトラフィック、またはアプリのアクティビティに基づいてオーディエンスを作成するオプションがあります。この例では、顧客リストに基づいてオーディエンスを作成します。

詳細については、Metaビジネスヘルプセンター: 顧客リストカスタムオーディエンスの作成を参照してください。

アクション

アクション名	AudienceStream	EventStream
カスタムオーディエンスへのユーザー追加	✓	✗
カスタムオーディエンスからのユーザー削除	✓	✗
すべてのカスタムオーディエンスからのユーザーのオプトアウト	✓	✗

カスタムオーディエンスへのユーザー追加

パラメータ

パラメータ	説明
カスタムオーディエンスへのユーザー追加	(必須) 対象のカスタムオーディエンスを選択します。 顧客ファイルから作成されたオーディエンスは表示されません。 このコネクタを使用してFacebookでカスタムオーディエンスを構築する前に、Facebookカスタムオーディエンス規約に同意する必要があります。
メールアドレス	メールアドレスに基づいてユーザーを特定します。
電話番号	電話番号に基づいてユーザーを特定します。国コード、エリアコード、番号のみの数字を含めます。例：16505551212。
FacebookユーザーID	Facebook IDに基づいてユーザーを特定します。 この識別タイプを使用する場合、FacebookユーザーID（UID）に対応する「FacebookアプリID」を提供する必要があります。
FacebookアプリID	「FacebookユーザーID」がユーザー識別子として使用される場合に必要です。 「FacebookユーザーID」を参照してください。
モバイル広告ID	アプリユーザーID、Appleの広告識別子（IDFA）、またはAndroidの広告IDを使用してユーザーをターゲットにします。
外部ID	ハッシュ化しないでください。 広告主のユニークID、例えばロイヤルティ会員ID、ユーザーID、外部クッキーIDなど。
郵便番号	郵便番号。 国によって形式が異なります。
市	ユーザーの市。 小文字。 句読点やスペースは含まない。
国	ユーザーの国。 2文字の国コード。 ISO 3166-1 Alpha-2形式。
米国の州	アメリカ合衆国のユーザー州。 小文字。 2文字のANSI省略コード。
名	ユーザーの名前。 小文字。 句読点や特殊文字は含まない。 UTF-8形式。
姓	ユーザーの姓。 小文字。 句読点や特殊文字は含まない。 UTF-8形式。
生年	ユーザーの生年。 YYYY形式。 1900年から現在の年までの値。 句読点や特殊文字は含まない。 UTF-8形式。
生日	ユーザーの生日。 DD形式。 01から31までの値。
生月	ユーザーの誕生月。 MM形式。 01から12までの値。
カスタムオーディエンスオーバーライド	(オプション) 必須セクションの値をオーバーライドするためにカスタムオーディエンスIDを提供します。このフィールドを使用して、AudienceStream変数でオーディエンスIDを入力することができます。
ユーザー識別子が既にハッシュ化されている	ターゲットユーザー識別子が既にハッシュ化されている場合、このオプションを選択します。FacebookではSHA256でハッシュ化された値のみがサポートされています。

カスタムオーディエンスからのユーザー削除

パラメータ

パラメータ	説明
削除対象のカスタムオーディエンス	(必須) 対象のカスタムオーディエンスを選択してください。 このコネクタを使用してFacebookでカスタムオーディエンスを構築する前に、Facebookカスタムオーディエンス利用規約に同意する必要があります。
メールアドレス	メールアドレスに基づいてユーザーを特定します。
電話番号	電話番号に基づいてユーザーを特定します。国コード、市外局番、番号のみを含めてください。例：16505551212。
FacebookユーザーID	Facebook IDに基づいてユーザーを特定します。 この識別タイプを使用する場合は、対応する「FacebookアプリID」を提供する必要があります。
FacebookアプリID	「FacebookユーザーID」がユーザー識別子として使用される場合に必要です。 「FacebookユーザーID」を参照してください。
モバイル広告ID	アプリユーザーID、Appleの広告識別子（IDFA）、またはAndroidの広告IDに基づいてユーザーをターゲットにします。
外部ID	ハッシュ化しないでください。 広告主からのユニークID、例えばロイヤルティ会員ID、ユーザーID、外部クッキーIDなど。
郵便番号	郵便番号。 国によって形式が異なります。
市区町村	ユーザーの市区町村。 小文字。 句読点やスペースは含まない。
国	ユーザーの国。 2文字の国コード。 ISO 3166-1 Alpha-2形式。
米国の州	アメリカ合衆国の州。 小文字。 2文字のANSI省略形コード。
名	ユーザーの名前。 小文字。 句読点や特殊文字は含まない。 UTF-8形式。
姓	ユーザーの姓。 小文字。 句読点や特殊文字は含まない。 UTF-8形式。
イニシャル	ユーザーのイニシャル。 小文字。 句読点や特殊文字は含まない。 UTF-8形式。
生年	ユーザーの生年。 YYYY形式。 1900年から現在の年までの値。
生日	ユーザーの生日。 DD形式。 01から31までの値。
生月	ユーザーの生月。 MM形式。 01から12までの値。
性別	ユーザーの性別。 Mは男性、Fは女性
ルックアライク値	CRMデータからシードカスタムオーディエンスを作成する際に各ユーザーに構成される任意の数値。 Facebookはこの値を使用して、オーディエンス内のどのユーザーがあなたにとって最も価値があるかを定量的に判断します。
カスタムオーディエンスの上書き	(オプション) 必須セクションの値を上書きするためにカスタムオーディエンスIDを提供します。このフィールドを使用すると、AudienceStreamの変数を使用してオーディエンスIDを入力できます。
ユーザー識別子が既にハッシュ化されている	ターゲットユーザー識別子が既にハッシュ化されている場合は、このオプションを選択します。FacebookではSHA256でハッシュ化された値のみがサポートされています。

すべてのカスタムオーディエンスからユーザーをオプトアウト

パラメータ

パラメータ	説明
メールアドレス	メールアドレスに基づいてユーザーを特定します。
電話番号	電話番号に基づいてユーザーを特定します。国コード、市外局番、番号のみを含めてください。例：16505551212。
FacebookユーザーID	Facebook IDに基づいてユーザーを特定します。 この識別タイプを使用する場合は、対応する「FacebookアプリID」を提供する必要があります。
FacebookアプリID	「FacebookユーザーID」がユーザー識別子として使用される場合に必要です。 「FacebookユーザーID」を参照してください。
モバイル広告ID	アプリユーザーID、Appleの広告識別子（IDFA）、またはAndroidの広告IDに基づいてユーザーをターゲットにします。
外部ID	ハッシュ化しないでください。 広告主からのユニークID、例えばロイヤルティ会員ID、ユーザーID、外部クッキーIDなど。
郵便番号	郵便番号。 国によって形式が異なります。
市区町村	ユーザーの市区町村。 小文字。 句読点やスペースは含まない。
国	ユーザーの国。 2文字の国コード。 ISO 3166-1 Alpha-2形式。
米国の州	アメリカ合衆国の州。 小文字。 2文字のANSI省略形コード。
生年	ユーザーの生年。 YYYY形式。 1900年から現在の年までの値。
生日	ユーザーの生日。 DD形式。 01から31までの値。
生月	ユーザーの生月。 MM形式。 01から12までの値。
ユーザー識別子が既にハッシュ化されている	ターゲットユーザー識別子が既にハッシュ化されている場合は、このオプションを選択します。FacebookではSHA256でハッシュ化された値のみがサポートされています。
姓	ユーザーの姓。 小文字。 句読点や特殊文字は含まない。 UTF-8形式。
イニシャル	ユーザーのイニシャル。 小文字。 句読点や特殊文字は含まない。 UTF-8形式。
性別	ユーザーの性別。 Mは男性、Fは女性
ルックアライク値	CRMデータからシードカスタムオーディエンスを作成する際に各ユーザーに構成される任意の数値。 Facebookはこの値を使用して、オーディエンス内のどのユーザーがあなたにとって最も価値があるかを定量的に判断します。

Facebookオーディエンスコネクタの使用

訪問IDの作成

Facebookオーディエンスコネクタは、少なくとも1つの訪問ID属性を必要とし、Facebookオーディエンスに渡すことができます。

訪問ID属性を構成するためのリソースを以下に示します：

• 訪問ID属性の構成
• FacebookマーケティングAPI

オーディエンスの定義

アカウントには複数の訪問ID属性が定義されている場合があります。この場合、訪問IDが割り当てられている訪問のみが含まれるオーディエンスを確実にするために、「既知の訪問」バッジを作成することが重要です。この属性を使用することで、Facebookに渡すことができる訪問IDが割り当てられている訪問のみがオーディエンスに含まれることが保証されます。未知の訪問をターゲットにすることはできません。

既知の訪問バッジを他の条件と組み合わせて、コネクタ用のオーディエンスを作成します。

このコネクタには、メール、電話、アプリ、またはユーザーIDなどの必須IDパラメータがあります。これらのIDの少なくとも1つが必要です。これらのIDをオーディエンスフィルターに含めることで、コネクタエラーを回避するのに役立ちます。

テスト

最も効果的なテスト方法は、トレースを実行してイベントが適切に処理されていることを確認し、Facebookダッシュボードを確認してカスタムオーディエンスが作成され、人が追加されていることを確認することです。

FAQ

なぜAudienceStreamのドロップダウンリストにオーディエンスが表示されないのですか？

Facebookに2,000を超えるオーディエンスがある場合、それらはすべてAudienceStreamコネクタのドロップダウンリストで選択可能ではありません。

Facebookですべてのオーディエンスを表示し、特定のオーディエンスの識別子を選択するための次の手順を使用してください：

1. Facebookオーディエンスアカウントにアクセス権を持つユーザーとしてFacebookにログインします。

2. https://www.facebook.com/adsmanager/audiencesにアクセスします。

3. 探しているオーディエンスを見つけて、オーディエンスIDをコピーします。

   オーディエンスIDが表示されない場合は、テーブル列ビューを変更してそれを含めることができます。

   

4. AudienceStreamに戻り、AudienceStreamコネクタのカスタム値としてオーディエンスIDを入力します。