报告概览

视频:GAQL 研讨会

得益于报告和查询的统一功能,您便不再需要定义报告。您可以使用 SearchGoogleAdsStreamRequestSearchGoogleAdsRequest 直接查询资源以获取数据。

在查阅报告迁移规划时,请先参阅相应的字段映射表。这些表格显示了 Google Ads API 中的字段名称及其在 Google Ads API 中的等效名称。

示例

“广告组效果报告”和“广告系列效果报告”是两种最常用的 AdWords API 报告。我们比较了 AdWords 查询语言 (AWQL) 和 Google Ads 查询语言 (GAQL):

广告组效果报告
# AWQL
SELECT CampaignId, AdGroupId, Impressions, Clicks, Cost
FROM ADGROUP_PERFORMANCE_REPORT
DURING LAST_7_DAYS

# Google Ads Query Language
SELECT campaign.id, ad_group.id, metrics.impressions, metrics.clicks,
       metrics.cost_micros
FROM ad_group
WHERE segments.date DURING LAST_7_DAYS
广告系列效果报告
# AWQL
SELECT CampaignName, CampaignStatus, Device, Impressions, Clicks,
       Ctr, AverageCpc, Cost
FROM CAMPAIGN_PERFORMANCE_REPORT
DURING LAST_30_DAYS

# Google Ads Query Language
SELECT campaign.name, campaign.status, segments.device, metrics.impressions,
       metrics.clicks, metrics.ctr, metrics.average_cpc, metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

单一归因报告与多个归因报告

在迁移期间,AdWords API 中的某些条件特定报告(例如关键字效果报告年龄段效果报告)可能需要特别注意。此类报告有两种:

  • 单次归因报告(例如条件效果报告关键字效果报告),其中仅记录某次广告展示的触发条件(如展示位置、年龄、关键字等):展示可能会由多个条件触发,但对于单次归因报告,展示及其所有统计信息均仅归因于单个条件。

  • 多重归因报告(例如性别效果报告展示位置效果报告),其中每个触发展示的每个维度中最多有一个条件会记录展示:可以将多个归因报告视为条件类型报告。与一行归因可以包含不同条件类型的单个归因不同,每个多重归因报告仅包含一个条件类型的条件。

Google Ads API 中没有单个归因报告。所有 Google Ads API 条件级报告都是多归因的,也就是说,每个报告专门针对一个条件类型组,并根据该类型的条件汇总统计信息。请勿将来自不同 criteria_view 资源的统计数据相加,否则会导致重复计数和错误总计。

includeZeroImpressions HTTP 标头

AdWords API

在 AdWords API 中,您可以使用 includeZeroImpressions 标头来控制是否返回查询中所有指定指标字段为零值的报告行。

将标题设置为 true,报告输出将包含此类行;对于 false,则不包含。

尽管标头的名称提及“展示次数”,但报告行在请求中的所有指定指标字段(不仅仅是展示次数)中必须为零,这样才能在标头设置为 false 时排除此字段。

Google Ads API 中没有此类标头,因此您无法直接将 AdWords API 查询映射到 Google Ads API 中的查询。

作为近似值,您可以在查询中指定谓词 metrics.impressions > 0 以排除展示次数为零的报告行。在大多数情况下,这会产生与将 AdWords API includeZeroImpressions 标头设置为 false 等效的效果,因为当展示次数为非零值时,其他指标值通常也为非零值。

但请注意,如果 metrics.impressions 为零,但其他指标值(如基于预测的 metrics.search_impression_share)可能不是,因此仍可能会返回报告行。