Audience

잠재고객은 상세한 인구통계, 관심분야 등 다양한 세그먼트 속성을 교차하여 타겟 세그먼트의 섹션을 나타내는 잠재고객을 만들 수 있는 효과적인 타겟팅 옵션입니다.

JSON 표현 
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "name": string,
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  }
}
필드
resourceName

string

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

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

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

enum (AudienceStatus)

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

string

필수 항목입니다. 잠재고객의 이름입니다. 모든 잠재고객에 걸쳐 고유해야 합니다. 길이는 1~255자여야 합니다.
description

string

잠재고객에 대한 설명입니다.
dimensions[]

object (AudienceDimension)

잠재고객 구성을 지정하는 포함 측정기준입니다.
exclusionDimension

object (AudienceExclusionDimension)

잠재고객 구성을 지정하는 음수 측정기준입니다.

AudienceStatus

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

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

AudienceDimension

사용자의 잠재고객을 지정하는 양수 측정기준입니다.

JSON 표현 
{

  // Union field dimension can be only one of the following:
  "age": {
    object (AgeDimension)
  },
  "gender": {
    object (GenderDimension)
  },
  "householdIncome": {
    object (HouseholdIncomeDimension)
  },
  "parentalStatus": {
    object (ParentalStatusDimension)
  },
  "audienceSegments": {
    object (AudienceSegmentDimension)
  }
  // End of list of possible types for union field dimension.
}
필드
통합 필드 dimension. 잠재고객에 속한 사용자를 지정하는 측정기준입니다. dimension은 다음 중 하나여야 합니다.
age

object (AgeDimension)

연령별로 사용자를 지정하는 측정기준입니다.
gender

object (GenderDimension)

성별로 사용자를 지정하는 측정기준입니다.
householdIncome

object (HouseholdIncomeDimension)

가계 소득별로 사용자를 지정하는 측정기준입니다.
parentalStatus

object (ParentalStatusDimension)

자녀 유무를 기준으로 사용자를 지정하는 측정기준입니다.
audienceSegments

object (AudienceSegmentDimension)

다른 잠재고객 세그먼트의 멤버십으로 사용자를 지정하는 측정기준입니다.

AgeDimension

연령별로 사용자를 지정하는 측정기준입니다.

JSON 표현 
{
  "ageRanges": [
    {
      object (AgeSegment)
    }
  ],
  "includeUndetermined": boolean
}
필드
ageRanges[]

object (AgeSegment)

측정기준에 포함될 인접한 연령대입니다.
includeUndetermined

boolean

연령이 결정되지 않은 사용자를 포함합니다.

AgeSegment

인접한 연령대입니다.

JSON 표현 
{
  "minAge": integer,
  "maxAge": integer
}
필드
minAge

integer

포함할 수 있는 최소 연령입니다. 최소 연령을 지정해야 하며 만 18세 이상이어야 합니다. 허용되는 값은 18, 25, 35, 45, 55, 65입니다.
maxAge

integer

포함할 최대 연령입니다. 최대 연령은 지정하지 않아도 됩니다. 지정된 경우 maxAge는 minAge보다 커야 하며, 허용되는 값은 24, 34, 44, 54, 64입니다.

GenderDimension

성별로 사용자를 지정하는 측정기준입니다.

JSON 표현 
{
  "genders": [
    enum (GenderType)
  ],
  "includeUndetermined": boolean
}
필드
genders[]

enum (GenderType)

성별 인구통계 세그먼트가 포함되었습니다.
includeUndetermined

boolean

성별이 결정되지 않은 사용자를 포함합니다.

HouseholdIncomeDimension

가계 소득별로 사용자를 지정하는 측정기준입니다.

JSON 표현 
{
  "incomeRanges": [
    enum (IncomeRangeType)
  ],
  "includeUndetermined": boolean
}
필드
incomeRanges[]

enum (IncomeRangeType)

가계 소득 인구통계 세그먼트가 포함되었습니다.
includeUndetermined

boolean

가계 소득이 결정되지 않은 사용자를 포함합니다.

ParentalStatusDimension

자녀 유무를 기준으로 사용자를 지정하는 측정기준입니다.

JSON 표현 
{
  "parentalStatuses": [
    enum (ParentalStatusType)
  ],
  "includeUndetermined": boolean
}
필드
parentalStatuses[]

enum (ParentalStatusType)

자녀 유무 인구통계 세그먼트가 포함되었습니다.
includeUndetermined

boolean

자녀 유무가 확인되지 않은 사용자를 포함합니다.

AudienceSegmentDimension

다른 잠재고객 세그먼트의 멤버십으로 사용자를 지정하는 측정기준입니다.

JSON 표현 
{
  "segments": [
    {
      object (AudienceSegment)
    }
  ]
}
필드
segments[]

object (AudienceSegment)

포함된 잠재고객 세그먼트입니다. 사용자가 하나 이상의 세그먼트에 속하는 경우 포함됩니다.

AudienceSegment

포함 잠재고객 세그먼트

JSON 표현 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  },
  "userInterest": {
    object (UserInterestSegment)
  },
  "lifeEvent": {
    object (LifeEventSegment)
  },
  "detailedDemographic": {
    object (DetailedDemographicSegment)
  },
  "customAudience": {
    object (CustomAudienceSegment)
  }
  // End of list of possible types for union field segment.
}
필드
통합 필드 segment. 포함 세그먼트 segment은 다음 중 하나여야 합니다.
userList

object (UserListSegment)

사용자 목록 세그먼트입니다.
userInterest

object (UserInterestSegment)

관심분야 또는 구매 의도 세그먼트
lifeEvent

object (LifeEventSegment)

실시간 이벤트 잠재고객 세그먼트입니다.
detailedDemographic

object (DetailedDemographicSegment)

상세 인구통계 세그먼트입니다.
customAudience

object (CustomAudienceSegment)

맞춤 잠재고객 세그먼트

UserListSegment

사용자 목록 세그먼트입니다. 2023년 5월부터 유사 잠재고객 서비스가 종료됩니다. 다른 옵션은 https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html을 참고하세요.

JSON 표현 
{
  "userList": string
}
필드
userList

string

사용자 목록 리소스입니다.

UserInterestSegment

사용자 관심분야 세그먼트입니다.

JSON 표현 
{
  "userInterestCategory": string
}
필드
userInterestCategory

string

사용자 관심분야 리소스입니다.

LifeEventSegment

실시간 이벤트 세그먼트

JSON 표현 
{
  "lifeEvent": string
}
필드
lifeEvent

string

생애 주요 이벤트 리소스입니다.

DetailedDemographicSegment

상세 인구통계 세그먼트입니다.

JSON 표현 
{
  "detailedDemographic": string
}
필드
detailedDemographic

string

상세 인구통계 리소스입니다.

CustomAudienceSegment

맞춤 잠재고객 세그먼트

JSON 표현 
{
  "customAudience": string
}
필드
customAudience

string

맞춤 잠재고객 리소스입니다.

AudienceExclusionDimension

잠재고객에서 제외할 사용자를 지정하는 제외 측정기준입니다.

JSON 표현 
{
  "exclusions": [
    {
      object (ExclusionSegment)
    }
  ]
}
필드
exclusions[]

object (ExclusionSegment)

제외할 잠재고객 세그먼트입니다.

ExclusionSegment

잠재고객에서 제외할 잠재고객 세그먼트입니다.

JSON 표현 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  }
  // End of list of possible types for union field segment.
}
필드
통합 필드 segment. 제외할 세그먼트입니다. segment은 다음 중 하나여야 합니다.
userList

object (UserListSegment)

제외할 사용자 목록 세그먼트입니다.