报告

报告会提供有关您帐号中所有不同资源的信息。 您可以获取广告系列、广告组及其统计信息、帐号的更改历史记录等。报告基础架构由 Google Ads API 提供支持,使用 GAQL 指定您要设置的字段、指标和条件。

举报机制主要有两种。这两种查询都接受相同种类的查询,但主要区别在于返回结果的方式不同。

对于这两种情况,我们将使用以下查询:

SELECT
  campaign.id,
  campaign.status,
  metrics.clicks,
  metrics.impressions,
  customer.id
FROM campaign
WHERE
  metrics.impressions > 0
AdsApp.report()
这将为您的搜索结果返回类似于字典的扁平表示形式。您可以直接访问字段,就像使用字典一样,例如 row["campaign.id"]row["metrics.impressions"]。使用此格式,您可以使用 exportToSheet() 方法将结果直接导出到电子表格。这不是 Google Ads API 返回结果所采用的原生格式,因此在某些情况下,某些字段可能未采用此格式。如果是这种情况,您应改用 search
AdsApp.search()
这将返回一个 GoogleAdsRow 对象列表,其中包含各种字段,每个字段可能都有子字段。因此,您需要使用 row.campaign.idrow.metrics.impressions 来获取数据。如果您计划以编程方式处理数据,此方法通常更实用,而且某些字段只有在无法转换为平面表示形式的情况下才可能采用 search 格式。

报告示例

let report = AdsApp.report(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

let rows = report.rows();
while (rows.hasNext()) {
    let row = rows.next();
    let query = row["search_term_view.search_term"];
    let impressions = row["metrics.impressions"];
}

如需详细了解如何使用此视图,请参阅 AdsApp.report 文档。

搜索示例

let search = AdsApp.search(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

while (search.hasNext()) {
    let row = search.next();
    let query = row.searchTermView.searchTerm;
    let impressions = row.metrics.impressions;
}

如需了解所有可能的设置,请参阅完整的 Adsapp.search 文档。