잠재고객에 회원 업로드

IngestAudienceMembersRequest를 전송하여 고객 매치 타겟팅 잠재고객에 회원을 업로드합니다.

요청을 구성하고 전송하려면 다음 단계를 완료합니다.

1. termsOfService 필드를 TermsOfService 메시지로 설정하고 customerMatchTermsOfServiceStatus를 ACCEPTED로 설정하여 operatingAccount가 고객 매치 타겟팅 서비스 약관에 동의했음을 확인합니다.

2. 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로 설정합니다.

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"
  }
}