本指南介绍了 Google Ads 界面中报告的概念和命名惯例 您可以使用 Google Ads 查询语言 (GAQL) 和 Google Ads API。
常见的界面术语
下表总结了界面中常用的一些术语及其 与 Google Ads 查询语言 (GAQL) 的映射。
| 界面 | GAQL |
|---|---|
| 列 | GAQL 查询的 SELECT 子句中的任何资源、细分字段或指标。 |
| 日期范围 | 日期范围映射到 WHERE
子句对 segments.date 进行过滤。 |
| 过滤条件 | WHERE 子句中的一个或多个条件。 |
| 细分字段 | 通过添加细分字段来应用细分 。 |
| 分页 | Paging 将 多个页面 |
列
界面中的列等同于资源 字段、细分 字段，以及 GAQL 中的指标。
过滤
日期范围
Google Ads 界面中有一个显示账号统计信息的表格 可以控制这些统计信息的日期范围。
在 GAQL 中，您可以通过使用过滤条件进行过滤，
GAQL 的 WHERE 子句中的 segments.date
查询。
过滤条件
界面中的过滤器等同于 WHERE 子句。
细分
要查看更详细的统计信息，您可以用“细分”来划分数据。例如： 您可能想查看特定广告资源中 Google 搜索网络独立于 Google 展示广告网络。在此示例中 则可以按投放网络对报告进行细分请参阅 细分：如何添加细分字段 。
分页
您可以使用 每个数据表的底部，以便切换页面和选择 从一组定义的尺寸中选择要显示的结果。
检索报告时，支持对结果进行分页
GoogleAdsService.Search 至
next_page_token。提取整个结果集
使用
GoogleAdsService.SearchStream。
订单结果
在界面中，您可以通过选择一列来对结果进行排序。
在 GAQL 中，您可以使用 ORDER BY 子句和 LIMIT 子句 对查询结果进行排序。
下载格式
在界面中，您能够以多种格式下载报告，例如 CSV、TSV 或 XML。
该 API 不直接支持输出中的不同格式，因此 需要进行一些后期处理。请参阅 显示如何在 CSV 文件中实施 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"