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

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

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

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

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

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