Method: customers.generateSuggestedTargetingInsights

返回一系列与所请求的受众群体相关的定位分析数据（例如可定位的受众群体）。

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

HTTP 请求

POST https://googleads.googleapis.com/v17/customers/{customerId}:generateSuggestedTargetingInsights

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

必需。客户的 ID。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "customerInsightsGroup": string
}
字段
audience

object (InsightsAudience)

必需。请求数据分析的兴趣受众群体。
baselineAudience

object (InsightsAudience)

可选。基准受众群体。如果未指定，则默认为与感兴趣的受众群体位于同一个国家/地区的所有人。
dataMonth

string

可选。要用于数据分析的历史数据的一个月范围，格式为“yyyy-mm”。如果未设置，系统会返回过去 30 天数据的数据分析。
customerInsightsGroup

string

可选。目标客户的名称。这是用户定义的值。

响应正文

AudienceInsightsService.GenerateSuggestedTargetingInsights 的响应消息。

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

JSON 表示法 
{
  "suggestions": [
    {
      object (TargetingSuggestionMetrics)
    }
  ]
}
字段
suggestions[]

object (TargetingSuggestionMetrics)

针对可定位的受众群体的建议数据分析。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅 OAuth 2.0 概览。

TargetingSuggestionMetrics

与所请求的受众群体相关的建议的可定位受众群体。

JSON 表示法 
{
  "locations": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "userInterests": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "coverage": number,
  "index": number,
  "potentialYoutubeReach": string
}
字段
locations[]

object (AudienceInsightsAttributeMetadata)

建议的地理位置定位。这些属性均为维度 GEO_TARGET_COUNTRY 或 SUB_COUNTRY_LOCATION
ageRanges[]

object (AgeRangeInfo)

建议的年龄定位；可能为空，表示没有年龄定位。
gender

object (GenderInfo)

建议的性别定位条件。此属性包含维度 GENDER（如果存在）。
userInterests[]

object (AudienceInsightsAttributeMetadata)

建议定位的细分受众群。这些属性均具有维度 AFFINITY_USER_INTEREST 或 IN_MARKET_USER_INTEREST
coverage

number

可以使用建议的定位条件覆盖的所请求受众群体的比例（介于 0 和 1 之间，包括 0 和 1）。
index

number

覆盖率与基准受众群体覆盖率的比率；如果该比率未定义或无意义，则比率为零。
potentialYoutubeReach

string (int64 format)

使用此定位条件时可在 YouTube 上覆盖的大致估算人数。