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

API情報

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

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

バッチ制限

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

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

コネクタアクション

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

構成の構成

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

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

• 広告アカウントID
  • 必須
  • 管理したいFacebookオーディエンスアカウントID。(詳細を学ぶ。)
  • このコネクタを使用してFacebookでカスタムオーディエンスを構築する前に、Facebookカスタムオーディエンス規約に同意する必要があります。
  • この接続は通常60日以内に期限切れになり、すべてのFacebook広告アクションに予測不可能な結果をもたらす可能性があります。
  • いつでも接続の確立/接続済みをクリックして接続を再確立します。

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

Facebookオーディエンスコネクタに特有の構成

• FacebookアプリID（必須）
  接続したいFacebookアプリのID。

  • より多くのリソースやより良いレート制限を得るために広告管理標準アクセスをリクエストします。
    詳細については、次を参照してください：Facebook Marketing API: Access and Authentication。
  • 広告管理のためにads_management権限をリクエストすることを確認してください。
    詳細については、次を参照してください：Facebook Login: Permissions Reference。

• Facebookアプリシークレット（必須）

  • 接続したいFacebookアプリのアプリシークレットで、Facebookアプリ > 構成 > 基本で見つけることができます。

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

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

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

アクション - カスタムオーディエンスへのユーザー追加

パラメータ

パラメータ	説明
カスタムオーディエンスへのユーザー追加	必須。 ターゲットカスタムオーディエンスを選択します。 顧客ファイルから作成されたオーディエンスは表示されません。 このコネクタを使用してFacebookでカスタムオーディエンスを構築する前に、Facebookカスタムオーディエンス規約に同意する必要があります。
メールアドレス	メールアドレスに基づいてユーザーを識別します。
電話番号	電話番号に基づいてユーザーを識別します。国コード、エリアコード、番号のみの数字を含めます。例：16505551212。
FacebookユーザーID	Facebook IDに基づいてユーザーを識別します。 この識別タイプを使用する場合は、「FacebookアプリID」を提供する必要があります。
FacebookアプリID	「FacebookユーザーID」がユーザー識別子として使用される場合は必須です。 「FacebookユーザーID」を参照してください。
モバイル広告ID	アプリユーザーID、AppleのAdvertising Identifier（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はこの値を使用して、オーディエンス内のどのユーザーがあなたにとって最も価値があるかを定量的に判断します。
チェックボックス	ターゲットユーザー識別子が既にハッシュ化されている場合は、このボックスをチェックします。 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はこの値を使用して、オーディエンス内のどのユーザーがあなたにとって最も価値があるかを定量的に判断します。
チェックボックス	ターゲットユーザー識別子が既にハッシュ化されている場合は、このボックスをチェックします。 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省略形コード。
名	ユーザーの名。 小文字。 句読点や特殊文字は含まない。 UTF-8形式。
姓	ユーザーの姓。 小文字。 句読点や特殊文字は含まない。 UTF-8形式。
イニシャル	ユーザーの名のイニシャル。 小文字。 句読点や特殊文字は含まない。 UTF-8形式。
生年	ユーザーの生年。 YYYY形式。 1900年から現在の年までの値。
生日	ユーザーの生日。 DD形式。 01から31までの値。
生月	ユーザーの生月。 MM形式。 01から12までの値。
性別	ユーザーの性別。 Mは男性、Fは女性
類似値	CRMデータからシードカスタムオーディエンスを作成する際に各ユーザーに構成される任意の数値。 Facebookはこの値を使用して、オーディエンス内のどのユーザーがあなたにとって最も価値があるかを定量的に判断します。
チェックボックス	ターゲットユーザー識別子が既にハッシュ化されている場合は、このボックスをチェックします。 FacebookはSHA256ハッシュ方式のみを受け付けます。

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

ビジターID属性の作成

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

ビジターID属性を構成するためのリソースを以下に使用してください：

• ビジターID属性の構成
• FacebookマーケティングAPI

オーディエンスの定義

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

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

以下の例を使用して、Known Visitorブールデータタイプがtrueに構成されている訪問のオーディエンスフィルターを作成します。バッジとブール属性を事前に追加するか、フィルターを作成する際に追加します。

TealiumをFacebookオーディエンスアカウントに接続

コネクタをFacebookオーディエンスアカウントに構成するためには、アカウントIDが必要です。

FacebookオーディエンスアカウントIDを取得するための手順は以下の通りです：

1. Facebookオーディエンスアカウントにログインします。

2. 広告マネージャーで広告アカウント、キャンペーン、広告セット、または広告をクリックします。

3. ブラウザのURLからaccount_idパラメータ値をコピーしてから、AudienceStreamのコネクタに戻ります。
   

   

4. 構成ウィンドウで、タイトルと関連するメモ、および上記からコピーした広告アカウントIDを追加します。

5. 接続確立をクリックして、接続を確認します。

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

Facebook Audiencesアカウントに接続したので、カスタムオーディエンスを作成する時が来ました。コネクターを介してカスタムオーディエンスを作成する前に、Facebookサイトで最初のカスタムオーディエンスを作成し、利用規約に同意する必要があります。

カスタムオーディエンスを作成するには、以下の手順を使用します：

1. コネクター構成で、作成タブをクリックします。
2. 希望のカスタムオーディエンス名と短い説明を入力します。
3. 作成をクリックします。
   customer_file_source パラメーターは以下の値をサポートしています：

• USER_PROVIDED_ONLY
• PARTNER_PROVIDED_ONLY
• BOTH_USER_AND_PARTNER_PROVIDED

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

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

コネクターアクションの指定

次に、コネクターが実行するアクションを指定する必要があります。

コネクターのアクションを指定するには、以下の手順を使用します：

1. アクションタブをクリックします。
2. カスタムオーディエンスにユーザーを追加を選択します。
   

   

3. + アクションの作成をクリックします。

コネクターアクションの構成

コネクターアクションを構成するには、以下の手順を使用します：

1. オーディエンスメニューから、以前に作成したShoe-Fansオーディエンスを選択します。
   カスタムオーディエンスにユーザーを追加するメニューには、Facebook Audiencesアカウントに存在するオーディエンスが表示されます。
2. カスタムオーディエンスにユーザーを追加するドロップダウンリストから、訪問を追加したいオーディエンスを選択します。
3. ターゲットユーザー識別子ドロップダウンリストで、訪問のメール属性をFacebook Audiencesアカウントの対応する訪問識別子にマッピングします。
4. WHENはJoined Audienceに構成したままにします。
5. 保存をクリックします。

テスト

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

FAQ

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

Facebookに2,000以上のオーディエンスがある場合、AudienceStreamコネクターのドロップダウンリストではすべてを選択することはできません。

Facebookですべてのオーディエンスを表示し、特定のオーディエンスの識別子を選択するには、以下の手順を使用します：

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

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

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

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

   

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