CustomAudience

맞춤 잠재고객 관심분야별 사용자 목록입니다.

JSON 표현 
{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}
입력란
resourceName

string

변경할 수 없습니다. 맞춤 잠재고객의 리소스 이름입니다. 맞춤 잠재고객 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/customAudiences/{custom_audience_id}
id

string (int64 format)

출력 전용. 맞춤 잠재고객의 ID입니다.
status

enum (CustomAudienceStatus)

출력 전용. 이 맞춤 잠재고객의 상태입니다. 맞춤 잠재고객의 사용 설정 또는 삭제 여부를 나타냅니다.
name

string

맞춤 잠재고객의 이름입니다. 고객이 만든 모든 맞춤 잠재고객에 대해 고유해야 합니다. 이 필드는 작업을 만드는 데 필요합니다.
type

enum (CustomAudienceType)

맞춤 잠재고객의 유형입니다. ('INTEREST' 또는 'PURCHASE_INTENT'는 새로 만든 맞춤 잠재고객에는 허용되지 않지만 기존 잠재고객에는 유지됩니다.)
description

string

이 맞춤 잠재고객에 대한 설명입니다.
members[]

object (CustomAudienceMember)

이 맞춤 잠재고객이 구성되어 있는 맞춤 잠재고객 구성원의 목록입니다. CustomAudience 생성 중에 구성원을 추가할 수 있습니다. UPDATE 작업에 구성원이 표시되면 기존 구성원이 재정의됩니다.

CustomAudienceStatus

가능한 맞춤 잠재고객 상태를 포함하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ENABLED 사용 설정 상태 - 맞춤 잠재고객이 사용 설정되었으며 타겟팅할 수 있습니다.
REMOVED 삭제됨 상태 - 맞춤 잠재고객이 삭제되어 타겟팅에 사용할 수 없습니다.

CustomAudienceType

가능한 맞춤 잠재고객 유형을 포함하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
AUTO 광고 게재 시 Google Ads에서 최적의 해석을 자동으로 선택합니다.
INTEREST 관심분야를 기준으로 사용자를 일치시킵니다.
PURCHASE_INTENT 검색하는 주제 또는 구매를 고려 중인 제품을 기준으로 사용자를 일치시킵니다.
SEARCH Google 검색에서 사용자가 검색한 내용을 기준으로 사용자를 일치시킵니다.

CustomAudienceMember

맞춤 잠재고객의 구성원입니다. KEYWORD, URL, PLACE_CATEGORY 또는 APP이(가) 될 수 있습니다. 만들거나 삭제할 수만 있으며 변경할 수는 없습니다.

JSON 표현 
{
  "memberType": enum (CustomAudienceMemberType),

  // Union field value can be only one of the following:
  "keyword": string,
  "url": string,
  "placeCategory": string,
  "app": string
  // End of list of possible types for union field value.
}
입력란
memberType

enum (CustomAudienceMemberType)

맞춤 잠재고객 구성원의 유형(KEYWORD, URL, PLACE_CATEGORY 또는 APP)입니다.
통합 필드 value. CustomAudienceMember 값입니다. 구성원 유형에 따라 필드 하나가 채워집니다. value은 다음 중 하나여야 합니다.
keyword

string

키워드 또는 키워드 문구 — 최대 10단어 및 80자 한국어, 중국어, 일본어와 같이 2바이트 문자를 사용하는 언어의 경우 사용자의 관심분야나 행동을 나타내는 40자(영문 기준)가 허용됩니다.
url

string

프로토콜이 포함된 HTTP URL — 최대 2048자(영문 기준)로, 사용자가 관심을 보이는 콘텐츠를 포함합니다.
placeCategory

string (int64 format)

사용자가 방문하는 장소 카테고리별로 설명된 장소 유형입니다.
app

string

사용자가 설치한 Android 앱의 패키지 이름입니다(예: com.google.example).

CustomAudienceMemberType

가능한 맞춤 잠재고객 구성원 유형을 포함하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
KEYWORD 키워드로 관심분야 또는 액션을 설명한 사용자입니다.
URL 웹사이트 콘텐츠에 관심이 있는 사용자입니다.
PLACE_CATEGORY 장소 카테고리별로 설명된 장소 유형을 방문하는 사용자입니다.
APP 모바일 앱을 설치한 사용자입니다.