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)

맞춤 잠재고객의 유형입니다. ('관심분야' 또는 '구매 의도'는 새로 생성된 맞춤 잠재고객에는 허용되지 않지만 기존 잠재고객에는 유지됨)
description

string

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

object (CustomAudienceMember)

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

CustomAudienceStatus

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

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

CustomAudienceType

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

열거형
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(프로토콜 포함) - 최대 2,048자(영문 기준). 사용자가 관심을 가질 만한 콘텐츠가 포함됩니다.
placeCategory

string (int64 format)

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

string

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

CustomAudienceMemberType

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

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