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