Method: customers.generateAudienceCompositionInsights

관심 잠재고객에 표시되는 속성 모음을 반환하며, 잠재고객의 각 속성에 대한 점유율을 기준 잠재고객의 비율과 비교하는 측정항목을 사용합니다.

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

HTTP 요청

POST https://googleads.googleapis.com/v14/customers/{customerId}:generateAudienceCompositionInsights

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

경로 매개변수

매개변수
customerId

string

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

요청 본문

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

JSON 표현 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
필드
audience

object (InsightsAudience)

필수 항목입니다. 통계를 요청하는 관심 대상입니다.
baselineAudience

object (InsightsAudience)

관심 있는 잠재고객과 비교되는 기준 잠재고객입니다.
dataMonth

string

통계에 사용할 이전 데이터 기간(1개월)으로, 'yyyy-mm' 형식입니다. 설정하지 않으면 지난 30일간의 데이터에 대한 통계가 반환됩니다.
dimensions[]

enum (AudienceInsightsDimension)

필수 항목입니다. 컴포지션 통계가 반환되어야 하는 잠재고객 측정기준입니다.
customerInsightsGroup

string

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

응답 본문

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

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

JSON 표현 
{
  "sections": [
    {
      object (AudienceCompositionSection)
    }
  ]
}
필드
sections[]

object (AudienceCompositionSection)

섹션으로 구성된 통계 보고서의 콘텐츠입니다. 각 섹션은 요청에 있는 AudienceInsightsDimension 값 중 하나와 연결됩니다. 측정기준당 2개 이상의 섹션이 있을 수 있습니다.

승인 범위

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

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

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

InsightsAudience

다양한 특성으로 정의된 사용자 집합으로, AudienceInsightsService에서 통계를 요청할 수 있습니다.

JSON 표현 
{
  "countryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "incomeRanges": [
    {
      object (IncomeRangeInfo)
    }
  ],
  "dynamicLineups": [
    {
      object (AudienceInsightsDynamicLineup)
    }
  ],
  "topicAudienceCombinations": [
    {
      object (InsightsAudienceAttributeGroup)
    }
  ]
}
필드
countryLocations[]

object (LocationInfo)

필수 항목입니다. 잠재고객의 국가입니다.
subCountryLocations[]

object (LocationInfo)

국가 내 지리적 위치 속성입니다. 있는 경우 이러한 각 항목은 이 잠재고객에 포함된 국가 중 하나에 포함되어야 합니다. 이 열이 없으면 잠재고객은 지역적으로 countryLocations에 있고 그 이상은 없습니다.
gender

object (GenderInfo)

잠재고객의 성별입니다. 이 항목이 없으면 잠재고객이 성별로 제한되지 않습니다.
ageRanges[]

object (AgeRangeInfo)

잠재고객의 연령대입니다. 표시되지 않는 경우 잠재고객은 다른 속성과 일치하는 만 18세 이상의 모든 사용자를 나타냅니다.
parentalStatus

object (ParentalStatusInfo)

잠재고객의 자녀 유무입니다. 이 항목이 없으면 잠재고객이 자녀 유무로 인해 제한되지 않습니다.
incomeRanges[]

object (IncomeRangeInfo)

잠재고객의 가계 소득 백분위수 범위입니다. 이 항목이 없으면 잠재고객이 가계 소득 범위로 제한되지 않습니다.
dynamicLineups[]

object (AudienceInsightsDynamicLineup)

시청자가 조회한 YouTube 콘텐츠를 나타내는 동적 라인업
topicAudienceCombinations[]

object (InsightsAudienceAttributeGroup)

잠재고객을 정의하는 항목, 카테고리, 사용자 관심분야 속성의 조합입니다. 이 조합은 논리적 AND-of-OR 구조를 갖습니다. 각 InsightsAudienceAttributeGroup 내의 속성은 OR로 결합되며 조합 자체는 AND로 결합됩니다. 예를 들어 (항목 OR 관심분야) AND (구매 의도 OR 카테고리) 표현식은 각각 두 개의 속성이 있는 두 개의 InsightsAudienceAttributeGroups를 사용하여 구성할 수 있습니다.

