本指南将 Google Ads 界面中报告的概念和命名惯例与您可以使用 Google Ads 查询语言 (GAQL) 和 Google Ads API 生成的报告进行了对照。
常见的界面术语
下表总结了界面中常用的一些术语及其在 Google Ads 查询语言 (GAQL) 中的对应关系。
界面 | GAQL |
---|---|
列 | GAQL 查询的 SELECT 子句中的任何资源、细分字段或指标。 |
日期范围 | 日期范围映射到对 segments.date 进行过滤的 WHERE 子句。 |
滤镜 | WHERE 子句中的一个或多个条件。 |
细分字段 | 通过在 GAQL 查询中添加细分字段来应用细分。 |
分页 | Paging 将查询结果集分为多个页面。 |
Columns
过滤
日期范围
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"