在 Google Ads API 中,每个条件报告都由单独的资源表示。
除非另有必要,否则 *_view 资源仅包含 resource_name 字段。
如果需要提取任何特定于条件的数据,Google Ads API 客户端必须指定相应的 ad_group_criterion 或 campaign_criterion 字段。
每个视图都会联接到与其定位级别匹配的条件资源(例如,keyword_view 联接到 ad_group_criterion,而 location_view 联接到 campaign_criterion)。这样,Google Ads API 客户端就可以在向 GoogleAdsService.SearchStream 方法发出的同一请求中请求 ad_group_criterion 或 campaign_criterion 字段以及 *_view 资源。
查询请求示例
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。例如,在选择 FROM keyword_view 时,您可以请求以下所有资源中的字段:
ad_group_criterionad_groupcampaigncustomer
如需了解对于给定资源,可以通过这种方式请求哪些资源,请查看其参考页面的归因资源行。例如,对于 keyword_view,您可以在其参考页面上找到其资源。
映射到界面
每个条件报告都对应 Google Ads 界面中的一个特定视图。映射这些数据有助于您将 API 数据与界面中显示的数据进行核对。如需查看更全面的映射列表,请参阅界面中的报告。
以下是一些常见的基于条件的报告及其典型的界面位置:
- 广告系列 > 受众群体、关键字和内容 > 搜索广告关键字:返回与
keyword_view相同的数据。 - 广告系列 > 受众群体、关键字和内容 > 受众群体 > 受众特征:返回与
age_range_view和gender_view相同的数据。 - 广告系列 > 地理位置:返回与
location_view相同的数据。