Method: customers.generateAudienceCompositionInsights

返回在相关受众群体中表示的一组属性，其中的指标用于比较每个属性在受众群体中所占的份额与其在基准受众群体中所占的份额。

抛出的错误列表：AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP 请求

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

网址采用 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

用于数据分析的为期一个月的历史数据范围，格式为“yyyy-mm”。如果未设置，系统将返回最近 30 天数据的数据分析。
dimensions[]

enum (AudienceInsightsDimension)

必需。应返回其受众群体构成分析数据的受众群体维度。
customerInsightsGroup

string

为其规划的客户的名称。这是用户定义的值。

响应正文

AudienceInsightsService.GenerateAudienceCompositionInsights 的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "sections": [
    {
      object (AudienceCompositionSection)
    }
  ]
}
字段
sections[]

object (AudienceCompositionSection)

数据分析报告的内容，分成多个部分。每个部分都与请求中的一个 AudienceInsightsDimension 值相关联。每个维度可以有多个部分。

授权范围

需要以下 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 之间，含 0 和 1）。
audienceShare

number

与属性匹配的特定受众群体所占的比例（0 至 1，含 0 和 1）。
index

number

audienceShare 与 BaselineAudienceShare 的比率，或零（如果此比率未定义或没有意义）。
score

number

相关性得分，介于 0 到 1 之间（包括 0 和 1）。

AudienceCompositionAttributeCluster

受众群体构成分析报告中的一系列相关属性以及元数据和指标。

JSON 表示法 
{
  "clusterDisplayName": string,
  "clusterMetrics": {
    object (AudienceCompositionMetrics)
  },
  "attributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ]
}
字段
clusterDisplayName

string

此属性集群的名称
clusterMetrics

object (AudienceCompositionMetrics)

如果与此集群关联的维度是 YOUTUBE_CHANNEL，则 clusterMetrics 是与整个集群关联的指标。对于其他维度，此字段未设置。
attributes[]

object (AudienceCompositionAttribute)

构成此集群的各个属性，包含元数据和指标。