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

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

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

모바일 ID 목록

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

uploadKeyTypes

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

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

mobileIdInfo

MobileIdInfo 메시지로 설정합니다.

  • DataSourceType enum에서 적절한 값으로 dataSourceType를 설정합니다.

  • keySpace을 IOS 또는 ANDROID로 설정합니다.

  • 데이터가 수집된 모바일 애플리케이션을 고유하게 식별하는 문자열로 appId를 설정합니다.

사용자 ID 목록

사용자 ID를 사용하여 잠재고객 구성원을 정의하려면 다음 필드를 설정하세요.

uploadKeyTypes

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

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

요청 구성

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

  1. parent 필드를 계정의 리소스 이름으로 설정합니다. 리소스 이름은 accountTypes/{accountType}/accounts/{account_id} 형식을 따라야 합니다.

  2. 요청 본문에 대해 구성한 UserList을 사용합니다.

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

사용자 ID

API 탐색기에서 열기 
{
    "description": "Customer Match for user IDs",
    "displayName": "User ID audience",
    "ingestedUserListInfo": {
        "userIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "USER_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

요청 전송

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

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

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

이전
개요
다음
잠재고객에 회원 업로드