Facebook Audiences コネクタ構成ガイド

API情報

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

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

バッチ制限

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

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

コネクタアクション

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

構成の構成

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

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

• Ad Account ID
  • 必須
  • 管理したいFacebook AudiencesアカウントID。(詳細.)
  • このコネクタを使用し、Facebookでカスタムオーディエンスを作成する前に、Facebook Custom Audience Termsに同意する必要があります。
  • この接続は通常60日以内に期限切れとなり、すべてのFacebook Adアクションの結果が予測不能になります。
  • Establish Connection/Connectedをクリックすることで、いつでも接続を再確立できます。

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

Facebook Audiencesコネクタ特有の構成

• Facebook App ID (必須)
  接続したいFacebookアプリのID。

  • より多くのリソース（より良いレート制限など）を得るために、Ads Management Standard Accessをリクエストします。
    詳細については、Facebook Marketing API: Access and Authenticationを参照してください。
  • 広告管理のためにads_managementの許可をリクエストすることを確認してください。
    詳細については、Facebook Login: Permissions Referenceを参照してください。

• Facebook App Secret (必須)

  • 接続したいFacebookアプリのApp Secret。これはFacebook app > Settings > Basicで見つけることができます。

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

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

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

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

パラメータ

パラメータ	説明
ユーザーを追加するカスタムオーディエンス	必須。 ターゲットとするカスタムオーディエンスを選択します。 顧客ファイルから作成されたオーディエンスは表示されません。 このコネクタを使用し、Facebookでカスタムオーディエンスを作成する前に、Facebook Custom Audience Termsに同意する必要があります。
メールアドレス	ユーザーをメールアドレスに基づいて識別します。
電話番号	ユーザーを電話番号に基づいて識別します。国コード、地域コード、番号のみを含めます。例えば、16505551212。
FacebookユーザーID	ユーザーをFacebook IDに基づいて識別します。 この識別子タイプを使用する場合、FacebookユーザーID（UID）に対応する"Facebook App ID"を提供する必要があります。
Facebook App ID	“Facebook User ID"がユーザー識別子として使用される場合は必須。 “Facebook User ID"を参照してください。
モバイル広告ID	このIDを使用して、アプリユーザーID、AppleのAdvertising Identifier（IDFA）、またはAndroidの広告IDに基づいてユーザーをターゲットにします。
外部ID	ハッシュしないでください。 広告主からの任意の一意のID、例えばロイヤルティメンバーシップID、ユーザーID、外部クッキーIDなど。
郵便番号	郵便番号。 形式は国によります。
市区町村	ユーザーの市区町村。 小文字。 句読点やスペースは含めません。
国	ユーザーの国。 2文字の国コード。 ISO 3166-1 Alpha-2形式。
US州	アメリカ合衆国のユーザー州。 小文字。 2文字のANSI省略コード。
名	ユーザーの名。 小文字。 句読点や特殊文字は含めません。 UTF-8形式。
姓	ユーザーの姓。 小文字。 句読点や特殊文字は含めません。 UTF-8形式。
イニシャル	ユーザーのイニシャル。 小文字。 句読点や特殊文字は含めません。 UTF-8形式。
生年	ユーザーの生年。 YYYY形式。 1900から現在の年までの値。
生日	ユーザーの生日。 DD形式。 01から31までの値。
生月	ユーザーの生月。 MM形式。 01から12までの値。
性別	ユーザーの性別。 Mは男性、Fは女性を表します
Lookalike Value	CRMデータからシードカスタムオーディエンスを作成する際に、各ユーザーに構成される任意の数値。 Facebookはこれを使用して、オーディエンス内のどのユーザーがあなたにとって最も価値があるかを定量的に判断します。
チェックボックス	ターゲットユーザー識別子がすでにハッシュされている場合は、このボックスをチェックします。 FacebookはSHA256ハッシュメソッドのみを受け入れます。

アクション - ユーザーをカスタムオーディエンスから削除

