campaign_criterion

A campaign criterion.

Attributed resources
campaign
carrier_constant
customer
feed
language_constant
mobile_app_category_constant
mobile_device_constant
operating_system_version_constant
shared_set
topic_constant
user_interest
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.

campaign_criterion.ad_schedule.day_of_week

Field descriptionDay of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.DayOfWeekEnum.DayOfWeek
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.ad_schedule.end_hour

Field descriptionEnding hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
CategoryATTRIBUTE
Data TypeINT32
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.ad_schedule.end_minute

Field descriptionMinutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.MinuteOfHourEnum.MinuteOfHour
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.ad_schedule.start_hour

Field descriptionStarting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
CategoryATTRIBUTE
Data TypeINT32
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.ad_schedule.start_minute

Field descriptionMinutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.MinuteOfHourEnum.MinuteOfHour
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.age_range.type

Field descriptionType of the age range.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.AgeRangeTypeEnum.AgeRangeType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.bid_modifier

Field descriptionThe modifier for the bids when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. Use 0 to opt out of a Device type.
CategoryATTRIBUTE
Data TypeFLOAT
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.brand_list.shared_set

Field descriptionShared set resource name of the brand list.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.campaign

Field descriptionImmutable. The campaign to which the criterion belongs.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.carrier.carrier_constant

Field descriptionThe Carrier constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.combined_audience.combined_audience

Field descriptionThe CombinedAudience resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.content_label.type

Field descriptionContent label type, required for CREATE operations.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.ContentLabelTypeEnum.ContentLabelType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.criterion_id

Field descriptionOutput only. The ID of the criterion. This field is ignored during mutate.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.custom_affinity.custom_affinity

Field descriptionThe CustomInterest resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.custom_audience.custom_audience

Field descriptionThe CustomAudience resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.device.type

Field descriptionType of the device.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.DeviceEnum.Device
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.display_name

Field descriptionOutput only. The display name of the criterion. This field is ignored for mutates.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.gender.type

Field descriptionType of the gender.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.GenderTypeEnum.GenderType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.income_range.type

Field descriptionType of the income range.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.IncomeRangeTypeEnum.IncomeRangeType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.ip_block.ip_address

Field descriptionThe IP address of this IP block.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.keyword.match_type

Field descriptionThe match type of the keyword.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.KeywordMatchTypeEnum.KeywordMatchType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.keyword.text

Field descriptionThe text of the keyword (at most 80 characters and 10 words).
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.keyword_theme.free_form_keyword_theme

Field descriptionFree-form text to be matched to a Smart Campaign keyword theme constant on a best-effort basis.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.keyword_theme.keyword_theme_constant

Field descriptionThe resource name of a Smart Campaign keyword theme constant. keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.language.language_constant

Field descriptionThe language constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.listing_scope.dimensions

Field descriptionScope of the campaign criterion.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v18.common.ListingDimensionInfo
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

campaign_criterion.listing_scope.dimensions.activity_city.value

Field descriptionString value of the activity city. The Geo Target Constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableFalse
SortableFalse
RepeatedFalse

campaign_criterion.listing_scope.dimensions.activity_country.value

Field descriptionString value of the activity country. The Geo Target Constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableFalse
SortableFalse
RepeatedFalse

campaign_criterion.listing_scope.dimensions.activity_state.value

Field descriptionString value of the activity state. The Geo Target Constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableFalse
SortableFalse
RepeatedFalse

campaign_criterion.listing_scope.dimensions.hotel_city.city_criterion

Field descriptionThe Geo Target Constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableFalse
SortableFalse
RepeatedFalse

campaign_criterion.listing_scope.dimensions.hotel_country_region.country_region_criterion

Field descriptionThe Geo Target Constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableFalse
SortableFalse
RepeatedFalse

campaign_criterion.listing_scope.dimensions.hotel_state.state_criterion

Field descriptionThe Geo Target Constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableFalse
SortableFalse
RepeatedFalse

campaign_criterion.local_service_id.service_id

Field descriptionThe criterion resource name.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.location.geo_target_constant

Field descriptionThe geo target constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.location_group

Field descriptionImmutable. Location Group
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v18.common.LocationGroupInfo
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.location_group.enable_customer_level_location_asset_set

