The new Search Ads 360 Reporting API is now available. Join the searchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.

ad_group_criterion

An ad group criterion. The ad_group_criterion report only returns criteria that were explicitly added to the ad group.

Attributed resources
ad_group
campaign
customer
user_list

Fields from the above resources may be selected along with this resource in your SELECT and WHERE clauses. These fields will not segment metrics in your SELECT clause.

ad_group_criterion.ad_group
Field description	The ad group to which the criterion belongs.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

ad_group_criterion.age_range.type
Field description	Type of the age range.
Category	`ATTRIBUTE`
Data Type	`ENUM AGE_RANGE_18_24 AGE_RANGE_25_34 AGE_RANGE_35_44 AGE_RANGE_45_54 AGE_RANGE_55_64 AGE_RANGE_65_UP AGE_RANGE_UNDETERMINED UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.AgeRangeTypeEnum.AgeRangeType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.bid_modifier
Field description	The modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.
Category	`ATTRIBUTE`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.cpc_bid_micros
Field description	The CPC (cost-per-click) bid.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.creation_time
Field description	The timestamp when this ad group criterion was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.criterion_id
Field description	The ID of the criterion.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.effective_cpc_bid_micros
Field description	The effective CPC (cost-per-click) bid.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.effective_labels
Field description	The resource names of effective labels attached to this ad group criterion. An effective label is a label inherited or directly assigned to this ad group criterion.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	True

ad_group_criterion.engine_id
Field description	ID of the ad group criterion in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "ad_group_criterion.criterion_id" instead.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.engine_status
Field description	The Engine Status for ad group criterion.
Category	`ATTRIBUTE`
Data Type	ENUM AD_GROUP_CRITERION_ACCOUNT_PAUSED AD_GROUP_CRITERION_APPROVED AD_GROUP_CRITERION_DISAPPROVED AD_GROUP_CRITERION_ELIGIBLE AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH AD_GROUP_CRITERION_INVALID_PC_SEARCH AD_GROUP_CRITERION_INVALID_SEARCH AD_GROUP_CRITERION_LOW_SEARCH_VOLUME AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW AD_GROUP_CRITERION_NOT_REVIEWED AD_GROUP_CRITERION_ON_HOLD AD_GROUP_CRITERION_PARTIALLY_INVALID AD_GROUP_CRITERION_PAUSED AD_GROUP_CRITERION_PENDING_REVIEW AD_GROUP_CRITERION_REMOVED AD_GROUP_CRITERION_SERVING AD_GROUP_CRITERION_TO_BE_ACTIVATED AD_GROUP_CRITERION_UNDER_REVIEW UNKNOWN UNSPECIFIED
Type URL	`google.ads.searchads360.v0.enums.AdGroupCriterionEngineStatusEnum.AdGroupCriterionEngineStatus`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.final_url_suffix
Field description	URL template for appending params to final URL.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.final_urls
Field description	The list of possible final URLs after all cross-domain redirects for the ad.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	True

ad_group_criterion.gender.type
Field description	Type of the gender.
Category	`ATTRIBUTE`
Data Type	`ENUM FEMALE MALE UNDETERMINED UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.GenderTypeEnum.GenderType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.keyword.match_type
Field description	The match type of the keyword.
Category	`ATTRIBUTE`
Data Type	`ENUM BROAD EXACT PHRASE UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.keyword.text
Field description	The text of the keyword (at most 80 characters and 10 words).
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.labels
Field description	The resource names of labels attached to this ad group criterion.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	True

ad_group_criterion.last_modified_time
Field description	The datetime when this ad group criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.listing_group.type
Field description	Type of the listing group.
Category	`ATTRIBUTE`
Data Type	`ENUM SUBDIVISION UNIT UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.ListingGroupTypeEnum.ListingGroupType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.location.geo_target_constant
Field description	The geo target constant resource name.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

