Method: customers.generateSuggestedTargetingInsights

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

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

HTTP 请求

POST https://googleads.googleapis.com/v15/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 上覆盖的大概人数估算值。