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

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オーディエンスアカウントIDです。詳細については、Facebook: Facebook広告アカウントID番号の検索を参照してください。

このコネクタを使用し、Facebookでカスタムオーディエンスを構築する前に、Facebookカスタムオーディエンス規約に同意する必要があります。

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

コネクタを通じてカスタムオーディエンスを作成する前に、Facebookサイトで最初のカスタムオーディエンスを作成し、規約に同意する必要があります。

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

カスタムオーディエンスを作成をクリックし、次の構成を構成します：

オーディエンス名：（必須）カスタムオーディエンスの名前です。CRMからのオーディエンスまたはセグメント名を使用してください（例：Qualified Leads - US - Q3 2026またはHigh Value Customers - EMEA）。Metaはこの名前を使用してオーディエンスセグメントを識別します。
オーディエンスメタデータ（JSON）：（オプション）Meta APIのdescriptionパラメータにマッピングされたオーディエンス基準を説明するJSONオブジェクトです。集計またはカテゴリ属性のキーバリューペアを使用してください。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オーディエンスサイトでは、顧客リスト、ウェブサイトのトラフィック、またはアプリのアクティビティに基づいてオーディエンスを作成するオプションがあります。この例では、顧客リストに基づいてオーディエンスを作成します。

詳細については、Metaビジネスヘルプセンター: 顧客リストカスタムオーディエンスの作成を参照してください。

アクション

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

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

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

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

パラメータ

パラメータ	説明
追加するカスタムオーディエンス	（必須）ターゲットのカスタムオーディエンスを選択してください。顧客ファイルから作成されたオーディエンスは表示されません。このコネクタを使用してFacebookでカスタムオーディエンスを構築する前に、Facebookカスタムオーディエンス規約に同意する必要があります。
メールアドレス	メールアドレスに基づいてユーザーを特定します。
電話番号	電話番号に基づいてユーザーを特定します。国コード、市外局番、番号のみを含めてください。例：`16505551212`。
FacebookユーザーID	Facebook IDに基づいてユーザーを特定します。この識別タイプを使用する場合は、FacebookユーザーID（UID）に対応する「FacebookアプリID」を提供する必要があります。
Facebookアプリ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形式。
生年	ユーザーの生年。 `YYYY`形式。 `1900`年から現在の年までの値。句読点や特殊文字は含まない。 UTF-8形式。
生日	ユーザーの生日。 `DD`形式。 `01`から`31`までの値。
誕生月	ユーザーの誕生月。 `MM`形式。 `01`から`12`までの値。
カスタムオーディエンスオーバーライド	（オプション）必須セクションの値をオーバーライドするためにカスタムオーディエンスIDを提供します。このフィールドでは、AudienceStreamの変数を使用してオーディエンスIDを入力できます。
ユーザー識別子が既にハッシュ化されている	ターゲットのユーザー識別子が既にハッシュ化されている場合はこのオプションを選択します。FacebookではSHA256でハッシュ化された値のみがサポートされています。

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

パラメータ

パラメータ	説明
削除するカスタムオーディエンス	（必須）ターゲットのカスタムオーディエンスを選択してください。このコネクタを使用してFacebookでカスタムオーディエンスを構築する前に、Facebookカスタムオーディエンス規約に同意する必要があります。
メールアドレス	メールアドレスに基づいてユーザーを特定します。
電話番号	電話番号に基づいてユーザーを特定します。国コード、市外局番、番号のみを含めてください。例：`16505551212`。
FacebookユーザーID	Facebook IDに基づいてユーザーを特定します。この識別タイプを使用する場合は、FacebookユーザーID（UID）に対応する「FacebookアプリID」を提供する必要があります。
Facebookアプリ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はこの値を使用して、オーディエンス内のどのユーザーがあなたにとって数値的に最も価値があるかを判断します。
カスタムオーディエンスオーバーライド	（オプション）必須セクションの値をオーバーライドするためにカスタムオーディエンスIDを提供します。このフィールドでは、AudienceStreamの変数を使用してオーディエンスIDを入力できます。
ユーザー識別子が既にハッシュ化されている	ターゲットのユーザー識別子が既にハッシュ化されている場合はこのオプションを選択します。FacebookではSHA256でハッシュ化された値のみがサポートされています。

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

パラメータ

パラメータ	説明
メールアドレス	メールアドレスに基づいてユーザーを特定します。
電話番号	電話番号に基づいてユーザーを特定します。国コード、地域コード、番号のみの数字を含めてください。例：`16505551212`。
FacebookユーザーID	Facebook IDに基づいてユーザーを特定します。この識別タイプを使用する場合は、対応する「FacebookアプリID」を提供する必要があります。
FacebookアプリID	「FacebookユーザーID」がユーザー識別子として使用される場合に必要です。「FacebookユーザーID」を参照してください。
モバイル広告ID	アプリユーザーID、Appleの広告識別子（IDFA）、またはAndroidの広告IDに基づいてユーザーをターゲットにします。
外部ID	ハッシュ化しないでください。広告主からの任意のユニークID、例えばロイヤリティ会員ID、ユーザーID、外部クッキーIDなど。
郵便番号	郵便番号。形式は国により異なります。
市区町村	ユーザーの市区町村。小文字。句読点やスペースは含まない。
国	ユーザーの国。 2文字の国コード。 ISO 3166-1 Alpha-2形式。
米国の州	アメリカ合衆国の州。小文字。 2文字のANSI略語コード。
生年	ユーザーの生年。 `YYYY`形式。 `1900`年から現在の年までの値。
生日	ユーザーの生日。 `DD`形式。 `01`から`31`までの値。
誕生月	ユーザーの誕生月。 `MM`形式。 `01`から`12`までの値。
ユーザー識別子が既にハッシュ化されている	ターゲットユーザー識別子が既にハッシュ化されている場合は、このオプションを選択します。FacebookではSHA256でハッシュ化された値のみがサポートされています。
姓	ユーザーの姓。小文字。句読点や特殊文字は含まない。 UTF-8形式。
名のイニシャル	ユーザーの名のイニシャル。小文字。句読点や特殊文字は含まない。 UTF-8形式。
性別	ユーザーの性別。 `M`は男性、`F`は女性
ルックアライク値	CRMデータからシードカスタムオーディエンスを作成する際に各ユーザーに構成される任意の数値。 Facebookはこの値を使用して、オーディエンス内のどのユーザーがあなたにとって最も価値があるかを定量的に判断します。

Facebookオーディエンスコネクタの使用

訪問IDの作成

Facebookオーディエンスコネクタは、少なくとも1つの訪問ID属性を必要とし、Facebookオーディエンスに渡すことができます。

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

オーディエンスの定義

あなたのアカウントには複数の訪問ID属性が定義されている場合があります。この場合、「既知の訪問」という訪問バッジを作成して、いずれかの訪問IDの存在を確認することが重要です。この属性を使用することで、Facebookに渡すことができる訪問IDが割り当てられた訪問のみを含むオーディエンスを保証します。未知の訪問をターゲットにすることはできません。

「既知の訪問」バッジを他の条件と組み合わせて、コネクタ用のオーディエンスを作成します。

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

テスト

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

FAQ

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

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

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

Facebookオーディエンスアカウントにアクセス権を持つユーザーとしてFacebookにログインします。
https://www.facebook.com/adsmanager/audiencesにアクセスします。
探しているオーディエンスを見つけて、オーディエンスIDをコピーします。

オーディエンスIDが表示されない場合は、テーブルの列ビューを変更してそれを含めることができます。
AudienceStreamに戻り、AudienceStreamコネクタのカスタム値としてオーディエンスIDを入力します。