傳送 IngestAudienceMembersRequest,將成員上傳至目標顧客比對目標對象。
如要設定及傳送要求,請完成下列步驟:
將
termsOfService欄位設為TermsOfService訊息,並將customerMatchTermsOfServiceStatus設為ACCEPTED,確認operatingAccount已接受目標顧客比對服務條款。針對
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。
按照「傳送目標對象成員」一文中的步驟,傳送目標顧客比對資料。
目標對象成員範例
下列範例說明如何為各類型的成員資料建構 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"
}
}