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バージョン：v24.0
• APIエンドポイント：https://graph.facebook.com

バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。並列処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチ処理アクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

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

構成

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

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

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

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

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

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

アクション

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

アクションの名前を入力し、アクションタイプを選択します。

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

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

サポートされている識別子のタイプは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のうち少なくとも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. 保存をクリックします。

テスト

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

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