REST Resource: firstPartyAndPartnerAudiences

리소스: FirstPartyAndPartnerAudience

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

JSON 표현 
{
  "name": string,
  "firstPartyAndPartnerAudienceId": string,
  "displayName": string,
  "description": string,
  "firstPartyAndPartnerAudienceType": enum (FirstPartyAndPartnerAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string
}
필드
name

string

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

string (int64 format)

식별자. 퍼스트 파티 및 파트너 잠재고객의 고유 ID입니다. 시스템에서 할당합니다.
displayName

string

선택사항입니다. 퍼스트 파티 및 파트너 잠재고객의 표시 이름입니다.
description

string

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

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

enum (FirstPartyAndPartnerAudienceType)

출력 전용입니다. 잠재고객이 퍼스트 파티 및 파트너 잠재고객인지 여부입니다.
audienceType

enum (AudienceType)

변경할 수 없습니다. 잠재고객의 유형입니다.
audienceSource

enum (AudienceSource)

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

string (int64 format)

선택사항입니다. 자격 요건을 충족하는 이벤트가 발생한 후 항목이 잠재고객에 남아 있는 기간(일)입니다. 설정 값은 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가 업로드 중인 mobileDeviceIds의 유형과 일치합니다.

audienceType CUSTOMER_MATCH_DEVICE_ID에만 적용됩니다.

FirstPartyAndPartnerAudienceType

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

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

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 채널과의 과거 상호작용을 기반으로 잠재고객이 생성되었습니다.
THIRD_PARTY 잠재고객이 서드 파티로부터 사용 라이선스를 받았습니다.
COMMERCE 커머스 파트너가 유료로 제공하는 잠재고객입니다.
LINEAR 일반 TV 콘텐츠의 시청자입니다.
AGENCY 대행사에서 제공하는 잠재고객입니다.

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에서 시작되었습니다.

메서드

get

 퍼스트 파티 또는 파트너 잠재고객을 가져옵니다.

list

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