界面中的报告

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

常见的界面术语

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

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

Columns

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

过滤

日期范围

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

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

滤镜

界面中的过滤条件相当于 GAQL 的 WHERE 子句中的一个或多个条件。

分割

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

分页

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

使用 GoogleAdsService.Search 到 next_page_token 检索报告时，可以将结果分页。如需提取整个结果集而不进行任何分页，请使用 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"