傳送 IngestAudienceMembersRequest,將成員上傳至目標顧客比對目標對象。
如要設定及傳送要求,請完成下列步驟:
將
termsOfService欄位設為TermsOfService訊息,並將customerMatchTermsOfServiceStatus設為ACCEPTED,確認operatingAccount已接受目標顧客比對服務條款。在
audienceMembers清單中,針對每個AudienceMember,根據上傳內容的資料類型設定資料欄位:如果上傳內容包含聯絡資訊,請將
compositeData欄位設為CompositeData物件,並將其userData欄位設為UserData物件。在userIdentifiers清單中,為目標對象成員的每個 ID 新增一筆獨立項目。雖然我們仍支援
userData,但建議使用compositeData,確保整合功能已為日後的改良作業做好準備。詳情請參閱「複合資料」。如果上傳內容包含 Mobile ID,請將
mobileData欄位設為MobileData訊息。在mobileIds清單中,為目標對象成員的每個數位身分證件新增一筆項目。
按照「傳送目標對象成員」一節的步驟,傳送目標顧客比對資料。
目標對象成員範例
以下範例說明如何為每種成員資料類型建構 AudienceMember 物件。單一要求中的每個 AudienceMember 都必須設定相同類型的 ID 資料 (compositeData、mobileData):
聯絡資訊
{
"compositeData": {
"userData": {
"userIdentifiers": [
{
"emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
},
{
"phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
}
]
}
}
}
數位身分證件
{
"mobileData": {
"mobileIds": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
}