ad_group_criterion.negative
Field description	Whether to target (`false`) or exclude (`true`) the criterion. This field is immutable. To switch a criterion from positive to negative, remove then re-add it.
Category	`ATTRIBUTE`
Data Type	`BOOLEAN`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.position_estimates.top_of_page_cpc_micros
Field description	The estimate of the CPC bid required for ad to be displayed at the top of the first page of search results.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.quality_info.quality_score
Field description	The quality score. This field may not be populated if Google does not have enough information to determine a value.
Category	`ATTRIBUTE`
Data Type	`INT32`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.resource_name
Field description	The resource name of the ad group criterion. Ad group criterion resource names have the form: `customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}`
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

ad_group_criterion.status
Field description	The status of the criterion. This is the status of the ad group criterion entity, set by the client. Note: UI reports may incorporate additional information that affects whether a criterion is eligible to run. In some cases a criterion that's REMOVED in the API can still show as enabled in the UI. For example, campaigns by default show to users of all age ranges unless excluded. The UI will show each age range as "enabled", since they're eligible to see the ads; but AdGroupCriterion.status will show "removed", since no positive criterion was added.
Category	`ATTRIBUTE`
Data Type	`ENUM ENABLED PAUSED REMOVED UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.AdGroupCriterionStatusEnum.AdGroupCriterionStatus`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.tracking_url_template
Field description	The URL template for constructing a tracking URL.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.type
Field description	The type of the criterion.
Category	`ATTRIBUTE`
Data Type	ENUM AD_SCHEDULE AGE_RANGE APP_PAYMENT_MODEL AUDIENCE BRAND BRAND_LIST CARRIER COMBINED_AUDIENCE CONTENT_LABEL CUSTOM_AFFINITY CUSTOM_AUDIENCE CUSTOM_INTENT DEVICE GENDER INCOME_RANGE IP_BLOCK KEYWORD KEYWORD_THEME LANGUAGE LIFE_EVENT LISTING_GROUP LISTING_SCOPE LOCAL_SERVICE_ID LOCATION LOCATION_GROUP MOBILE_APPLICATION MOBILE_APP_CATEGORY MOBILE_DEVICE OPERATING_SYSTEM_VERSION PARENTAL_STATUS PLACEMENT PROXIMITY TOPIC UNKNOWN UNSPECIFIED USER_INTEREST USER_LIST WEBPAGE YOUTUBE_CHANNEL YOUTUBE_VIDEO
Type URL	`google.ads.searchads360.v0.enums.CriterionTypeEnum.CriterionType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.user_list.user_list
Field description	The User List resource name.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

ad_group_criterion.webpage.conditions
Field description	Conditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.searchads360.v0.common.WebpageConditionInfo`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

ad_group_criterion.webpage.coverage_percentage
Field description	Website criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage. This field is read-only.
Category	`ATTRIBUTE`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion.webpage.criterion_name
Field description	The name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters. This field is required for CREATE operations and is prohibited on UPDATE operations.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_criterion

ad_group_criterion.ad_group

ad_group_criterion.age_range.type

ad_group_criterion.bid_modifier

ad_group_criterion.cpc_bid_micros

ad_group_criterion.creation_time

ad_group_criterion.criterion_id

ad_group_criterion.effective_cpc_bid_micros

ad_group_criterion.effective_labels

ad_group_criterion.engine_id

ad_group_criterion.engine_status

ad_group_criterion.final_url_suffix

ad_group_criterion.final_urls

ad_group_criterion.gender.type

ad_group_criterion.keyword.match_type

ad_group_criterion.keyword.text

ad_group_criterion.labels

ad_group_criterion.last_modified_time

ad_group_criterion.listing_group.type

ad_group_criterion.location.geo_target_constant

ad_group_criterion.negative

ad_group_criterion.position_estimates.top_of_page_cpc_micros

ad_group_criterion.quality_info.quality_score

ad_group_criterion.resource_name

ad_group_criterion.status

ad_group_criterion.tracking_url_template

ad_group_criterion.type

ad_group_criterion.user_list.user_list

ad_group_criterion.webpage.conditions

ad_group_criterion.webpage.coverage_percentage

ad_group_criterion.webpage.criterion_name