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 must 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

To discover the resources that can be requested in this way for a given resource, check the Attribute Resourcesrow of its reference page. For example, for keyword_view , you can find its resources on its reference page .