Facebookオーディエンス顧客提供クレデンシャルコネクタ構成ガイド

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

前提条件

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

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

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

より多くのアプリリソース、例えばより良いレート制限を要求するには、広告管理標準アクセスを要求してください。詳細については、Facebook: アクセスと認証を参照してください。

API情報

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

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

バッチ制限

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

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

コネクタアクション

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

構成の構成

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

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

• アプリID
  必須。接続したいFacebookアプリIDです。
• アプリシークレット
  必須。接続したいFacebookアプリのアプリシークレットです。
• 広告アカウントID
  必須。管理したいFacebook広告アカウントIDです。Facebook広告アカウントIDについての詳細は、Facebook: Facebook広告アカウントID番号の検索を参照してください。

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

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

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

アクション

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

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

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

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

パラメータ

パラメータ	説明
カスタムオーディエンスへのユーザー追加	必須。 ターゲットカスタムオーディエンスを選択します。 顧客ファイルから作成されたオーディエンスは表示されません。 このコネクタを使用してFacebookでカスタムオーディエンスを構築する前に、Facebookカスタムオーディエンス利用規約に同意する必要があります。
メールアドレス	メールアドレスに基づいてユーザーを識別します。
電話番号	電話番号に基づいてユーザーを識別します。 国コード、エリアコード、番号のみの数字を含めます。例：16505551212。
FacebookユーザーID	Facebook IDに基づいてユーザーを識別します。 この識別タイプを使用する場合は、対応する「FacebookアプリID」を提供する必要があります。
Facebookアプリ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アプリIDも提供する必要があります。メールアドレスまたは電話番号は1つのみサポートされています。複数の識別子が指定されている場合、上記の順序で選択されます。たとえば、メールアドレスと電話番号の両方が指定されている場合、メールアドレスが選択されます（値がない場合を除く）。

パラメータ

パラメータ	説明
削除対象のカスタムオーディエンス	必須。 対象のカスタムオーディエンスを選択します。 このコネクタを使用してFacebookでカスタムオーディエンスを構築する前に、Facebookカスタムオーディエンス規約に同意する必要があります。
メールアドレス	メールアドレスに基づいてユーザーを特定します。
電話番号	電話番号に基づいてユーザーを特定します。 国コード、市外局番、番号のみを含めます。例：16505551212。
FacebookユーザーID	Facebook IDに基づいてユーザーを特定します。 この識別タイプを使用する場合は、「FacebookアプリID」を提供する必要があります。
Facebookアプリ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ハッシュ方式のみを受け付けます。

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

パラメータ

パラメータ	説明
メールアドレス	メールアドレスに基づいてユーザーを特定します。
電話番号	電話番号に基づいてユーザーを特定します。 国コード、市外局番、番号のみを含めます。例：16505551212。
FacebookユーザーID	Facebook IDに基づいてユーザーを特定します。 この識別タイプを使用する場合は、「FacebookアプリID」を提供する必要があります。
Facebookアプリ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オーディエンス顧客提供資格情報コネクタの使用

ビジターID属性の作成

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

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

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

オーディエンスの定義

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

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

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

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を入力します。