Facebookオーディエンス顧客提供認証コネクタの構成ガイド

この記事では、Facebookオーディエンス顧客提供認証コネクタのセットアップ方法について説明します。

前提条件

Facebookアプリの作成に関する詳細は、Facebook: アプリ開発を参照してください。

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

1. Facebookカスタムオーディエンス利用規約に同意します。
2. 次のリダイレクトURIをFacebookアカウントに追加します: https://my.tealiumiq.com/oauth/facebook/callback.html。Facebook App DashboardからFacebookログイン > 構成に移動し、Facebook Appの有効なOAuthリダイレクトURIの下にURIを入力します。
3. Facebookアプリでads_managementパーミッションをリクエストします。ads_managementパーミッションにより、アプリは所有する広告アカウントまたは広告アカウントの所有者からアクセス権を付与された広告アカウントを読み取りおよび管理することができます。詳細については、Facebook: パーミッションリファレンスを参照してください。

より多くのアプリリソース（より良いレート制限など）を取得するには、Ads Management Standard Accessをリクエストしてください。詳細については、Facebook: アクセスと認証を参照してください。

API情報

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

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

バッチ制限

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

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

コネクタアクション

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

構成の構成

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

コネクタを追加した後、次の構成を構成します。

• App ID
  必須。接続したいFacebook AppのApp IDです。
• App Secret
  必須。接続したいFacebook AppのApp Secretです。
• Ad Account ID
  必須。管理したいFacebook広告アカウントのAd Account IDです。Facebook広告アカウントIDに関する詳細は、Facebook: Facebook広告アカウントID番号の検索方法を参照してください。

この接続は通常60日で期限切れになり、すべてのFacebook広告アクションに予測不可能な結果をもたらします。

いつでも接続の確立/接続済みをクリックして接続を再確立できます。

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

アクション

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

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

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

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

パラメータ

パラメータ	説明
ユーザーを追加するカスタムオーディエンス	必須。 ターゲットのカスタムオーディエンスを選択します。 顧客ファイルから作成されたオーディエンスは表示されません。 このコネクタを使用してFacebookでカスタムオーディエンスを作成し、ビルドする前に、Facebookカスタムオーディエンス利用規約に同意する必要があります。
メールアドレス	メールアドレスに基づいてユーザーを識別します。
電話番号	電話番号に基づいてユーザーを識別します。
FacebookユーザーID	Facebook IDに基づいてユーザーを識別します。 この識別子タイプを使用する場合は、FacebookユーザーID（UID）に対応する「Facebook App ID」を指定する必要があります。
Facebook App ID	「FacebookユーザーID」がユーザー識別子として使用される場合は必須です。 「FacebookユーザーID」を参照してください。
モバイル広告主ID	アプリユーザーID、Appleの広告識別子（IDFA）、またはAndroidの広告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ハッシュ化メソッドのみを受け付けます。

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

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

パラメータ

パラメータ	説明
ユーザーを削除するカスタムオーディエンス	必須。 ターゲットのカスタムオーディエンスを選択します。 このコネクタを使用してFacebookでカスタムオーディエンスを作成し、ビルドする前に、Facebookカスタムオーディエンス利用規約に同意する必要があります。
メールアドレス	メールアドレスに基づいてユーザーを識別します。
電話番号	電話番号に基づいてユーザーを識別します。
FacebookユーザーID	Facebook IDに基づいてユーザーを識別します。 この識別子タイプを使用する場合は、FacebookユーザーID（UID）に対応する「Facebook App ID」を指定する必要があります。
Facebook App ID	「FacebookユーザーID」がユーザー識別子として使用される場合は必須です。 「FacebookユーザーID」を参照してください。
モバイル広告主ID	アプリユーザーID、Appleの広告識別子（IDFA）、またはAndroidの広告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ハッシュ化メソッドのみを受け付けます。

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

パラメータ

パラメータ	説明
メールアドレス	メールアドレスに基づいてユーザーを識別します。
電話番号	電話番号に基づいてユーザーを識別します。
FacebookユーザーID	Facebook IDに基づいてユーザーを識別します。 この識別子タイプを使用する場合は、FacebookユーザーID（UID）に対応する「Facebook App ID」を指定する必要があります。
Facebook App Id	「FacebookユーザーID」がユーザー識別子として使用される場合は必須です。 「FacebookユーザーID」を参照してください。
モバイル広告主ID	アプリユーザーID、Appleの広告識別子（IDFA）、またはAndroidの広告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オーディエンス顧客提供認証コネクタの使用

Visitor ID属性の作成

Facebookオーディエンス顧客提供認証コネクタには、Facebookオーディエンスに渡すことができる少なくとも1つのVisitor ID属性が必要です。

次のリソースを使用してVisitor ID属性を構成します。

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

オーディエンスの定義

アカウントには複数のVisitor ID属性が定義されている場合、Visitor ID属性のいずれかが割り当てられた訪問のみを含むオーディエンスを作成するために、ブールデータ型の訪問スコープ属性を作成することが重要です。不明な訪問をターゲットにすることはできません。

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

次の例を使用して、Known Visitorという名前のブールデータ型の属性を作成し、訪問IDが割り当てられている訪問のみを含むオーディエンスを作成します。不明な訪問をターゲットにすることはできません。

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

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

次の手順でFacebookオーディエンスアカウントIDを取得します。

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

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

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

   

4. Configureウィンドウで、タイトルと関連するメモ、およびAd Account ID（上記でコピーしたもの）を追加します。

5. 接続を確認するためにEstablish Connectionをクリックします。

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

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

次の手順でカスタムオーディエンスを作成します。

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

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

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

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

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

コネクタのアクションを指定するには、次の手順を実行します。

1. Actionsタブをクリックします。
2. Add User to Custom Audienceを選択します。
   

   

3. + Create Actionをクリックします。

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

コネクタのアクションを構成するには、次の手順を実行します。

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

テスト

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

FAQ

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

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

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

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

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

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

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

   

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