고객 일치 타겟팅 잠재고객 만들기

CreateUserListRequest를 전송하여 고객 일치 타겟팅 잠재고객을 만듭니다.

요청 본문 구성

UserList 리소스를 만듭니다. 설정할 일반적인 필드는 다음과 같습니다.

displayName

필수 목록의 표시 이름입니다. 이름은 계정이 소유한 모든 목록 중에서 고유해야 합니다.

description

목록에 대한 간략한 설명입니다.

integrationCode

시스템의 ID입니다.

membershipDuration

잠재고객 구성원이 추가된 후 목록에 남아 있는 기간입니다. 값은 전체 일수에 해당해야 합니다. 설정하지 않으면 기본적으로 최댓값으로 설정됩니다.

JSON을 사용하는 경우 기간(일)에 86400(하루의 초 수)을 곱하여 초 수를 계산합니다. 그런 다음 곱셈 결과에 s를 추가하여 값을 설정합니다. 예를 들어 포함 기간을 90일로 하려면 90 * 86400 = 7776000이므로 7776000s 값을 사용합니다.

프로토콜 버퍼 형식을 사용하는 경우 이러한 편의 메서드가 있으면 일수를 기반으로 Duration 객체를 구성하는 편의 메서드를 사용합니다. 예를 들어 Java용 protobuf-java-util 라이브러리에는 fromDays() 편의 메서드가 있습니다. 그렇지 않으면 기간(일)에 86400(하루의 초 수)을 곱하여 초 수를 계산하고 결과를 사용하여 Duration 객체의 seconds 필드를 설정합니다.

고객 일치 타겟팅에 필요한 필드

고객 일치 타겟팅 잠재고객에는 ingestedUserListInfo 필드가 필요합니다.

목록에 잠재고객 구성원을 추가하는 데 사용할 데이터 유형에 따라 IngestedUserListInfo 에 설정할 필드는 다음과 같습니다.

연락처 정보 목록

연락처 정보 (해싱된 이메일 주소, 전화번호 또는 주소)를 사용하여 잠재고객 구성원을 정의하려면 다음 필드를 설정합니다.

uploadKeyTypes

CONTACT_ID 업로드 키 유형이 포함된 목록으로 설정합니다.

uploadKeyTypes 목록에는 항목이 하나 만 포함되어야 합니다.

contactIdInfo

ContactIdInfo 메시지로 설정합니다. dataSourceType이 DataSourceType enum의 적절한 값으로 설정된

모바일 ID 목록

모바일 ID를 사용하여 잠재고객 구성원을 정의하려면 다음 필드를 설정합니다.

uploadKeyTypes

MOBILE_ID 업로드 키 유형이 포함된 목록으로 설정합니다.

uploadKeyTypes 목록에는 항목이 하나 만 포함되어야 합니다.

mobileIdInfo

메시지로 설정합니다.MobileIdInfo

dataSourceType을 DataSourceType enum의 적절한 값으로 설정합니다.
keySpace를 IOS 또는 ANDROID로 설정합니다.
appId를 데이터가 수집된 모바일 애플리케이션을 고유하게 식별하는 문자열로 설정합니다.
- iOS의 경우 ID 문자열은 App Store URL 뒤에 있는 9자리 문자열입니다. 예를 들어 App Store 링크 https://apps.apple.com/us/app/flood-it/id476943146이 있는 "Flood-It!" 앱의 경우 476943146입니다.
- Android의 경우 ID 문자열은 애플리케이션의 패키지 이름입니다. 예를 들어 Google Play 링크 https://play.google.com/store/apps/details?id=com.labpixies.flood가 있는 'Flood-It!' 앱의 경우 com.labpixies.flood입니다.

요청 구성

고객 일치 타겟팅 잠재고객을 만들려면 create 요청을 UserList 리소스에 대해 구성합니다.

parent 필드를 계정의 리소스 이름으로 설정합니다. 리소스 이름은 accountTypes/{accountType}/accounts/{account_id} 형식을 따라야 합니다.
요청 본문에 대해 구성한 UserList를 사용합니다.
사용자 인증 정보가 parent의 사용자인 Google 계정이 아닌 경우 대상 및 헤더 구성에 설명된 대로 헤더를 설정합니다.

다음은 다양한 유형의 사용자 정보에 대한 JSON 형식의 샘플 요청입니다. 각 요청은 membershipDuration을 2592000s로 설정합니다. 여기서 2592000는 30일의 초 수입니다. API 탐색기에서 열기 버튼을 클릭하여 요청을 시도해 봅니다.

연락처 정보

API 탐색기에서 열기

{
    "description": "Customer Match for contact info",
    "displayName": "Contact info audience",
    "ingestedUserListInfo": {
        "contactIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "CONTACT_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

모바일 ID

API 탐색기에서 열기

{
    "description": "Customer Match for mobile IDs",
    "displayName": "Mobile ID audience",
    "ingestedUserListInfo": {
        "mobileIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY",
            "keySpace": "ANDROID",
            "appId": "com.labpixies.flood"
        },
        "uploadKeyTypes": [
            "MOBILE_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

요청 전송

요청을 전송하고 필요한 경우 요청 헤더를 포함합니다.

요청이 성공하면 응답에 생성된 UserList에 id 및 name이 채워집니다. 잠재고객에 잠재고객 구성원을 추가하는 요청에 필요하므로 이러한 필드의 값을 기록해 둡니다.

요청이 실패하면 오류를 검사하여 실패 원인 을 파악하고, 요청 및 헤더를 업데이트하여 문제를 해결한 후 업데이트된 요청 및 헤더를 전송 합니다.

개요

잠재고객에 회원 업로드