IngestAudienceMembersRequest를 전송하여 고객 매치 타겟팅 잠재고객에 구성원을 업로드합니다.
요청을 구성하고 전송하려면 다음 단계를 완료하세요.
operatingAccount가 고객 매치 타겟팅 서비스 약관에 동의했음을 확인하려면customerMatchTermsOfServiceStatus가ACCEPTED로 설정된TermsOfService메시지로termsOfService필드를 설정합니다.audienceMembers목록의 각AudienceMember에서 업로드에 포함된 데이터 유형에 따라 데이터 필드를 설정합니다.업로드에 연락처 정보, IP 주소 데이터 또는 둘 다 포함되어 있는 경우
compositeData필드를CompositeData객체로 설정합니다. 연락처 정보의 경우userData필드를UserData객체로 설정하고 잠재고객 구성원의 각 식별자에 대해userIdentifiers목록에 별도의 항목을 추가합니다. IP 주소 데이터의 경우 잠재고객 구성원의 각 IP 주소에 대해ipData목록에IpData항목을 추가합니다.userData는 계속 지원되지만 향후 개선사항에 통합이 대비되도록 하려면compositeData를 사용하는 것이 좋습니다. 자세한 내용은 복합 데이터를 참고하세요.업로드에 Mobile ID가 포함되어 있는 경우
mobileData필드를MobileData메시지로 설정합니다. 잠재고객 구성원의 각 Mobile ID에 대해mobileIds목록에 별도의 항목을 추가합니다.업로드에 사용자 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"
}
]
}
}
모바일 ID
{
"mobileData": {
"mobileIds": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
}
사용자 ID
{
"userIdData": {
"userId": "user_987654321"
}
}