跟踪广告展示位置和效果

Google Ads API 提供了多个视图，用于分析广告的展示位置和效果：managed_placement_view、group_placement_view、detail_placement_view 和 performance_max_placement_view。每个视图都从不同的角度呈现您的展示位置数据。如需了解可复制 Google Ads 界面中展示位置界面的即用型 Google Ads 查询语言 (GAQL) 和 curl 查询，请参阅查询指南。

自选展示位置视图

• 显示的内容：managed_placement_view 资源提供按您在广告组中定位的肯定展示位置条件汇总的效果数据。此视图包含在 Google Ads 界面中的内容 > 展示位置下管理的所有五种条件类型：网站、YouTube 频道、YouTube 视频、移动应用和移动应用类别。
• 界面等效项：内容 > 展示位置
• 查询构建器：在查询构建器中探索

指定展示位置条件类型

managed_placement_view 资源中的每一行都会填充与其 ad_group_criterion.type 值匹配的 AdGroupCriterion 字段，并使其他展示位置字段保持未设置状态：

界面展示位置类型	ad_group_criterion.type 值	条件详情字段	备注
网站	PLACEMENT	ad_group_criterion.placement.url	目标网站或网域网址。
YouTube 频道	YOUTUBE_CHANNEL	ad_group_criterion.youtube_channel.channel_id	YouTube 频道 ID。ad_group_criterion.display_name 字段会返回频道名称。
YouTube 视频	YOUTUBE_VIDEO	ad_group_criterion.youtube_video.video_id	YouTube 视频 ID。ad_group_criterion.display_name 字段会返回视频标题。
应用	MOBILE_APPLICATION	ad_group_criterion.mobile_application.app_id、ad_group_criterion.mobile_application.name	{platform}-{platform_native_id} 格式的应用 ID（iOS 为 1-，Android 为 2-）和应用名称。
应用类别	MOBILE_APP_CATEGORY	ad_group_criterion.mobile_app_category.mobile_app_category_constant	资源名称，格式为 mobileAppCategoryConstants/{mobile_app_category_id}。请参阅移动应用类别名称和层次结构。

查询示例

如需提取过去 30 天内所有指定展示位置类型的效果指标，请选择 ad_group_criterion.type 字段以及特定于类型的字段：

SELECT
  campaign.id,
  ad_group.id,
  managed_placement_view.resource_name,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.display_name,
  ad_group_criterion.placement.url,
  ad_group_criterion.youtube_channel.channel_id,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.mobile_application.app_id,
  ad_group_criterion.mobile_application.name,
  ad_group_criterion.mobile_app_category.mobile_app_category_constant,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS

注意：在 SELECT 子句中选择 segments 字段（例如 segments.date）会排除指标为零的指定展示位置（请参阅通过细分排除零指标）。如需检索所有已配置的展示位置条件（不含指标），请直接查询 ad_group_criterion 资源。

移动应用类别名称和层次结构

在 Google Ads 界面中，定位到的移动应用类别会显示其完整应用商店路径，例如应用类别 > Apple App Store > 教育。查询 Google Ads API 时，请注意以下行为：

• 归因移动应用类别常量：mobile_app_category_constant 资源不是 managed_placement_view 资源的归因资源。请改为选择 ad_group_criterion.mobile_app_category.mobile_app_category_constant 字段（例如 mobileAppCategoryConstants/60503），或者在不需要指标时查询 ad_group_criterion 资源。
• 仅叶显示名称：ad_group_criterion.display_name 和 mobile_app_category_constant.name 字段都仅返回叶类别名称，例如 "Education" 或 "Games"。这两个字段都不包含父级应用商店路径。
• 解析应用商店路径：Google Play 和 Apple App Store 在不同的标准 ID 中共享叶类别名称。例如，条件 ID 60005 (/All Apps/Google Play/Education)、60060 (/All Apps/Google Play/Family/Education) 和 60503 (/All Apps/Apple App Store/Education) 都会在 name 和 display_name 字段中返回 "Education"。从资源名称中提取 {mobile_app_category_id} 后缀，然后在移动应用类别表或 CSV 文件中查找其完整层次结构路径。

