Method: customers.generateAudienceCompositionInsights

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

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

HTTP 요청

POST https://googleads.googleapis.com/v16/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 개요를 참고하세요.

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

baselineAudienceShare의 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)

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