报告

报告是一项非常强大的功能,让您可以使用一系列丰富的 AdWords API 报告。报告查询使用 AdWords 查询语言指定,返回的值是简单的 JSON 对象。例如:

var report = AdWordsApp.report(
    "SELECT AdGroupId, Query, Ctr, Cost, Impressions " +
    "FROM   SEARCH_QUERY_PERFORMANCE_REPORT " +
    "WHERE  Impressions < 10 " +
    "DURING LAST_30_DAYS");

var rows = report.rows();
while (rows.hasNext()) {
    var row = rows.next();
    var query = row["Query"];
    var impressions = row["Impressions"];
}

请注意,报告不支持 ORDER BYLIMIT 子句。返回的结果没有特定顺序。

有关 API 的详情,请阅读参考。有关在 AdWords 脚本中使用报告的示例,请参阅搜索查询解决方案

使用报告的主要优势:

  • 能够查看常规 AdWords 实体(包括细分)无法获得的各种统计信息。
  • 能够访问海量数据。目前,报告不受任何配额限制,并且系统能够生成含有数百万行的报告。
  • 性能 - 下载报告可能需要一段时间,但可以极其迅速地遍历所有报告行。

API 版本控制

在发布新版 AdWords API 并弃用旧版时,某些报告字段(有时是整个报告)可能不再显示。这可能会在无意间破坏您的代码。为了安全起见,您可以考虑指定与您的代码兼容的 API 版本:

var report = AdWordsApp.report(query, {
    apiVersion: 'v201605'
});

这样一来,当后续版本发布时,您的代码也不会遭到破坏。

当然,不利的一面就是 v201605 最终会被弃用,且彻底不再使用。届时,明确引用该版本的脚本将被破坏。请考虑周全之后再使用 apiVersion

发送以下问题的反馈:

此网页
AdWords Scripts
AdWords Scripts
需要帮助?请访问我们的支持页面