条件指标

在 Google Ads API 中，每种条件报告都由单独的资源表示。 除非另有必要，否则 *_view 资源仅包含 resource_name 字段。

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

查询请求示例

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，您可以在其参考 页面上找到其资源。

映射到界面

每种条件报告都对应于 Google Ads 界面中的特定视图。映射这些内容有助于您将 API 数据与界面中显示的内容进行核对。如需查看更长的映射列表，请参阅界面中的报告。

以下是一些常见的基于条件的报告及其典型的界面位置：

• 广告系列 > 受众群体、关键字和内容 > 搜索广告关键字：返回与 keyword_view 等效的 数据。
• 广告系列 > 受众群体、关键字和内容 > 受众群体 > 受众特征： 返回与 age_range_view 和 gender_view 等效的数据。
• 广告系列 > 地理位置：返回与 location_view等效的数据。