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

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

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

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

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

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

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

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

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

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

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

連絡先情報

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

Mobile ID

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