Google Ads API is returning to beta status. Please read our blog post for more details.

campaign_criterion

The campaign criterion referenced in the query.

Selectable with

Attributed resources

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

campaign
carrier_constant
customer
feed
language_constant
mobile_app_category_constant
mobile_device_constant
operating_system_version_constant
topic_constant
user_interest
user_list

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.v1.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 URLgoogle.protobuf.Int32Value
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.v1.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 URLgoogle.protobuf.Int32Value
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.v1.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.v1.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 URLgoogle.protobuf.FloatValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.campaign

Field descriptionThe campaign to which the criterion belongs.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.carrier.carrier_constant

Field descriptionThe Carrier constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.content_label.type

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

campaign_criterion.criterion_id

Field descriptionThe ID of the criterion. This field is ignored during mutate.
CategoryATTRIBUTE
Data TypeINT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.device.type

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

campaign_criterion.gender.type

Field descriptionType of the gender.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.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.v1.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 URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.keyword.match_type

Field descriptionThe match type of the keyword.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.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 URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.language.language_constant

Field descriptionThe language constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.listing_scope.dimensions

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

campaign_criterion.listing_scope.dimensions.hotel_city.city_criterion

Field descriptionThe Geo Target Constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLgoogle.protobuf.StringValue
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 URLgoogle.protobuf.StringValue
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 URLgoogle.protobuf.StringValue
FilterableTrue
SelectableFalse
SortableFalse
RepeatedFalse

campaign_criterion.location.geo_target_constant

Field descriptionThe geo target constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.location_group

Field descriptionLocation Group
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v1.common.LocationGroupInfo
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.location_group.feed

Field descriptionFeed specifying locations for targeting. This is required and must be set in CREATE operations.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLgoogle.protobuf.StringValue
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.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLgoogle.protobuf.StringValue
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 URLgoogle.protobuf.StringValue
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 (e.g., "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 (e.g., "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 URLgoogle.protobuf.StringValue
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.mobile_application.name

Field descriptionName of this mobile application.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.mobile_device.mobile_device_constant

Field descriptionThe mobile device constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.negative

Field descriptionWhether to target (`false`) or exclude (`true`) the criterion.
CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLgoogle.protobuf.BoolValue
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 URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.parental_status.type

Field descriptionType of the parental status.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.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 URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.address.city_name

Field descriptionName of the city.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.address.country_code

Field descriptionCountry code.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.address.postal_code

Field descriptionPostal code.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.address.province_code

Field descriptionProvince or state code.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.address.province_name

Field descriptionProvince or state name.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.address.street_address

Field descriptionStreet address line 1.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.geo_point.latitude_in_micro_degrees

Field descriptionMicro degrees for the latitude.
CategoryATTRIBUTE
Data TypeINT32
Type URLgoogle.protobuf.Int32Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.geo_point.longitude_in_micro_degrees

Field descriptionMicro degrees for the longitude.
CategoryATTRIBUTE
Data TypeINT32
Type URLgoogle.protobuf.Int32Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.proximity.radius

Field descriptionThe radius of the proximity.
CategoryATTRIBUTE
Data TypeDOUBLE
Type URLgoogle.protobuf.DoubleValue
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.v1.enums.ProximityRadiusUnitsEnum.ProximityRadiusUnits
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.resource_name

Field descriptionThe 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.v1.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 URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

campaign_criterion.topic.topic_constant

Field descriptionThe Topic Constant resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.type

Field descriptionThe type of the criterion.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.enums.CriterionTypeEnum.CriterionType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.user_interest.user_interest_category

Field descriptionThe UserInterest resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_criterion.user_list.user_list

Field descriptionThe User List resource name.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLgoogle.protobuf.StringValue
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. This field is required for CREATE operations and is prohibited on UPDATE operations.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v1.common.WebpageConditionInfo
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

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 URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_criterion.youtube_channel.channel_id

Field descriptionThe YouTube uploader channel id or the channel code of a YouTube channel.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
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 URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse