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.
Each view joins to the criterion resource that matches its targeting level (for
example, `keyword_view` joins to `ad_group_criterion`, while `location_view`
joins to `campaign_criterion`). This enables Google Ads API clients to request
`ad_group_criterion` or `campaign_criterion` fields and the `*_view` resource in
the same request to the [`GoogleAdsService.SearchStream`](https://developers.google.com/google-ads/api/reference/rpc/v26/GoogleAdsService/SearchStream) method.

> [!NOTE]
> **Note:** Criteria `*_view` resources reflect performance metrics. Criteria that received zero impressions during the specified date range, as well as negative criteria (such as negative keywords or excluded locations), don't generate metrics and are excluded from these views.

## 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 `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 **Attributed resources** row of its reference page. For
example, for `keyword_view`, you can find its resources on its
[reference page](https://developers.google.com/google-ads/api/fields/v26/keyword_view).

## 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](https://developers.google.com/google-ads/api/docs/reporting/uireports).

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`](https://developers.google.com/google-ads/api/fields/v26/keyword_view).
- **Campaigns \> Audiences, keywords, and content \> Audiences \> Demographics** : Returns data equivalent to [`age_range_view`](https://developers.google.com/google-ads/api/fields/v26/age_range_view) and [`gender_view`](https://developers.google.com/google-ads/api/fields/v26/gender_view).
- **Campaigns \> Locations** : Returns data equivalent to [`location_view`](https://developers.google.com/google-ads/api/fields/v26/location_view).