Google Ads API is returning to beta status. Please read our blog post for more details.

条件指标

在 AdWords API 中,您可以从各种报告(例如,关键字效果报告年龄段效果报告)中检索不同条件的效果数据(即指标)。

为了在 Google Ads API 中提供类似功能,每种条件报告都由单独的资源表示。例如,keyword_view 资源中提供了类似于关键字效果报告的数据。除非绝对必要,否则 *_view 资源将仅包含 resource_name 字段。

如果需要提取任何特定于条件的数据,则 Google Ads API 客户端需要指定对应的 ad_group_criterioncampaign_criterion 字段。这样一来,Google Ads API 客户端就可以在同一请求中请求获取 ad_group_criterioncampaign_criterion 字段以及 *_view 资源,并将其发送到 GoogleAdsService.Search 方法。

查询请求示例

SELECT ad_group_criterion.keyword.text, ad_group.name, campaign.name,
       metrics.impressions, metrics.clicks, metrics.ctr, metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS

要检索特定条件类型的效果数据(即指标),请在 FROM 子句中指定对应的视图资源。例如,可使用 FROM 子句中的 keyword_view 以及 SELECT 子句中的一些 metrics 字段检索关键字指标。

您可以选择父级资源中的各种字段,直到条件视图中的 customer。例如,针对 keyword_view 选择 FROM 后,您可以请求以下所有资源中的字段:

  • ad_group_criterion
  • ad_group
  • campaign
  • customer

您可以检查相关资源的参考页面的属性资源行,看看以上述方式能为给定资源请求哪些资源。以 keyword_view 为例,您可以在其参考页面找到上述信息。

后续步骤