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)

대상 이벤트 후에도 참가작이 잠재고객에 남아 있는 기간(일)입니다. 잠재고객에 만료일이 없는 경우 이 필드의 값을 10, 000으로 설정합니다. 그 외의 경우 설정 값은 0보다 크고 540보다 작아야 합니다.

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

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

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

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

크기가 1,000 미만이면 개인 정보 보호를 위해 숫자가 숨겨지고 0이 반환됩니다. 그렇지 않으면 숫자가 유효 자릿수 2자리로 반올림됩니다.

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이 반환됩니다. 그렇지 않으면 숫자가 유효 자릿수 2자리로 반올림됩니다.

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

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

string (int64 format)

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

크기가 1,000 미만이면 개인 정보 보호를 위해 숫자가 숨겨지고 0이 반환됩니다. 그렇지 않으면 숫자가 유효 자릿수 2자리로 반올림됩니다.

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

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

string (int64 format)

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

크기가 1,000 미만이면 개인 정보 보호를 위해 숫자가 숨겨지고 0이 반환됩니다. 그렇지 않으면 숫자가 유효 자릿수 2자리로 반올림됩니다.

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

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

string (int64 format)

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

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

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

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

string

appId가 업로드되는 mobileDeviceIds 유형과 일치합니다.

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 목록입니다. mobileDeviceIds의 크기는 500,000 이하여야 합니다.
consent

object (Consent)

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

이 필드를 설정하지 않으면 동의가 지정되지 않은 것입니다.

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

메서드

create

 FirstAndThirdPartyAudience를 만듭니다.

editCustomerMatchMembers

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

get

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

list

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

patch

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