Google Ads 界面提供报告功能。如需创建报告，请登录您的 Google Ads 账号，点击左侧导航菜单中的广告系列 ，然后点击数据分析和报告 。如需从头开始创建报告，请点击报告编辑器 。
本指南将 Google Ads 界面中的常见报告概念和命名惯例映射到您可以使用 Google Ads 查询语言 (GAQL) 和 Google Ads API 生成的报告。您还可以按照界面中的提示创建最符合您要求的报告。
工具和资源
如需查看更详细的示例以及有关将界面屏幕映射到 API 的自动化帮助，请参阅以下资源：
- 查询 Cookbook：一系列 GAQL 查询，用于复制许多常见 Google Ads 界面屏幕上显示的数据。
- Google Ads API 报告扩展程序：一款 Chrome 扩展程序 ，可帮助您直接在 Google Ads 界面中识别 API 资源和字段名称。
常见界面术语
下表总结了界面中使用的一些常见术语及其与 Google Ads 查询语言 (GAQL) 的 映射。
| 界面 | GAQL |
|---|---|
| 列 | GAQL 查询的 SELECT 子句
中的任何资源、细分字段或指标。 |
| 日期范围 | 日期范围映射到 WHERE 子句
按 segments.date 进行过滤。 |
| 过滤条件 | WHERE 子句中的一个或多个条件。 |
| 细分字段 | 通过在 GAQL 查询中添加细分字段来应用 细分 。 |
| 分页 | 分页会将 查询结果集拆分为多个页面。 |
列
界面中的列相当于在 GAQL 中对
资源字段、
细分字段或
指标使用 SELECT 子句。
如需了解详情，请参阅统计信息表格中的各个列。
日期范围
Google Ads 界面有一个表格，用于显示账号统计信息，还有一个下拉菜单，用于控制这些统计信息的日期范围。
您可以在 GAQL
查询的 WHERE 子句中按
segments.date 进行过滤，从而实现相同的控制。
过滤条件
界面中的过滤条件相当于 GAQL 的
WHERE 子句中的一个或多个条件。
如需了解详情，请参阅过滤性能 数据视图。
细分
如需查看更详细的统计信息，请按细分拆分数据。例如，假设您想分别查看 Google 搜索网络和 Google 展示广告网络的展示次数。在这种情况下，请按网络细分报告。如需了解如何在 SELECT 子句中添加细分字段，请参阅 细分。
分页
您可以在界面中使用每个数据表格底部的控件浏览报告，这些控件可让您切换页面，并从一组定义的大小中选择要显示的结果数量。
如需在检索报告时分页显示结果，请将
GoogleAdsService.Search与
next_page_token结合使用。如需提取整个结果集
而不进行分页，请使用
GoogleAdsService.SearchStream。
对结果排序
在界面中，您可以通过选择列来对结果排序。
在 GAQL 中，您可以使用 ORDER BY 子句 和
LIMIT 子句 来对查询结果排序和限制查询结果。
下载格式
在界面中，报告可以采用各种格式下载，例如 CSV、TSV 或 XML。
API 不会直接将输出格式化为 CSV 等文件，因此您的客户端应用必须对响应进行格式化。如需了解如何在客户端中实现 CSV 格式，请参阅 Campaign report to CSV code sample 代码示例。
定期生成报告并通过电子邮件发送
您可以在界面中定期生成报告并通过电子邮件发送，但 API 不支持这些功能。
将界面视图映射到 API 资源
以下列出了常见的界面视图及其匹配的 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 |
| 内容 > 展示位置 | managed_placement_view |
| 内容 > 展示了广告的位置 | group_placement_view |
| 内容 > 展示了广告的位置 > 查看详细信息 | detail_placement_view |
| 受众群体 > 受众特征 > 年龄 | age_range_view |
| 受众群体 > 受众特征 > 性别 | gender_view |
| 位置 | location_view |
| 内容 > 主题 | topic_view |
| 位置 > 地理位置报告 | geographic_view |
* 如需生成付费和自然搜索 报告，您必须在客户级将 Google Search Console 账号与 Google Ads 账号相关联。
例如，在上表中，您可以使用以下 GAQL 查询来生成过去 7 天的汇总账号报告（如果您希望按天细分指标，请将 segments.date 添加到 SELECT 子句）：
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 字段添加过滤条件，以排除已移除的行（或明确添加 ENABLED 和 PAUSED 实体）。例如：
SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'