將成員上傳至目標對象

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

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

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

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

    • 如果上傳內容包含聯絡資訊,請將 compositeData 欄位設為 CompositeData 物件,並將其 userData 欄位設為 UserData 物件。在 userIdentifiers 清單中,為目標對象成員的每個 ID 新增一筆獨立項目。

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

    • 如果上傳內容包含 Mobile ID,請將 mobileData 欄位設為 MobileData 訊息。在 mobileIds 清單中,為目標對象成員的每個數位身分證件新增一筆項目。

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

目標對象成員範例

以下範例說明如何為每種成員資料類型建構 AudienceMember 物件。單一要求中的每個 AudienceMember 都必須設定相同類型的 ID 資料 (compositeData、mobileData):

聯絡資訊

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

數位身分證件

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