REST Resource: firstAndThirdPartyAudiences

리소스: FirstAndThirdPartyAudience

타겟팅에 사용되는 퍼스트 파티 또는 서드 파티 잠재고객 목록을 설명합니다. 퍼스트 파티 잠재고객은 고객 데이터를 사용하여 생성됩니다. 서드 파티 잠재고객은 서드 파티 데이터 제공업체에서 제공하며 고객에게만 라이선스를 부여할 수 있습니다.

JSON 표현 
{
  "name": string,
  "firstAndThirdPartyAudienceId": string,
  "displayName": string,
  "description": string,
  "firstAndThirdPartyAudienceType": enum (FirstAndThirdPartyAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string,

  // Union field members can be only one of the following:
  "contactInfoList": {
    object (ContactInfoList)
  },
  "mobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of list of possible types for union field members.
}
입력란
name

string

출력 전용. 퍼스트 파티 및 서드 파티 잠재고객의 리소스 이름입니다.
firstAndThirdPartyAudienceId

string (int64 format)

출력 전용. 퍼스트 파티 잠재고객 및 서드 파티 잠재고객의 고유 ID입니다. 시스템에서 할당합니다.
displayName

string

퍼스트 파티 및 서드 파티 잠재고객의 표시 이름입니다.
description

string

사용자가 제공한 잠재고객에 대한 설명입니다.

퍼스트 파티 잠재고객에게만 적용됩니다.
firstAndThirdPartyAudienceType

enum (FirstAndThirdPartyAudienceType)

잠재고객이 퍼스트 파티 잠재고객인지 또는 서드 파티 잠재고객인지 여부
audienceType

enum (AudienceType)

잠재고객의 유형입니다.
audienceSource

enum (AudienceSource)

출력 전용. 잠재고객의 소스입니다.
membershipDurationDays

string (int64 format)

요건을 충족하는 이벤트 후에도 항목이 잠재고객에 남아 있는 기간(일)입니다. 잠재고객에 만료일이 없는 경우 이 필드의 값을 10000으로 설정합니다. 그렇지 않으면 설정 값이 0보다 크고 540보다 작거나 같아야 합니다.

퍼스트 파티 잠재고객에게만 적용됩니다.

다음 audienceType 중 하나가 사용되는 경우 이 필드가 필요합니다.

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

출력 전용. 디스플레이 네트워크의 예상 잠재고객 규모

크기가 1, 000보다 작으면 숫자는 숨겨지고 개인 정보 보호를 위해 0이 반환됩니다. 그렇지 않은 경우 숫자는 두 개의 유효 자릿수로 반올림됩니다.

GET 요청에서만 반환됩니다.
activeDisplayAudienceSize

string (int64 format)

출력 전용. 지난달 디스플레이 네트워크의 예상 잠재고객 규모입니다.

크기가 1, 000보다 작으면 숫자는 숨겨지고 개인 정보 보호를 위해 0이 반환됩니다. 그렇지 않은 경우 숫자는 두 개의 유효 자릿수로 반올림됩니다.

GET 요청에서만 반환됩니다.
youtubeAudienceSize

string (int64 format)

출력 전용. YouTube 네트워크의 예상 시청자 규모입니다.

크기가 1, 000보다 작으면 숫자는 숨겨지고 개인 정보 보호를 위해 0이 반환됩니다. 그렇지 않은 경우 숫자는 두 개의 유효 자릿수로 반올림됩니다.

퍼스트 파티 잠재고객에게만 적용됩니다.

GET 요청에서만 반환됩니다.
gmailAudienceSize

string (int64 format)

출력 전용. Gmail 네트워크의 예상 잠재고객 규모입니다.

크기가 1, 000보다 작으면 숫자는 숨겨지고 개인 정보 보호를 위해 0이 반환됩니다. 그렇지 않은 경우 숫자는 두 개의 유효 자릿수로 반올림됩니다.

퍼스트 파티 잠재고객에게만 적용됩니다.

GET 요청에서만 반환됩니다.
displayMobileAppAudienceSize

string (int64 format)

출력 전용. 디스플레이 네트워크의 예상 모바일 앱 잠재고객 규모입니다.

크기가 1, 000보다 작으면 숫자는 숨겨지고 개인 정보 보호를 위해 0이 반환됩니다. 그렇지 않은 경우 숫자는 두 개의 유효 자릿수로 반올림됩니다.

퍼스트 파티 잠재고객에게만 적용됩니다.

GET 요청에서만 반환됩니다.
displayMobileWebAudienceSize

string (int64 format)

출력 전용. 디스플레이 네트워크의 예상 모바일 웹 잠재고객의 규모입니다.

크기가 1, 000보다 작으면 숫자는 숨겨지고 개인 정보 보호를 위해 0이 반환됩니다. 그렇지 않은 경우 숫자는 두 개의 유효 자릿수로 반올림됩니다.

퍼스트 파티 잠재고객에게만 적용됩니다.

GET 요청에서만 반환됩니다.
displayDesktopAudienceSize

string (int64 format)

출력 전용. 디스플레이 네트워크의 예상 데스크톱 잠재고객 규모입니다.

크기가 1, 000보다 작으면 숫자는 숨겨지고 개인 정보 보호를 위해 0이 반환됩니다. 그렇지 않은 경우 숫자는 두 개의 유효 자릿수로 반올림됩니다.

퍼스트 파티 잠재고객에게만 적용됩니다.

GET 요청에서만 반환됩니다.
appId

string

appId는 업로드 중인 mobileDeviceId의 유형과 일치합니다.

audienceType CUSTOMER_MATCH_DEVICE_ID에만 해당
통합 필드 members. 고객 일치 타겟팅 잠재고객의 초기 구성원입니다. members은 다음 중 하나여야 합니다.
contactInfoList

object (ContactInfoList)

입력 전용. 초기 잠재고객 구성원을 정의하는 연락처 정보 목록입니다.

audienceType CUSTOMER_MATCH_CONTACT_INFO에만 해당
mobileDeviceIdList

object (MobileDeviceIdList)

입력 전용. 초기 잠재고객 구성원을 정의하는 휴대기기 ID 목록입니다.

audienceType CUSTOMER_MATCH_DEVICE_ID에만 해당

FirstAndThirdPartyAudienceType

퍼스트 파티 및 서드 파티 잠재고객 리소스의 가능한 유형입니다.

열거형
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED 유형을 지정하지 않았거나 알 수 없는 경우의 기본값입니다.
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY 고객 데이터를 사용하여 생성된 잠재고객입니다.
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY 서드 파티 데이터 제공업체에서 제공하는 잠재고객입니다.

AudienceType

가능한 잠재고객 유형입니다.

열거형
AUDIENCE_TYPE_UNSPECIFIED 유형을 지정하지 않았거나 알 수 없는 경우의 기본값입니다.
CUSTOMER_MATCH_CONTACT_INFO 고객을 알려진 연락처 정보와 매칭하여 잠재고객이 생성되었습니다.
CUSTOMER_MATCH_DEVICE_ID 고객을 알려진 휴대기기 ID와 일치시켜 잠재고객이 생성되었습니다.
CUSTOMER_MATCH_USER_ID 고객을 알려진 사용자 ID와 일치시켜 잠재고객이 생성되었습니다.
ACTIVITY_BASED

캠페인 활동을 기반으로 잠재고객이 생성되었습니다.
FREQUENCY_CAP

게재된 노출수를 제외하고 잠재고객이 생성되었습니다.
TAG_BASED 픽셀에 연결된 맞춤 변수를 기반으로 잠재고객이 생성되었습니다.
YOUTUBE_USERS 시청자층은 동영상, YouTube 광고 또는 YouTube 채널을 이용한 기록을 바탕으로 생성되었습니다.
LICENSED 서드 파티 잠재고객 유형의 하위유형입니다.

AudienceSource

가능한 잠재고객 소스입니다.

열거형
AUDIENCE_SOURCE_UNSPECIFIED 잠재고객 소스를 지정하지 않았거나 알 수 없는 경우의 기본값입니다.
DISPLAY_VIDEO_360 Display & Video 360에서 발생했습니다.
CAMPAIGN_MANAGER Campaign Manager 360에서 발생했습니다.
AD_MANAGER Google Ad Manager에서 발생했습니다.
SEARCH_ADS_360 Search Ads 360에서 제공되었습니다.
YOUTUBE 출처가 YouTube입니다.
ADS_DATA_HUB Ads Data Hub에서 발생했습니다.

ContactInfoList

고객 일치 타겟팅 잠재고객 구성원을 정의하는 연락처 정보 목록의 래퍼 메시지입니다.

JSON 표현 
{
  "contactInfos": [
    {
      object (ContactInfo)
    }
  ],
  "consent": {
    object (Consent)
  }
}
입력란
contactInfos[]

object (ContactInfo)

고객 일치 타겟팅 잠재고객 구성원을 정의하는 ContactInfo 객체 목록입니다. contactInfos를 분할한 후의 멤버 크기는 500,000 이하여야 합니다.
consent

object (Consent)

입력 전용. contactInfos의 사용자에 대한 동의 설정입니다.

이 필드를 설정하지 않으면 동의가 지정되지 않음을 나타냅니다.

adUserData 또는 adPersonalization 필드가 CONSENT_STATUS_DENIED로 설정되면 요청에서 오류가 반환됩니다.

ContactInfo

고객 일치 타겟팅 잠재고객 구성원을 정의하는 연락처 정보입니다.

JSON 표현 
{
  "hashedEmails": [
    string
  ],
  "hashedPhoneNumbers": [
    string
  ],
  "zipCodes": [
    string
  ],
  "hashedFirstName": string,
  "hashedLastName": string,
  "countryCode": string
}
입력란
hashedEmails[]

string

구성원의 SHA256 해싱된 이메일 목록입니다. 해싱하기 전에 공백을 모두 삭제하고 문자열이 모두 소문자인지 확인합니다.
hashedPhoneNumbers[]

string

구성원의 SHA256 해싱된 전화번호 목록입니다. 해싱하기 전에 모든 전화번호는 E.164 형식을 사용하여 지정해야 하며 국가 통화 코드를 포함해야 합니다.
zipCodes[]

string

구성원의 우편번호 목록입니다.

다음 필드도 설정해야 합니다.
hashedFirstName

string

SHA256으로 해싱된 구성원의 이름입니다. 해싱하기 전에 공백을 모두 삭제하고 문자열이 모두 소문자인지 확인합니다.

다음 필드도 설정해야 합니다.
hashedLastName

string

SHA256으로 해시된 구성원의 성입니다. 해싱하기 전에 공백을 모두 삭제하고 문자열이 모두 소문자인지 확인합니다.

다음 필드도 설정해야 합니다.
countryCode

string

회원의 국가 코드입니다.

다음 필드도 설정해야 합니다.

ConsentStatus

동의 상태

열거형
CONSENT_STATUS_UNSPECIFIED 이 버전에서 유형 값이 지정되지 않았거나 알 수 없습니다.
CONSENT_STATUS_GRANTED 동의가 부여되었습니다.
CONSENT_STATUS_DENIED 동의가 거부되었습니다.

MobileDeviceIdList

고객 일치 타겟팅 잠재고객 구성원을 정의하는 휴대기기 ID 목록의 래퍼 메시지입니다.

JSON 표현 
{
  "mobileDeviceIds": [
    string
  ],
  "consent": {
    object (Consent)
  }
}
입력란
mobileDeviceIds[]

string

고객 일치 타겟팅 잠재고객 구성원을 정의하는 휴대기기 ID 목록입니다. mobileDeviceId의 크기는 500,000 이하여야 합니다.
consent

object (Consent)

입력 전용. mobileDeviceIds의 사용자에 대한 동의 설정입니다.

이 필드를 설정하지 않으면 동의가 지정되지 않음을 나타냅니다.

adUserData 또는 adPersonalization 필드가 CONSENT_STATUS_DENIED로 설정되면 요청에서 오류가 반환됩니다.

방법

create

 FirstAndThirdPartyAudience를 생성합니다.

editCustomerMatchMembers

 고객 일치 타겟팅 잠재고객의 회원 목록을 업데이트합니다.

get

 퍼스트 파티 및 서드 파티 잠재고객을 가져옵니다.

list

 퍼스트 파티 및 서드 파티 잠재고객을 나열합니다.

patch

 기존 FirstAndThirdPartyAudience를 업데이트합니다.