Facebook Audiencesコネクタ構成ガイド
この記事では、Customer Data HubアカウントでFacebook Audiencesコネクタを構成する方法について説明します。
API情報
このコネクタでは、次のベンダーAPIを使用します。
- API名:Facebook Graph API - Marketing API
- APIバージョン:v25.0
- APIエンドポイント:
https://graph.facebook.com - ドキュメント:Facebook Marketing API
バッチ処理の制限
このコネクタでは、ベンダーへの大量のデータ転送に対応するため、リクエストをバッチ処理します。並列処理により、イベントが順不同でベンダーに到達する場合があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかのしきい値に達するか、プロファイルが公開されるまでキューに入れられます。
- リクエストの最大数:10000
- 最も古いリクエストからの最大経過時間:10分
- リクエストの最大サイズ:1 MB
構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。
コネクタを追加した後、次の構成を行います。
認証タイプ:Facebookへの接続に使用する認証タイプを選択します。このオプションは、従来のコネクタインターフェイスでは使用できません。
- SUAT(システムユーザー認証トークン):(推奨)より安定した永続的な認証方法を使用するには、このオプションを選択します。詳細については、Facebook:システムユーザーアクセストークンを取得するを参照してください。
- OAuth2:通常、この接続は60日以内に期限切れとなり、すべてのFacebook広告アクションで予期しない結果が生じる可能性があります。問題を回避するには、接続の有効期限が切れる前に再認証する必要があります。このオプションを選択した場合は、接続を確立をクリックしてFacebookで認証します。
接続を確立ボタンをクリックする前に、使用する広告アカウントIDにリンクされたアカウントでFacebookにサインインしていることを確認してください。そうでない場合、生成されるトークンに問題が発生する可能性があります。
広告アカウントID:(必須)管理するFacebook AudiencesアカウントIDです。詳細については、Facebook:Facebook広告アカウントID番号を確認するを参照してください。
このコネクタを使用してFacebookでカスタムオーディエンスを作成するには、事前にFacebookカスタムオーディエンス規約に同意する必要があります。
カスタムオーディエンスの作成
コネクタを使用してカスタムオーディエンスを作成するには、事前にFacebookサイトで最初のカスタムオーディエンスを作成し、利用規約に同意する必要があります。
カスタムオーディエンスを使用するには、20件以上のエントリが含まれている必要があります。オーディエンスが正常に作成されると、ボタンの横に小さなチェックアイコンが表示されます。
カスタムオーディエンスを作成をクリックし、次の構成を行います。
- オーディエンス名:(必須)カスタムオーディエンスの名前です。CRMのオーディエンス名またはセグメント名を使用します(例:
Qualified Leads - US - Q3 2026またはHigh Value Customers - EMEA)。Metaはこの名前を使用してオーディエンスセグメントを識別します。 - オーディエンスメタデータ(JSON):(任意)オーディエンスの条件を記述するJSONオブジェクトで、Meta APIの
descriptionパラメータにマッピングされます。集計属性またはカテゴリ属性を含むキーと値のペアを使用してください。個人識別情報(PII)を含めないでください。例:{"lifecycle_stage":"churned","region":"EMEA","tier":"high_value"}。Metaはこのメタデータをオーディエンスラベルおよび最適化機能で使用します。ラベルの割り当てはMeta広告マネージャで行います。Metaがメタデータを解析できるように、値は有効なJSONである必要があります。 - 顧客ファイルのソース:
USER_PROVIDED_ONLY:広告主が顧客から直接収集した情報を使用します。PARTNER_PROVIDED_ONLY:広告代理店やデータプロバイダーなどのパートナーから広告主が直接入手した情報を使用します。BOTH_USER_AND_PARTNER_PROVIDED:広告主が顧客から直接収集した情報と、広告代理店などのパートナーから入手した情報の両方を使用します。
- オーディエンスタイプ:
VALUE_BASED_AUDIENCE:最も価値の高い顧客と類似した行動を示す顧客を識別します。CUSTOMER_FILE_AUDIENCE:(デフォルト)メールアドレス、電話番号、その他の識別子など、顧客ファイルの情報に基づいて顧客を識別します。
コネクタを構成した後、完了をクリックします。
Facebook Audiencesサイトでは、顧客リスト、Webサイトのトラフィック、またはアプリのアクティビティに基づいてオーディエンスを作成できます。この例では、顧客リストに基づいてオーディエンスを作成します。
詳細については、Metaビジネスヘルプセンター:顧客リストのカスタムオーディエンスを作成するを参照してください。
アクション
| アクション名 | 訪問プロファイル | イベントデータ |
|---|---|---|
| ユーザーをカスタムオーディエンスに追加 | ✓ | ✗ |
| ユーザーをカスタムオーディエンスから削除 | ✓ | ✗ |
| すべてのカスタムオーディエンスからユーザーをオプトアウト | ✓ | ✗ |
アクションの名前を入力し、アクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションを構成する方法について説明します。
ユーザーをカスタムオーディエンスに追加
パラメーター
| パラメーター | 説明 |
|---|---|
| ユーザーの追加先となるカスタムオーディエンス |
|
| メールアドレス |
|
| 電話番号 |
|
| Facebook ユーザー ID |
|
| Facebook アプリ ID |
|
| モバイル広告 ID |
|
| 外部 ID |
|
| 郵便番号 |
|
| 市区町村 |
|
| 国 |
|
| 米国の州 |
|
| 名 |
|
| 姓 |
|
| 出生年 |
|
| 誕生日 |
|
| 誕生月 |
|
| カスタムオーディエンスの上書き |
|
| メールは SHA256 でハッシュ済み |
|
| メールに SHA256 ハッシュを適用 |
|
| 電話番号は SHA256 でハッシュ済み |
|
| 電話番号に SHA256 ハッシュを適用 |
|
| 名は SHA256 でハッシュ済み |
|
| 名に SHA256 ハッシュを適用 |
|
| 姓は SHA256 でハッシュ済み |
|
| 姓に SHA256 ハッシュを適用 |
|
| 市区町村は SHA256 でハッシュ済み |
|
| 市区町村に SHA256 ハッシュを適用 |
|
| 州は SHA256 でハッシュ済み |
|
| 州に SHA256 ハッシュを適用 |
|
| ZIP/郵便番号は SHA256 でハッシュ済み |
|
| ZIP/郵便番号に SHA256 ハッシュを適用 |
|
| 国は SHA256 でハッシュ済み |
|
| 国に SHA256 ハッシュを適用 |
|
| 外部 ID は SHA256 でハッシュ済み |
|
| 外部 ID に SHA256 ハッシュを適用 |
|
| 生年月日は SHA256 でハッシュ済み |
|
| 生年月日に SHA256 ハッシュを適用 |
|
| 性別は SHA256 でハッシュ済み |
|
| 性別に SHA256 ハッシュを適用 |
|
従来の User Identifier Already Hashed チェックボックスを使用する既存の保存済みアクションは、再構成しなくても引き続き機能します。同じ識別子に「Already SHA256 Hashed」と「Apply SHA256 Hash」の両方のバリエーションがマッピングされている場合は、「Already SHA256 Hashed」が優先されます。
カスタムオーディエンスからユーザーを削除
パラメーター
| パラメーター | 説明 |
|---|---|
| ユーザーの削除元となるカスタムオーディエンス |
|
| メールアドレス |
|
| 電話番号 |
|
| FacebookユーザーID |
|
| FacebookアプリID |
|
| モバイル広告ID |
|
| 外部ID |
|
| 郵便番号 |
|
| 市区町村 |
|
| 国 |
|
| 米国の州 |
|
| 名 |
|
| 姓 |
|
| 名のイニシャル |
|
| 出生年 |
|
| 誕生日 |
|
| 誕生月 |
|
| 性別 |
|
| 類似オーディエンス値 |
|
| カスタムオーディエンスの上書き |
|
| SHA256ハッシュ化済みメールアドレス |
|
| メールアドレスにSHA256ハッシュを適用 |
|
| SHA256ハッシュ化済み電話番号 |
|
| 電話番号にSHA256ハッシュを適用 |
|
| SHA256ハッシュ化済みの名 |
|
| 名にSHA256ハッシュを適用 |
|
| SHA256ハッシュ化済みの姓 |
|
| 姓にSHA256ハッシュを適用 |
|
| SHA256ハッシュ化済みの市区町村 |
|
| 市区町村にSHA256ハッシュを適用 |
|
| SHA256ハッシュ化済みの州 |
|
| 州にSHA256ハッシュを適用 |
|
| SHA256ハッシュ化済みのZIP/郵便番号 |
|
| ZIP/郵便番号にSHA256ハッシュを適用 |
|
| SHA256ハッシュ化済みの国 |
|
| 国にSHA256ハッシュを適用 |
|
| SHA256ハッシュ化済みの外部ID |
|
| 外部IDにSHA256ハッシュを適用 |
|
| SHA256ハッシュ化済みの生年月日 |
|
| 生年月日にSHA256ハッシュを適用 |
|
| SHA256ハッシュ化済みの性別 |
|
| 性別にSHA256ハッシュを適用 |
|
Existing saved actions that use the legacy User Identifier Already Hashed checkbox continue to work without reconfiguration. If both the Already SHA256 Hashed and Apply SHA256 Hash variants are mapped for the same identifier, Already SHA256 Hashed takes precedence.
すべてのカスタムオーディエンスからユーザーをオプトアウトする
パラメータ
| パラメータ | 説明 |
|---|---|
| メールアドレス |
|
| 電話番号 |
|
| FacebookユーザーID |
|
| FacebookアプリID |
|
| モバイル広告ID |
|
| 外部ID |
|
| 郵便番号 |
|
| 市区町村 |
|
| 国 |
|
| 米国の州 |
|
| 出生年 |
|
| 出生日 |
|
| 出生月 |
|
| 姓 |
|
| 名のイニシャル |
|
| 性別 |
|
| 類似オーディエンス値 |
|
| SHA256でハッシュ済みのメールアドレス |
|
| メールアドレスにSHA256ハッシュを適用 |
|
| SHA256でハッシュ済みの電話番号 |
|
| 電話番号にSHA256ハッシュを適用 |
|
| SHA256でハッシュ済みの名 |
|
| 名にSHA256ハッシュを適用 |
|
| SHA256でハッシュ済みの姓 |
|
| 姓にSHA256ハッシュを適用 |
|
| SHA256でハッシュ済みの市区町村 |
|
| 市区町村にSHA256ハッシュを適用 |
|
| SHA256でハッシュ済みの州 |
|
| 州にSHA256ハッシュを適用 |
|
| SHA256でハッシュ済みのZIP/郵便番号 |
|
| ZIP/郵便番号にSHA256ハッシュを適用 |
|
| SHA256でハッシュ済みの国 |
|
| 国にSHA256ハッシュを適用 |
|
| SHA256でハッシュ済みの外部ID |
|
| 外部IDにSHA256ハッシュを適用 |
|
| SHA256でハッシュ済みの生年月日 |
|
| 生年月日にSHA256ハッシュを適用 |
|
| SHA256でハッシュ済みの性別 |
|
| 性別にSHA256ハッシュを適用 |
|
従来のユーザー識別子はハッシュ化済みチェックボックスを使用している既存の保存済みアクションは、再構成しなくても引き続き動作します。同じ識別子に「SHA256でハッシュ済み」と「SHA256ハッシュを適用」の両方がマッピングされている場合は、「SHA256でハッシュ済み」が優先されます。
Facebook Audiencesコネクタの使用
訪問IDの作成
Facebook Audiencesコネクタでは、Facebook Audiencesに渡すことができる訪問ID属性が少なくとも1つ必要です。
訪問ID属性を構成するには、次のリソースを使用してください。
オーディエンスの定義
アカウントには複数の訪問ID属性が定義されている場合があります。この場合、いずれかの訪問IDが存在するかどうかを確認するために、Known Visitorという名前の訪問バッジを作成することが重要です。この属性を使用すると、Facebookに渡すことができる訪問IDが割り当てられた訪問のみがオーディエンスに含まれるようになります。不明な訪問をターゲティングすることはできません。
Known Visitorバッジを他の条件と組み合わせて、コネクタ用のオーディエンスを作成します。
このコネクタには、メールアドレス、電話番号、アプリID、ユーザーIDなどの必須IDパラメータもあります。これらのIDのうち、少なくとも1つが必要です。これらのIDをオーディエンスフィルターに含めると、コネクタエラーの回避に役立ちます。
テスト
最も効果的なテスト方法は、Traceを実行してイベントが適切に処理されていることを確認し、Facebookダッシュボードでカスタムオーディエンスが作成され、データが追加されていることを確認することです。
よくある質問
CDPのドロップダウンリストにオーディエンスが表示されないのはなぜですか?
Facebookに2,000件を超えるオーディエンスがある場合、CDPコネクターのドロップダウンリストですべてを選択できるわけではありません。
Facebookですべてのオーディエンスを表示し、特定のオーディエンスの識別子を選択するには、次の手順を実行します。
最終更新日 :: 2026年November月10日
