界面中的报告

本指南将 Google Ads 界面中报告的概念和命名惯例与您可以使用 Google Ads 查询语言 (GAQL) 和 Google Ads API 生成的报告对应起来。

常见的界面术语

下表总结了界面中使用的一些常用术语及其与 Google Ads 查询语言 (GAQL) 的对应关系。

界面	Google Analytics（分析）(GAQL)
列	GAQL 查询的 SELECT 子句中的任何资源、细分字段或指标。
日期范围	日期范围映射到按 segments.date 过滤的 WHERE 子句。
滤镜	WHERE 子句中的一个或多个条件。
细分字段	通过在 GAQL 查询中添加细分字段，应用细分。
分页	Paging 将查询结果集分解为多个页面。

列

界面中的列等同于 GAQL 中的资源字段、细分字段和指标。

过滤

日期范围

Google Ads 界面中有一个显示帐号统计信息的表格，还有一个用于控制这些统计信息的日期范围的下拉菜单。

在 GAQL 中，您也可以通过在 GAQL 查询的 WHERE 子句中按 segments.date 进行过滤，从而实现相同的控制。

过滤条件

界面中的过滤器等同于 GAQL 的 WHERE 子句中的一个或多个条件。

分割

要查看更详细的统计信息，您可以用“细分”来划分数据。例如，您可能希望单独查看 Google 搜索网络与 Google 展示广告网络的展示次数。在这种情况下 您需要按投放网络来细分报告请参阅细分，了解如何在 SELECT 子句中添加细分字段。

分页

您可以在界面中使用每个数据表底部提供的控件浏览报告，这些控件可用于切换页面，并从定义的一组大小中选择要显示的结果数量。

通过 next_page_token 使用 GoogleAdsService.Search 检索报告时，可以对结果进行分页。如需提取整个结果集而不进行任何分页，请使用 GoogleAdsService.SearchStream。

对结果进行排序

在界面中，您可以通过选择一列来对结果进行排序。

在 GAQL 中，您可以使用 ORDER BY 子句和 LIMIT 子句对查询结果进行排序。

下载格式

在界面中，您能够以多种格式下载报告，例如 CSV、TSV 或 XML。

该 API 不直接支持其输出中的不同格式，因此您需要执行一些后期处理。请参阅展示如何在客户端中实现 CSV 格式的代码示例。

定期生成报告并通过电子邮件发送

界面中提供了定期生成报告并通过电子邮件发送的功能，但 API 不支持此功能。

预定义的报告

您可以在 Google Ads 界面中创建预定义报告列表。

下面列出了基本的预定义报告及其匹配的 GAQL 资源名称。

基本的预定义报告	GAQL 资源名称 （在 FROM 子句中指定）
账号	customer
广告系列、 广告系列详细信息	campaign
广告组， 广告组详细信息	ad_group
广告、 最终到达网址	ad_group_ad
搜索广告关键字	keyword_view
搜索字词	search_term_view
付费和自然	paid_organic_search_term_view
着陆页	landing_page_view
扩展后的着陆页	expanded_landing_page_view

作为上表中的示例，您可以使用以下 GAQL 生成帐号报告：

SELECT
  customer.descriptive_name,
  customer.id,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  metrics.absolute_top_impression_percentage,
  metrics.top_impression_percentage,
  metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS

常见差异

在比较界面报告与 API 报告时，最常见的区别之一是界面会隐式滤除已移除的实体，而 API 则不会。

如需复制默认界面视图，您需要添加过滤条件（通常使用 status 字段）来排除已移除的行，例如：

SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"