InsightsAudienceAttributeGroup

AudienceInsightsAttributes의 목록입니다.

JSON 표현 
{
  "attributes": [
    {
      object (AudienceInsightsAttribute)
    }
  ]
}
필드
attributes[]

object (AudienceInsightsAttribute)

필수 항목입니다. 논리적 OR과 결합할 잠재고객 속성의 모음입니다. 속성은 모두 동일한 측정기준일 필요는 없습니다. 이 컨텍스트에서는 지식 그래프 항목, 제품 및 서비스 카테고리, 관심분야 잠재고객 및 구매 의도 잠재고객만 지원됩니다.

AudienceCompositionSection

잠재고객 구성 통계 보고서에 있는 동일한 유형의 관련 속성 모음입니다.

JSON 표현 
{
  "dimension": enum (AudienceInsightsDimension),
  "topAttributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ],
  "clusteredAttributes": [
    {
      object (AudienceCompositionAttributeCluster)
    }
  ]
}
필드
dimension

enum (AudienceInsightsDimension)

이 섹션에 있는 속성의 유형입니다.
topAttributes[]

object (AudienceCompositionAttribute)

이 잠재고객과 가장 관련성이 높은 세그먼트입니다. 측정기준이 GENDER, AGE_RANGE 또는 PARENTAL_STATUS인 경우 이 속성 목록은 완전합니다.
clusteredAttributes[]

object (AudienceCompositionAttributeCluster)

이 잠재고객의 추가 속성으로, 클러스터로 그룹화됩니다. 측정기준이 YOUTUBE_CHANNEL인 경우에만 채워집니다.

AudienceCompositionAttribute

메타데이터 및 측정항목이 포함된 잠재고객 속성입니다.

JSON 표현 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "metrics": {
    object (AudienceCompositionMetrics)
  }
}
필드
attributeMetadata

object (AudienceInsightsAttributeMetadata)

메타데이터가 있는 속성입니다.
metrics

object (AudienceCompositionMetrics)

속성의 점유율 및 색인 측정항목입니다.

AudienceCompositionMetrics

잠재고객 구성 통계 보고서의 속성과 연결된 점유율 및 지수 측정항목입니다.

JSON 표현 
{
  "baselineAudienceShare": number,
  "audienceShare": number,
  "index": number,
  "score": number
}
필드
baselineAudienceShare

number

속성과 일치하는 기준 잠재고객의 비율 (0 이상 1 포함)입니다.
audienceShare

number

속성과 일치하는 특정 잠재고객의 비율 (0 이상 1 포함)입니다.
index

number

기준잠재고객 공유에 대한 AudienceShare의 비율 또는 이 비율이 정의되지 않았거나 의미가 없는 경우 0입니다.
score

number

관련성 점수로, 0 이상 1 이하의 값입니다.

AudienceCompositionAttributeCluster

잠재고객 구성 통계 보고서의 메타데이터 및 측정항목이 포함된 관련 속성 모음입니다.

JSON 표현 
{
  "clusterDisplayName": string,
  "clusterMetrics": {
    object (AudienceCompositionMetrics)
  },
  "attributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ]
}
필드
clusterDisplayName

string

이 속성 클러스터의 이름
clusterMetrics

object (AudienceCompositionMetrics)

이 클러스터와 연결된 측정기준이 YOUTUBE_CHANNEL인 경우 clusterMetrics는 클러스터 전체와 연결된 측정항목입니다. 다른 측정기준의 경우 이 필드가 설정되지 않습니다.
attributes[]

object (AudienceCompositionAttribute)

메타데이터 및 측정항목과 함께 이 클러스터를 구성하는 개별 속성입니다.