オーディエンスにメンバーをアップロードする

IngestAudienceMembersRequest を送信して、カスタマー マッチ オーディエンスにメンバーをアップロードします。

リクエストを構成して送信する手順は次のとおりです。

  1. termsOfService フィールドを TermsOfService メッセージに設定し、customerMatchTermsOfServiceStatus を ACCEPTED に設定して、operatingAccount がカスタマー マッチの利用規約に同意したことを確認します。

  2. audienceMembers リストの各 AudienceMember で、アップロードに含まれるデータの種類に基づいてデータ フィールドを設定します。

    • アップロードに連絡先情報、IP アドレスデータ、またはその両方が含まれている場合は、compositeData フィールドを CompositeData オブジェクトに設定します。連絡先情報の場合は、userData フィールドを UserData オブジェクトに設定し、オーディエンス メンバーの識別子ごとに userIdentifiers リストに個別のエントリを追加します。IP アドレスデータの場合は、オーディエンス メンバーの IP アドレスごとに、ipData リストに IpData エントリを追加します。

      userData は引き続きサポートされますが、今後の改善に備えて compositeData を使用することをおすすめします。詳細については、複合データをご覧ください。

    • アップロードにモバイル ID が含まれている場合は、mobileData フィールドを MobileData メッセージに設定します。オーディエンス メンバーの Mobile ID ごとに、mobileIds リストに個別のエントリを追加します。

    • アップロードにユーザー ID が含まれている場合は、userIdData フィールドを UserIdData メッセージに設定し、userId フィールドをオーディエンス メンバーのユーザー ID に設定します。

  3. オーディエンス メンバーを送信するの手順に沿って、カスタマー マッチ データを送信します。

オーディエンス メンバーのサンプル

次の例は、メンバーデータのタイプごとに AudienceMember オブジェクトを構造化する方法を示しています。1 つのリクエスト内のすべての AudienceMember には、同じタイプの ID データ（compositeData、mobileData、userIdData）を設定する必要があります。

連絡先情報

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    }
  }
}

IP アドレスのデータ

{
  "compositeData": {
    "ipData": [
      {
        "ipAddress": "203.0.113.98",
        "observeStartTime": "2026-06-10T20:17:52.0-04:00",
        "observeEndTime": "2026-06-17T04:02:04.123-04:00"
      }
    ]
  }
}

連絡先と IP データ

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    },
    "ipData": [
      {
        "ipAddress": "203.0.113.98",
        "observeStartTime": "2026-06-10T20:17:52.0-04:00",
        "observeEndTime": "2026-06-17T04:02:04.123-04:00"
      }
    ]
  }
}

Mobile ID

{
  "mobileData": {
    "mobileIds": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
}

ユーザー ID

{
  "userIdData": {
    "userId": "user_987654321"
  }
}
前へ
ユーザーリストの作成
次へ
アップロード結果を確認する