Facebookオーディエンスコネクタの構成ガイド

コネクタのアクション

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

API情報

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

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

バッチ制限

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

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

構成の構成

コネクタマーケットプレイスに移動して、新しいコネクタを追加します。コネクタの追加方法については、コネクタの概要の記事を読んでください。

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

• 広告アカウントID
  • 必須
  • 管理するFacebookオーディエンスアカウントのFacebookアカウントIDです。 (詳細を見る.)
  • このコネクタを使用してFacebookでカスタムオーディエンスを作成する前に、Facebookカスタムオーディエンス利用規約に同意する必要があります。
  • この接続は通常60日で期限切れになり、すべてのFacebook広告アクションに予測不可能な結果をもたらします。
  • いつでも接続の確立/接続済みをクリックして接続を再確立できます。

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

Facebookオーディエンスコネクタ固有の構成

• Facebook App ID（必須）
  接続するFacebookアプリのIDです。

  • より良いレート制限などの追加リソースを取得するために、Ads Management Standard Accessを要求してください。
  • Ads Managementのためにads_managementパーミッションを要求してください。
    詳細については、Facebookログイン：パーミッションリファレンスを参照してください。

• Facebook App Secret（必須）

  • 接続するFacebookアプリのApp Secretです。これはFacebookアプリ > 構成 > 基本で見つけることができます。

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

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

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

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

パラメータ

パラメータ	説明
ユーザーを追加するカスタムオーディエンス	必須。 対象のカスタムオーディエンスを選択します。 顧客ファイルから作成されたオーディエンスは表示されません。 このコネクタを使用して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に基づいてユーザーをターゲットにします。
外部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でカスタムオーディエンスを作成する前に、Facebookカスタムオーディエンス利用規約に同意する必要があります。
メールアドレス	メールアドレスに基づいてユーザーを識別します。
電話番号	電話番号に基づいてユーザーを識別します。
FacebookユーザーID	Facebook IDに基づいてユーザーを識別します。 この識別子タイプを使用する場合、FacebookユーザーID（UID）に対応する「Facebook App ID」を提供する必要があります。
Facebook App 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 IDに基づいてユーザーを識別します。 この識別子タイプを使用する場合、FacebookユーザーID（UID）に対応する「Facebook App ID」を提供する必要があります。
Facebook App 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オーディエンスに渡すことができる少なくとも1つの訪問ID属性が必要です。

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

• 訪問ID属性の構成
• Facebook Marketing API

オーディエンスの定義

アカウントには複数の訪問ID属性が定義されている場合、訪問ID属性のうち少なくとも1つが存在するかどうかをチェックするために、訪問スコープのブール型属性を作成し、「Known Visitor」という名前で命名することが重要です。この属性を使用すると、オーディエンスにはVisitor IDが割り当てられてFacebookに渡すことができる訪問のみが含まれます。不明な訪問をターゲットにすることはできません。

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

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

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. 保存をクリックします。

テスト

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

FAQ

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

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

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

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

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

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

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

   

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