返回与所请求的受众群体相关的一系列定位分析数据(例如可定位的受众群体)。
抛出的错误列表:AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
HTTP 请求
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateSuggestedTargetingInsights
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
customerId |
必需。客户的 ID。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "audience": { object ( |
字段 | |
---|---|
audience |
必需。要为其请求数据分析的兴趣受众群体。 |
baselineAudience |
可选。基准受众群体。如果未指定,默认值为与相关受众群体位于同一国家/地区的所有用户。 |
dataMonth |
可选。用于数据分析的为期一个月的历史数据范围,格式为“yyyy-mm”。如果未设置,系统将返回最近 30 天数据的数据分析。 |
customerInsightsGroup |
可选。为其规划的客户的名称。这是用户定义的值。 |
响应正文
AudienceInsightsService.GenerateSuggestedTargetingInsights
的响应消息。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"suggestions": [
{
object ( |
字段 | |
---|---|
suggestions[] |
针对可定位受众群体的建议数据分析。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/adwords
有关详情,请参阅 OAuth 2.0 概览。
TargetingSuggestionMetrics
与所请求的受众群体相关的建议可定位受众群体。
JSON 表示法 |
---|
{ "locations": [ { object ( |
字段 | |
---|---|
locations[] |
建议的地理位置定位。这些属性都有维度 GEO_TARGET_COUNTRY 或 SUB_COUNTRY_LOCATION |
ageRanges[] |
建议的年龄定位条件;可能为空,表示未进行年龄定位条件。 |
gender |
建议的性别定位条件。如果存在,则此属性具有维度 GENDER。 |
userInterests[] |
建议定位的细分受众群。这些属性都有维度 AFFINITY_USER_INTEREST 或 IN_MARKET_USER_INTEREST |
coverage |
所请求的受众群体中可使用建议的定位条件覆盖的比例(介于 0 到 1 之间,包括 0 和 1 之间)。 |
index |
覆盖率与基准受众群体覆盖率的比率,或零(如果此比率未定义或没有意义)。 |
potentialYoutubeReach |
使用此定位条件可以在 YouTube 上覆盖的大致人数估算值。 |