- HTTP 请求
- 路径参数
- 请求正文
- 响应正文
- 授权范围
- AudienceCompositionSection
- AudienceCompositionAttribute
- AudienceCompositionMetrics
- AudienceCompositionAttributeCluster
- 试试看!
返回在相关受众群体中表示的一组属性,其中的指标用于比较每个属性在受众群体中所占的份额与其在基准受众群体中所占的份额。
抛出的错误列表:AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
HTTP 请求
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateAudienceCompositionInsights
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
customerId |
必需。客户的 ID。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "audience": { object ( |
字段 | |
---|---|
audience |
必需。要为其请求数据分析的兴趣受众群体。 |
baselineAudience |
要与感兴趣的受众群体进行比较的基准受众群体。 |
dataMonth |
用于数据分析的为期一个月的历史数据范围,格式为“yyyy-mm”。如果未设置,系统将返回最近 30 天数据的数据分析。 |
dimensions[] |
必需。应返回其受众群体构成分析数据的受众群体维度。 |
customerInsightsGroup |
为其规划的客户的名称。这是用户定义的值。 |
响应正文
AudienceInsightsService.GenerateAudienceCompositionInsights
的响应消息。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"sections": [
{
object ( |
字段 | |
---|---|
sections[] |
数据分析报告的内容,分成多个部分。每个部分都与请求中的一个 AudienceInsightsDimension 值相关联。每个维度可以有多个部分。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/adwords
有关详情,请参阅 OAuth 2.0 概览。
AudienceCompositionSection
受众群体构成分析报告中同一类型的相关属性的集合。
JSON 表示法 |
---|
{ "dimension": enum ( |
字段 | |
---|---|
dimension |
此部分的属性类型。 |
topAttributes[] |
与此受众群体最相关的细分受众群。如果维度为 GENDER、AGE_RANGE 或 PARENTAL_STATUS,则此属性列表详尽无遗。 |
clusteredAttributes[] |
此受众群体的其他属性,按聚类分组。仅当维度为 YOUTUBE_CHANNEL 时填充。 |
AudienceCompositionAttribute
包含元数据和指标的受众群体属性。
JSON 表示法 |
---|
{ "attributeMetadata": { object ( |
字段 | |
---|---|
attributeMetadata |
属性及其元数据。 |
metrics |
共享属性的指标并将其编入索引。 |
AudienceCompositionMetrics
受众群体构成分析报告中与属性相关联的份额和指数指标。
JSON 表示法 |
---|
{ "baselineAudienceShare": number, "audienceShare": number, "index": number, "score": number } |
字段 | |
---|---|
baselineAudienceShare |
与属性匹配的基准受众群体所占的比例(介于 0 到 1 之间,含 0 和 1)。 |
audienceShare |
与属性匹配的特定受众群体所占的比例(0 至 1,含 0 和 1)。 |
index |
audienceShare 与 BaselineAudienceShare 的比率,或零(如果此比率未定义或没有意义)。 |
score |
相关性得分,介于 0 到 1 之间(包括 0 和 1)。 |
AudienceCompositionAttributeCluster
受众群体构成分析报告中的一系列相关属性以及元数据和指标。
JSON 表示法 |
---|
{ "clusterDisplayName": string, "clusterMetrics": { object ( |
字段 | |
---|---|
clusterDisplayName |
此属性集群的名称 |
clusterMetrics |
如果与此集群关联的维度是 YOUTUBE_CHANNEL,则 clusterMetrics 是与整个集群关联的指标。对于其他维度,此字段未设置。 |
attributes[] |
构成此集群的各个属性,包含元数据和指标。 |