Criteria Metrics

Page Summary

outlined_flag

• In the Google Ads API, each criteria report is a separate resource, with *_view resources typically containing only a resource_name field.

• To fetch criteria-specific data in the Google Ads API, clients must specify corresponding ad_group_criterion or campaign_criterion fields along with the *_view resource in the same request.

• Performance data for a specific criteria type can be retrieved by specifying its corresponding view resource in the FROM clause and metrics fields in the SELECT clause of a query.

• Fields from parent resources, up to the customer level, can be selected when querying from a criteria view.

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 Resources row of its reference page. For example, for keyword_view, you can find its resources on its reference page.

Mapping to the UI

Each criteria report corresponds to a specific view in the Google Ads UI. Mapping these can help you reconcile API data with what you see in the interface. For a larger list of mappings, see Reports in the UI.

The following are some common criteria-based reports and their typical UI locations:

• Campaigns > Audiences, keywords, and content > Search keywords: Returns data equivalent to keyword_view.
• Campaigns > Audiences, keywords, and content > Audiences > Demographics: Returns data equivalent to age_range_view and gender_view.
• Campaigns > Locations: Returns data equivalent to location_view.