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)

필수입니다. 다른 모든 대상 잠재고객과 교차해야 하는 잠재고객 속성입니다. 관심분야 또는 구매 의도 잠재고객, 연령대 또는 성별이어야 합니다.
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 Overview를 참고하세요.

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 사용자 수입니다.