组展示位置视图

• 显示内容：group_placement_view 资源显示您的广告在展示广告网络和 YouTube 上实际投放的位置，无论这些展示位置是明确定位的，还是由 Google 系统自动发现的。这可能包括网站、YouTube 频道或视频以及应用。
• 界面等效项：内容 > 展示了广告的位置
• 查询构建器：在查询构建器中探索

查询示例

以下查询会提取过去 30 天内展示过广告的网域、移动应用和 YouTube 频道的效果指标：

SELECT
  campaign.id,
  ad_group.id,
  group_placement_view.display_name,
  group_placement_view.target_url,
  group_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS

“总计：其他”行

为加快报告生成速度，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 资源中各个展示位置行的总和可能会低于广告组或广告系列的总指标。如需了解详情，请参阅“展示了广告的位置”报告简介。如需详细了解阈值和缺失的元数据如何影响跨视图比较，请参阅展示位置视图之间的指标差异和展示位置详情不可用的行。

展示位置定位设置

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 资源类似，此视图会忽略不符合最低活动阈值的低活动展示位置（请参阅“总计：其他”行部分）。

注意：detail_placement_view 资源会在精细级别（单个网址和视频 ID）进行报告，并且可以返回高基数数据。请始终按日期范围或特定广告系列和广告组过滤查询，以避免载荷过大和查询超时。

查询示例

为了限制结果数量，以下查询会提取 7 天时间范围内的网址级和视频级展示位置指标。对于大型账号，请按 campaign.id 或 ad_group.id 字段进一步过滤：

SELECT
  campaign.id,
  ad_group.id,
  detail_placement_view.display_name,
  detail_placement_view.target_url,
  detail_placement_view.group_placement_target_url,
  detail_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS

如需排除展示位置元数据不可用的行，请添加 AND detail_placement_view.target_url IS NOT NULL（请参阅展示位置详情不可用的行）。如果不需要返回的 resource_name 字段，请附加 PARAMETERS omit_unselected_resource_names = true 子句。

展示位置视图之间的指标差异

系统会针对每个精细度级别单独评估最低活动阈值：

• 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 字段对行进行去重，因为这样做可能会覆盖元数据不可用的不同展示位置的指标。如需在 GAQL 中排除元数据不可用的行，请对 target_url 或 display_name 字段进行过滤，因为 placement 和 resource_name 字段不可过滤。例如，使用 WHERE group_placement_view.target_url IS NOT NULL 或 WHERE detail_placement_view.target_url IS NOT NULL。

效果最大化广告系列展示位置视图

• 显示的内容：performance_max_placement_view 资源提供效果最大化广告系列广告投放到的展示位置的展示数据 (metrics.impressions)。在 v24 及更高版本中，您可以按 segments.ad_network_type 对 performance_max_placement_view 进行细分（v23 不支持此操作）。
• 界面等效项：数据洞见和报告 > 报告编辑器 > 效果最大化广告系列展示位置
• 查询构建器：在查询构建器中探索

查询示例

以下查询会提取过去 30 天内效果最大化广告系列的展示位置展示次数（按广告联盟类型细分）：

SELECT
  campaign.id,
  performance_max_placement_view.display_name,
  performance_max_placement_view.target_url,
  performance_max_placement_view.placement_type,
  segments.ad_network_type,
  metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS

选择展示位置视图

• 使用 managed_placement_view 评估您正在积极定位和出价的展示位置的效果。
• 使用 group_placement_view 可全面了解广告的展示位置，尤其是在使用“观察”设置时，以便发现新的定位机会或排除对象。
• 使用 detail_placement_view 可获取有关展示广告的具体网址或视频的最精细详细信息，通常在 group_placement_view 中确定感兴趣的网域或频道后使用。
• 使用 performance_max_placement_view 检查效果最大化广告系列的展示位置展示次数。