잠재고객에 회원 업로드

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

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

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

2. audienceMembers 목록의 각 AudienceMember에서 업로드에 포함된 데이터 유형에 따라 데이터 필드를 설정합니다.

   • 업로드에 연락처 정보가 포함되어 있으면 compositeData 필드를 CompositeData 객체로 설정하고 해당 userData 필드를 UserData 객체로 설정합니다. 잠재고객 구성원의 각 식별자에 대해 userIdentifiers 목록에 별도의 항목을 추가합니다.

     userData 는 계속 지원되지만 향후 개선사항에 대비하여 통합을 준비하려면 compositeData 를 사용하는 것이 좋습니다. 자세한 내용은 복합 데이터를 참고하세요.

   • 업로드에 Mobile ID가 포함되어 있으면 mobileData 필드를 MobileData 메시지로 설정합니다. 잠재고객 구성원의 각 Mobile ID에 대해 mobileIds 목록에 별도의 항목을 추가합니다.

3. 잠재고객 구성원 전송 의 단계에 따라 고객 매치 타겟팅 데이터를 전송합니다.

잠재고객 구성원 샘플

다음 예에서는 각 구성원 데이터 유형에 대해 AudienceMember 객체를 구성하는 방법을 보여줍니다. 단일 요청의 모든 AudienceMember는 동일한 유형의 ID 데이터 세트 (compositeData, mobileData)를 가져야 합니다.

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    }
  }
}

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