Google Ads API 提供了多个视图,用于分析广告的展示位置和效果:managed_placement_view、group_placement_view、detail_placement_view 和 performance_max_placement_view。每个视图都从不同的角度展示您的展示位置数据。
自选展示位置视图
- 显示的内容:
managed_placement_view资源提供按您明确定位的展示位置(自选展示位置)汇总的效果数据。它反映了您的Placement条件的效果。 - 界面等效项:内容 > 展示位置
- 查询构建器:在查询构建器中探索
查询示例
如需提取过去 30 天内自选展示位置的效果指标,请执行以下操作:
SELECT
campaign.id,
ad_group.id,
managed_placement_view.resource_name,
ad_group_criterion.placement.url,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS
组展示位置视图
- 显示内容:
group_placement_view资源显示您的广告在展示广告网络和 YouTube 上实际投放的位置,无论这些展示位置是明确定位的,还是由 Google 系统自动发现的。这可能包括网站、YouTube 频道或视频以及应用。 - 界面等效项:内容 > 展示了广告的位置
- 查询构建器:在查询构建器中探索
“总计:其他”行
为加快报告生成速度,group_placement_view 和 detail_placement_view 资源会排除未达到展示次数或互动次数最低活动阈值的个别展示位置。
- 在 Google Ads 界面中:该界面会将未达到此活动阈值的展示位置汇总到标记为总计:其他的摘要行中。
- 在 Google Ads API 中:该 API 会从报告结果中省略不符合活动阈值的展示位置,并且不会返回
group_placement_view.placement或detail_placement_view.placement字段的值为"Other"的摘要行。
因此,group_placement_view 和 detail_placement_view 资源中各个展示位置行的总和可能会低于广告组或广告系列的总指标。如需了解详情,请参阅“展示了广告的位置”报告简介。如需详细了解阈值和缺失的元数据如何影响跨视图比较,请参阅展示位置视图之间的指标差异和展示位置详情不可用的行。
TargetingSetting 选项
group_placement_view 的行为和效用受广告组一级 PLACEMENT 维度的 TargetingSetting 影响。此设置包含一个
target_restrictions 列表,每个 都有一个 bid_only 布尔值
字段,用于指定您的广告是仅在指定展示位置上展示,还是也在
其他展示位置上展示。请参阅“定位”和“观察”设置简介。
bid_only = false:此值对应于 Google Ads 界面中 展示位置的定位。如果您的广告组设置为“定位”,则您的广告只会展示在您明确添加为条件的展示位置上。您可以选择对这些展示位置应用出价调整。在这种情况下,group_placement_view在很大程度上反映了managed_placement_view,但仍受最低活动阈值的约束。bid_only = true:此值对应于 Google Ads 界面中展示位置的观察。如果您的广告组设置为“观察”,您的广告可以在展示广告网络和 YouTube 上任何符合条件的展示位置展示。您还可以对定位到的任何展示位置应用出价调整。在这种情况下,group_placement_view对于发现展示广告的新展示位置至关重要,您随后可以选择将这些展示位置添加为自选展示位置或排除对象。
展示位置详情视图
- 显示内容:
detail_placement_view资源可提供更精细的展示位置细分,提供网域或频道级别以外的详细信息。例如,它可以显示广告展示位置的具体网址或 YouTube 视频 ID。 - 界面等效操作:等效于在内容 > 展示了广告的位置中选择行,然后点击查看详情。
- 查询构建器:在查询构建器中探索
- 重要注意事项:与
group_placement_view资源类似,此视图会忽略不符合最低活动阈值的低活动展示位置(请参阅“总计:其他”行部分)。
展示位置视图之间的指标差异
系统会针对每个精细度级别单独评估最低活动阈值:
group_placement_view资源会评估汇总网域、移动应用或 YouTube 频道的阈值。detail_placement_view资源会针对每个单独的网页网址或 YouTube 视频分别评估阈值。
detail_placement_view 资源会忽略未达到阈值的个别网页网址或 YouTube 视频。因此,对网域或 YouTube 频道(按 detail_placement_view.group_placement_target_url 字段过滤)的 detail_placement_view 行求和,返回的展示次数可能会少于对应的 group_placement_view 行。
展示位置详情不可用的行
针对 group_placement_view 或 detail_placement_view 资源的查询可能会返回同一广告组中的多行,这些行具有未设置的 placement、display_name 和 target_url 字段以及相同的 resource_name 值(例如,以 ~MTRf 结尾)。
出现此行为的原因如下:
- 内部展示位置分组:两个视图均按唯一的内部展示位置标识符(而非
resource_name或placement字符串字段)对效果指标进行分组。 - 展示位置元数据不可用:在 Google Ads 界面中,后端对照表中没有元数据的展示位置会显示为未知、频道不再可用或视频不再可用。在 API 中,每个不同的展示位置标识符仍会返回一个指标行,其中
placement、display_name和target_url字段未设置。 - 合成资源名称:
resource_name字段中的{base64_placement}后缀是{type_id}_{placement}的 Base64 编码,其中{type_id}是内部展示位置类型标识符,而不是PlacementType枚举编号。当placement_type字段为WEBSITE(内部 ID 为14)且placement字段未设置时,字符串"14_"会编码为MTRf(同样,MOBILE_APPLICATION会将"55_"编码为NTVf,YOUTUBE_VIDEO会将"89_"编码为ODlf,YOUTUBE_CHANNEL会将"90_"编码为OTBf)。因此,同一广告组中具有不可用元数据的同一类型的多个展示位置会共享相同的resource_name值,同时报告单独的指标行。
在客户端代码中处理 group_placement_view 或 detail_placement_view 结果时,请勿仅按 resource_name 字段对行进行去重,因为这样做可能会覆盖元数据不可用的不同展示位置的指标。如需在 Google Ads 查询语言中排除元数据不可用的行,请对 target_url 或 display_name 字段进行过滤(例如 WHERE
detail_placement_view.target_url IS NOT NULL),因为 placement 和 resource_name 字段不可过滤。
效果最大化广告系列展示位置视图
- 显示的内容:
performance_max_placement_view资源提供效果最大化广告系列广告投放到的展示位置的展示数据 (metrics.impressions)。在 v24 及更高版本中,您可以按segments.ad_network_type对performance_max_placement_view进行细分(v23 不支持此操作)。 - 查询构建器:在查询构建器中探索
应使用哪个视图?
- 使用
managed_placement_view评估您正在积极定位和出价的展示位置的效果。 - 使用
group_placement_view可全面了解广告的展示位置,尤其是在使用“观察”设置时,以便发现新的定位机会或排除对象。 - 使用
detail_placement_view可获取有关展示广告的具体网址或视频的最精细详细信息,通常在group_placement_view中确定感兴趣的网域或频道后使用。 - 使用
performance_max_placement_view检查效果最大化广告系列的展示位置展示次数。