Facebookオーディエンス顧客提供資格情報コネクタ構成ガイド

この記事では、Facebookオーディエンス顧客提供資格情報コネクタの構成方法について説明します。

前提条件

Facebookアプリの作成方法については、Facebook: App Developmentを参照してください。

コネクタを構成する前に、以下の手順を完了してください：

1. Facebook Custom Audience Termsに同意します。
2. 次のリダイレクトURIをFacebookアカウントに追加します：https://my.tealiumiq.com/oauth/facebook/callback.html。Facebookアプリダッシュボードから、Facebook Login > Settingsに移動し、URIをValid OAuth Redirect URIs of your Facebook Appに入力します。
3. Facebookアプリでads_management権限をリクエストします。ads_management権限により、アプリは所有している広告アカウントを読み取り、管理することができます。詳細については、Facebook: Permission Referenceを参照してください。

より多くのアプリリソース、例えばより良いレート制限を得るためには、Ads Management Standard Accessをリクエストします。詳細については、Facebook: Access and Authenticationを参照してください。

API情報

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

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

バッチ制限

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

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

コネクタアクション

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

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法については、About Connectorsを参照してください。

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

• App ID
  必須。接続したいFacebookアプリID。
• App Secret
  必須。接続したいFacebookアプリのApp Secret。
• Ad Account ID
  必須。管理したいFacebook広告アカウントID。Facebook広告アカウントIDについての詳細は、Facebook: Find your Facebook ad account ID numberを参照してください。

この接続は通常60日以内に期限切れとなり、すべてのFacebook広告アクションに対して予測不能な結果を引き起こします。

いつでもEstablish Connection/Connectedをクリックして接続を再確立できます。

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

アクション

アクションに名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

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

ユーザーをカスタムオーディエンスに追加

4種類の識別子がサポートされています：メール、電話番号、ユーザーまたはアプリID、および二次ID。複数の二次識別子がサポートされています。Facebook User IDを指定する場合は、Facebook App IDも提供する必要があります。メールまたは電話番号は1つだけサポートされています。複数の識別子が指定された場合、上記のリストの順序で選択されます。例えば、メールと電話番号の両方が指定された場合、メールが選択されます。

パラメータ

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

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

4種類の識別子がサポートされています：メール、電話番号、ユーザーまたはアプリID、および二次ID。複数の二次識別子がサポートされています。Facebook User IDを指定する場合は、Facebook App IDも提供する必要があります。メールまたは電話番号は1つだけサポートされています。複数の識別子が指定された場合、上記のリストの順序で選択されます。例えば、メールと電話番号の両方が指定された場合、メールが選択されます。

パラメータ

パラメータ	説明
ユーザーを削除するカスタムオーディエンス	必須。 ターゲットのカスタムオーディエンスを選択します。 このコネクタを使用してFacebookでカスタムオーディエンスを作成する前に、Facebookカスタムオーディエンスの利用規約に同意する必要があります。
メールアドレス	ユーザーをメールアドレスに基づいて識別します。
電話番号	ユーザーを電話番号に基づいて識別します。 国コード、地域コード、番号のみの数字を含めます。例えば、16505551212。
FacebookユーザーID	ユーザーをFacebook IDに基づいて識別します。 この識別子タイプを使用する場合、FacebookユーザーID（UID）に対応する"FacebookアプリID"を提供する必要があります。
FacebookアプリID	“FacebookユーザーID"がユーザー識別子として使用される場合は必須です。 “FacebookユーザーID"を参照してください。
モバイル広告主ID	これを使用して、アプリユーザーID、Appleの広告識別子（IDFA）、またはAndroidの広告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は女性を表します
ルックアライク値	CRMデータからシードカスタムオーディエンスを作成する際に、各ユーザーに構成される任意の数値。 Facebookはこれを使用して、オーディエンス内のどのユーザーがあなたにとって最も価値があるかを定量的に判断します。
カスタムオーディエンスオーバーライド	任意。必須セクションの値をオーバーライドするためのカスタムオーディエンスIDを提供します。このフィールドでは、AudienceStreamの変数を使用してオーディエンスIDを入力することができます。
ユーザー識別子はすでにハッシュ化されています	ターゲットユーザー識別子がすでにハッシュ化されている場合は、このボックスをチェックします。 FacebookはSHA256ハッシュ化方法のみを受け入れます。

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

パラメータ

パラメータ	説明
メールアドレス	ユーザーをメールアドレスに基づいて識別します。
電話番号	ユーザーを電話番号に基づいて識別します。 国コード、地域コード、番号のみの数字を含めます。例えば、16505551212。
FacebookユーザーID	ユーザーをFacebook IDに基づいて識別します。 この識別子タイプを使用する場合、FacebookユーザーID（UID）に対応する"FacebookアプリID"を提供する必要があります。
FacebookアプリID	“FacebookユーザーID"がユーザー識別子として使用される場合は必須です。 “FacebookユーザーID"を参照してください。
モバイル広告主ID	これを使用して、アプリユーザーID、Appleの広告識別子（IDFA）、またはAndroidの広告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は女性を表します
ルックアライク値	CRMデータからシードカスタムオーディエンスを作成する際に、各ユーザーに構成される任意の数値。 Facebookはこれを使用して、オーディエンス内のどのユーザーがあなたにとって最も価値があるかを定量的に判断します。
ユーザー識別子はすでにハッシュ化されています	ターゲットユーザー識別子がすでにハッシュ化されている場合は、このボックスをチェックします。 FacebookはSHA256ハッシュ化方法のみを受け入れます。

Facebook Audiences Customer-Provided Credentialsコネクタの使用

ビジターID属性の作成

Facebook Audiences Customer-Provided Credentialsコネクタは、Facebook Audiencesに渡すことができる少なくとも1つのビジターID属性が必要です。

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

• ビジターID属性の構成
• Facebook Marketing API

オーディエンスの定義

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

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

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

TealiumをFacebook Audiencesアカウントに接続

コネクタをFacebook Audiencesアカウントに構成するためには、アカウントIDが必要です。

以下の手順でFacebook AudiencesアカウントIDを取得します：

1. Facebook Audiencesアカウントにログインします。

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オーディエンスを選択します。
   Custom Audience to Add User Toメニューには、Facebook Audiencesアカウントに存在するオーディエンスが表示されます。
2. Custom Audience to Add User Toドロップダウンリストから、訪問を追加したいオーディエンスを選択します。
3. Target User Identifierドロップダウンリストで、訪問のメール属性をFacebook Audiencesアカウントの対応する訪問識別子にマッピングします。
4. WHENはJoined Audienceに構成したままにします。
5. 保存をクリックします。

テスト

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

FAQ

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

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

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

1. Facebook Audiencesアカウントへのアクセス権があるユーザーとしてFacebookにログインします。

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

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

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

   

4. AudienceStreamに戻り、Audience IDをAudienceStreamコネクタのカスタム値として入力します。