Criteria Metrics

In the Google Ads API, each criteria report is represented by a separate resource. Unless otherwise necessary, *_view resources contain only a resource_name field.

Google Ads API clients need to specify corresponding ad_group_criterion or campaign_criterion fields if any criteria specific data needs to be fetched. This lets Google Ads API clients request ad_group_criterion or campaign_criterion fields and the *_view resource in the same request to the GoogleAdsService.SearchStream method.

Sample query request

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

To retrieve performance data (metrics) for a specific criteria type, specify its corresponding view resource in the FROM clause. For example, use keyword_view in the FROM clause and some metrics fields in the SELECT clause to retrieve keyword metrics.

You can select fields from parent resources all the way up to customer from a criteria view. For example, when selecting FROM the keyword_view, you can request fields from all of the following resources:

  • ad_group_criterion
  • ad_group
  • campaign
  • customer

You can discover the resources that can be requested in this way for a given resource by checking the Attribute Resources row of its reference page. For example, for keyword_view, you can find its resources on its reference page.