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

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"
      }
    ]
  }
}

モバイル ID

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

ユーザー ID

{
  "userIdData": {
    "userId": "user_987654321"
  }
}