Field descriptionDenotes that the latest customer level asset set is used for targeting. Used with radius and radius_units. Cannot be used with feed, geo target constants or feed item sets. When using asset sets, either this field or location_group_asset_sets should be specified. Both cannot be used at the same time. This can only be set in CREATE operations.
CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.location_group.feed

Field descriptionFeed specifying locations for targeting. Cannot be set with AssetSet fields. This is required and must be set in CREATE operations.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.location_group.geo_target_constants

Field descriptionGeo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed. Cannot be set with AssetSet fields.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableFalse
SortableFalse
RepeatedTrue

campaign_criterion.mobile_app_category.mobile_app_category_constant

Field descriptionThe mobile app category constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.mobile_application.app_id

Field descriptionA string that uniquely identifies a mobile application to Google Ads API. The format of this string is "{platform}-{platform_native_id}", where platform is "1" for iOS apps and "2" for Android apps, and where platform_native_id is the mobile application identifier native to the corresponding platform. For iOS, this native identifier is the 9 digit string that appears at the end of an App Store URL (for example, "476943146" for "Flood-It! 2" whose App Store link is "http://itunes.apple.com/us/app/flood-it!-2/id476943146"). For Android, this native identifier is the application's package name (for example, "com.labpixies.colordrips" for "Color Drips" given Google Play link "https://play.google.com/store/apps/details?id=com.labpixies.colordrips"). A well formed app id for Google Ads API would thus be "1-476943146" for iOS and "2-com.labpixies.colordrips" for Android. This field is required and must be set in CREATE operations.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.mobile_application.name

Field descriptionName of this mobile application.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.mobile_device.mobile_device_constant

Field descriptionThe mobile device constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.negative

Field descriptionImmutable. Whether to target (false) or exclude (true) the criterion.
CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.operating_system_version.operating_system_version_constant

Field descriptionThe operating system version constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.parental_status.type

Field descriptionType of the parental status.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.ParentalStatusTypeEnum.ParentalStatusType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.placement.url

Field descriptionURL of the placement. For example, "http://www.domain.com".
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.address.city_name

Field descriptionName of the city.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.address.country_code

Field descriptionCountry code.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.address.postal_code

Field descriptionPostal code.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.address.province_code

Field descriptionProvince or state code.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.address.province_name

Field descriptionProvince or state name.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.address.street_address

Field descriptionStreet address line 1.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.geo_point.latitude_in_micro_degrees

Field descriptionMicro degrees for the latitude.
CategoryATTRIBUTE
Data TypeINT32
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.geo_point.longitude_in_micro_degrees

Field descriptionMicro degrees for the longitude.
CategoryATTRIBUTE
Data TypeINT32
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.radius

Field descriptionThe radius of the proximity.
CategoryATTRIBUTE
Data TypeDOUBLE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.radius_units

Field descriptionThe unit of measurement of the radius. Default is KILOMETERS.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.ProximityRadiusUnitsEnum.ProximityRadiusUnits
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.resource_name

Field descriptionImmutable. The resource name of the campaign criterion. Campaign criterion resource names have the form: customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.status

Field descriptionThe status of the criterion.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.CampaignCriterionStatusEnum.CampaignCriterionStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.topic.path

Field descriptionThe category to target or exclude. Each subsequent element in the array describes a more specific sub-category. For example, "Pets & Animals", "Pets", "Dogs" represents the "Pets & Animals/Pets/Dogs" category.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

campaign_criterion.topic.topic_constant

Field descriptionThe Topic Constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.type

Field descriptionOutput only. The type of the criterion.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.CriterionTypeEnum.CriterionType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.user_interest.user_interest_category

Field descriptionThe UserInterest resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.user_list.user_list

Field descriptionThe User List resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.webpage.conditions

Field descriptionConditions, 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.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v18.common.WebpageConditionInfo
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

campaign_criterion.webpage.coverage_percentage

Field descriptionWebsite 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.
CategoryATTRIBUTE
Data TypeDOUBLE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.webpage.criterion_name

Field descriptionThe 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.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.webpage.sample.sample_urls

Field descriptionWebpage sample urls
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

campaign_criterion.youtube_channel.channel_id

Field descriptionThe YouTube uploader channel id or the channel code of a YouTube channel.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.youtube_video.video_id

Field descriptionYouTube video id as it appears on the YouTube watch page.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse