잠재고객에 회원 업로드

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

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

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

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

모바일 ID

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

사용자 ID

{
  "userIdData": {
    "userId": "user_987654321"
  }
}