將成員上傳至目標對象

傳送 IngestAudienceMembersRequest,將成員上傳至目標顧客比對目標對象。

如要設定及傳送要求,請完成下列步驟:

  1. 將 termsOfService 欄位設為 TermsOfService 訊息,並將 customerMatchTermsOfServiceStatus 設為 ACCEPTED,確認 operatingAccount 已接受目標顧客比對服務條款。

  2. 針對 audienceMembers 清單中的每個 AudienceMember,根據上傳內容包含的資料類型設定資料欄位:

    • 如果上傳內容包含聯絡資訊、IP 位址資料或兩者,請將 compositeData 欄位設為 CompositeData 物件。如果是聯絡資訊,請將 userData 欄位設為 UserData 物件,並在 userIdentifiers 清單中為目標對象成員的每個 ID 分別新增一筆項目。如果是 IP 位址資料,請在目標對象成員的每個 IP 位址中,於 ipData 清單中新增 IpData 項目。

      雖然我們仍支援 userData,但建議您使用 compositeData,確保整合功能已準備好因應日後的改善。詳情請參閱「複合資料」。

    • 如果上傳內容包含行動 ID,請將「mobileData」欄位設為 MobileData 訊息。在 mobileIds 清單中,為每位目標對象成員的行動 ID 新增個別項目。

    • 如果上傳內容包含使用者 ID,請將 userIdData 欄位設為 UserIdData 訊息,並將 userId 欄位設為目標對象成員的使用者 ID。

  3. 按照「傳送目標對象成員」一文中的步驟,傳送目標顧客比對資料。

目標對象成員範例

下列範例說明如何為各類型的成員資料建構 AudienceMember 物件。單一要求中的每個 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"
      }
    ]
  }
}

數位身分證件

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

使用者 ID

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