Method: customers.generateAudienceOverlapInsights

잠재고객 속성 모음과 함께 잠재적인 YouTube 도달범위와 지정된 입력 속성 간의 중복 추정치를 반환합니다.

발생한 오류 목록: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP 요청

POST https://googleads.googleapis.com/v17/customers/{customerId}:generateAudienceOverlapInsights

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
customerId

string

필수 항목입니다. 고객의 ID입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "countryLocation": {
    object (LocationInfo)
  },
  "primaryAttribute": {
    object (AudienceInsightsAttribute)
  },
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
필드
countryLocation

object (LocationInfo)

필수 항목입니다. 잠재고객의 규모 및 중복을 계산할 국가입니다.
primaryAttribute

object (AudienceInsightsAttribute)

필수 항목입니다. 조건을 충족하는 다른 모든 잠재고객과 교차해야 하는 잠재고객 속성입니다. 관심분야 또는 구매 의도 사용자 관심분야, AgeRange 또는 Gender여야 합니다.
dimensions[]

enum (AudienceInsightsDimension)

필수 항목입니다. primaryAttribute와 겹치는 부분을 계산할 속성의 유형입니다. 값은 AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, AGE_RANGE, GENDER의 하위 집합이어야 합니다.
customerInsightsGroup

string

계획된 고객의 이름입니다. 사용자 정의 값입니다.

응답 본문

AudienceInsightsService.GenerateAudienceOverlapInsights의 응답 메시지입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "primaryAttributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "dimensionResults": [
    {
      object (DimensionOverlapResult)
    }
  ]
}
필드
primaryAttributeMetadata

object (AudienceInsightsAttributeMetadata)

잠재적인 YouTube 도달범위를 포함한 기본 속성의 메타데이터입니다.
dimensionResults[]

object (DimensionOverlapResult)

속성 및 기본 속성과 중복되는 속성 목록(요청된 측정기준당 하나의 목록)

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/adwords

자세한 내용은 OAuth 2.0 개요를 참고하세요.

DimensionOverlapResult

기본 속성과의 중복을 포함하여 단일 측정기준의 잠재고객 속성 목록으로, GenerateAudienceOverlapInsightsResponse의 일부로 반환됩니다.

JSON 표현 
{
  "dimension": enum (AudienceInsightsDimension),
  "items": [
    {
      object (AudienceOverlapItem)
    }
  ]
}
필드
dimension

enum (AudienceInsightsDimension)

이 섹션에 있는 모든 속성의 측정기준입니다.
items[]

object (AudienceOverlapItem)

속성 및 기본 속성과 겹칩니다.

AudienceOverlapItem

이 속성의 잠재적인 YouTube 도달범위와 기본 속성의 중복 도달범위를 포함한 메타데이터가 포함된 잠재고객 속성입니다.

JSON 표현 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "potentialYoutubeReachIntersection": string
}
필드
attributeMetadata

object (AudienceInsightsAttributeMetadata)

잠재적인 YouTube 도달범위를 포함한 속성 및 메타데이터입니다.
potentialYoutubeReachIntersection

string (int64 format)

이 잠재고객 속성과 기본 속성이 교차하는 부분, 즉 기본 속성과 이 속성 모두 일치하는 도달 가능한 YouTube 사용자 수의 예상 크기입니다.