パラメータ

パラメータ	説明
ユーザーを削除するカスタムオーディエンス	必須。 ターゲットとするカスタムオーディエンスを選択します。 このコネクタを使用し、Facebookでカスタムオーディエンスを作成する前に、Facebook Custom Audience Termsに同意する必要があります。
メールアドレス	ユーザーをメールアドレスに基づいて識別します。
電話番号	ユーザーを電話番号に基づいて識別します。国コード、地域コード、番号のみを含めます。例えば、16505551212。
FacebookユーザーID	ユーザーをFacebook IDに基づいて識別します。 この識別子タイプを使用する場合、FacebookユーザーID（UID）に対応する"Facebook App ID"を提供する必要があります。
Facebook App ID	“Facebook User ID"がユーザー識別子として使用される場合は必須。 “Facebook User ID"を参照してください。
モバイル広告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ハッシュメソッドのみを受け入れます。

アクション - ユーザーをすべてのカスタムオーディエンスから除外する

パラメータ

パラメータ	説明
メールアドレス	メールアドレスに基づいてユーザーを特定します。
電話番号	電話番号に基づいてユーザーを特定します。国コード、地域コード、番号のみの数字を含めます。例えば、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形式。
イニシャル	ユーザーのイニシャル。 小文字。 句読点や特殊文字はなし。 UTF-8形式。
生年	ユーザーの生年。 YYYY形式。 1900年から現在の年までの値。
生日	ユーザーの生日。 DD形式。 01から31までの値。
生月	ユーザーの生月。 MM形式。 01から12までの値。
性別	ユーザーの性別。 Mは男性、Fは女性を示す
ルックアライク値	CRMデータからシードカスタムオーディエンスを作成する際に構成される、各ユーザーに対する任意の数値。 Facebookはこれを使用して、オーディエンス内のどのユーザーがあなたにとって最も価値があるかを定量的に判断します。
チェックボックス	ターゲットユーザー識別子がすでにハッシュ化されている場合は、このボックスをチェックします。 FacebookはSHA256ハッシュメソッドのみを受け入れます。

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

ビジターID属性を作成する

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

ビジターID属性を構成するための以下のリソースを使用します：

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

オーディエンスを定義する

あなたのアカウントにはいくつかのビジターID属性が定義されているかもしれません。この場合、ビジターIDの存在をチェックするために、Booleanデータ型のKnown Visitorという名前のビジタースコープ属性を作成することが重要です。この属性を使用することで、オーディエンスはFacebookに渡すことができるビジターIDが割り当てられたビジターのみを含むようになります。未知のビジターをターゲットにすることはできません。

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

以下の例を使用して、“Known Visitor” Booleanデータ型がtrueに構成されているビジターのオーディエンスフィルタを作成します。バッジとBoolean属性は事前に追加することも、フィルタを作成する際に追加することもできます。

TealiumをあなたのFacebookオーディエンスアカウントに接続する

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

FacebookオーディエンスアカウントIDを取得するための以下の手順を使用します：

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

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

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

   

4. 構成ウィンドウで、タイトルと関連するメモ、そしてあなたの広告アカウントID（上記でコピーしたもの）を追加します。

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

カスタムオーディエンスを作成する

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

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

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

• USER_PROVIDED_ONLY
• PARTNER_PROVIDED_ONLY
• BOTH_USER_AND_PARTNER_PROVIDED

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

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

コネクタアクションを指定する

次に、コネクタが取るべきアクションを指定する必要があります。

コネクタのアクションを指定するための以下の手順を使用します：

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

   

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

コネクタアクションを構成する

コネクタのアクションを構成するための以下の手順を使用します：

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

テスト

最も効果的なテスト方法は、イベントが適切に処理されていることを確認し、カスタムオーディエンスが作成され、人口が増えていることを確認するために、Traceを実行することです。

FAQ

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

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

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

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

2. https://www.facebook.com/adsmanager/audiencesに移動します。

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

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

   

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