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 description Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
Category ATTRIBUTE
Data Type
Type URL google.ads.googleads.v15.enums.DayOfWeekEnum.DayOfWeek
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.ad_schedule.end_hour

Field description Ending 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.
Category ATTRIBUTE
Data Type INT32
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.ad_schedule.end_minute

Field description Minutes 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.
Category ATTRIBUTE
Data Type
Type URL google.ads.googleads.v15.enums.MinuteOfHourEnum.MinuteOfHour
Filterable False
Selectable True
Sortable False
Repeated False

campaign_criterion.ad_schedule.start_hour

Field description Starting 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.
Category ATTRIBUTE
Data Type INT32
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.ad_schedule.start_minute

Field description Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
Category ATTRIBUTE
Data Type
Type URL google.ads.googleads.v15.enums.MinuteOfHourEnum.MinuteOfHour
Filterable False
Selectable True
Sortable False
Repeated False

campaign_criterion.age_range.type

Field description Type of the age range.
Category ATTRIBUTE
Data Type
Type URL google.ads.googleads.v15.enums.AgeRangeTypeEnum.AgeRangeType
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.bid_modifier

Field description The 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.
Category ATTRIBUTE
Data Type FLOAT
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.brand_list.shared_set

Field description Shared set resource name of the brand list.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated False

campaign_criterion.campaign

Field description Immutable. The campaign to which the criterion belongs.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated False

campaign_criterion.carrier.carrier_constant

Field description The Carrier constant resource name.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated False

campaign_criterion.combined_audience.combined_audience

Field description The CombinedAudience resource name.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.content_label.type

Field description Content label type, required for CREATE operations.
Category ATTRIBUTE
Data Type
Type URL google.ads.googleads.v15.enums.ContentLabelTypeEnum.ContentLabelType
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.criterion_id

Field description Output only. The ID of the criterion. This field is ignored during mutate.
Category ATTRIBUTE
Data Type INT64
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.custom_affinity.custom_affinity

Field description The CustomInterest resource name.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.custom_audience.custom_audience

Field description The CustomAudience resource name.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.device.type

Field description Type of the device.
Category ATTRIBUTE
Data Type
Type URL google.ads.googleads.v15.enums.DeviceEnum.Device
Filterable True
Selectable True
Sortable False
Repeated False

campaign_criterion.display_name

Field description Output only. The display name of the criterion. This field is ignored for mutates.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.gender.type

Field description Type of the gender.
Category ATTRIBUTE
Data Type
Type URL google.ads.googleads.v15.enums.GenderTypeEnum.GenderType
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.income_range.type

Field description Type of the income range.
Category ATTRIBUTE
Data Type
Type URL google.ads.googleads.v15.enums.IncomeRangeTypeEnum.IncomeRangeType
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.ip_block.ip_address

Field description The IP address of this IP block.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.keyword.match_type

Field description The match type of the keyword.
Category ATTRIBUTE
Data Type
Type URL google.ads.googleads.v15.enums.KeywordMatchTypeEnum.KeywordMatchType
Filterable True
Selectable True
Sortable True
Repeated False

campaign_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

campaign_criterion.keyword_theme.free_form_keyword_theme

Field description Free-form text to be matched to a Smart Campaign keyword theme constant on a best-effort basis.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.keyword_theme.keyword_theme_constant

Field description The resource name of a Smart Campaign keyword theme constant. keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id}
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated False

campaign_criterion.language.language_constant

Field description The language constant resource name.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated False

campaign_criterion.listing_scope.dimensions

Field description Scope of the campaign criterion.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v15.common.ListingDimensionInfo
Filterable False
Selectable True
Sortable False
Repeated True

campaign_criterion.listing_scope.dimensions.activity_country.value

Field description String value of the activity country. The Geo Target Constant resource name.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable False
Sortable False
Repeated False

campaign_criterion.listing_scope.dimensions.hotel_city.city_criterion

Field description The Geo Target Constant resource name.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable False
Sortable False
Repeated False

campaign_criterion.listing_scope.dimensions.hotel_country_region.country_region_criterion

Field description The Geo Target Constant resource name.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable False
Sortable False
Repeated False

campaign_criterion.listing_scope.dimensions.hotel_state.state_criterion

Field description The Geo Target Constant resource name.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable False
Sortable False
Repeated False

campaign_criterion.local_service_id.service_id

Field description The criterion resource name.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_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

campaign_criterion.location_group

Field description Immutable. Location Group
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v15.common.LocationGroupInfo
Filterable False
Selectable True
Sortable False
Repeated False

campaign_criterion.location_group.enable_customer_level_location_asset_set

Field description Denotes 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.
Category ATTRIBUTE
Data Type BOOLEAN
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.location_group.feed

Field description Feed specifying locations for targeting. Cannot be set with AssetSet fields. This is required and must be set in CREATE operations.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated False

campaign_criterion.location_group.geo_target_constants

Field description Geo 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.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable False
Sortable False
Repeated True

campaign_criterion.mobile_app_category.mobile_app_category_constant

Field description The mobile app category constant resource name.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated False

campaign_criterion.mobile_application.app_id

Field description A 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.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.mobile_application.name

Field description Name of this mobile application.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.mobile_device.mobile_device_constant

Field description The mobile device constant resource name.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated False

campaign_criterion.negative

Field description Immutable. Whether to target ( false ) or exclude ( true ) the criterion.
Category ATTRIBUTE
Data Type BOOLEAN
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.operating_system_version.operating_system_version_constant

Field description The operating system version constant resource name.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated False

campaign_criterion.parental_status.type

Field description Type of the parental status.
Category ATTRIBUTE
Data Type
Type URL google.ads.googleads.v15.enums.ParentalStatusTypeEnum.ParentalStatusType
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.placement.url

Field description URL of the placement. For example, "http://www.domain.com".
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.proximity.address.city_name

Field description Name of the city.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.proximity.address.country_code

Field description Country code.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.proximity.address.postal_code

Field description Postal code.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.proximity.address.province_code

Field description Province or state code.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.proximity.address.province_name

Field description Province or state name.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.proximity.address.street_address

Field description Street address line 1.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.proximity.geo_point.latitude_in_micro_degrees

Field description Micro degrees for the latitude.
Category ATTRIBUTE
Data Type INT32
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.proximity.geo_point.longitude_in_micro_degrees

Field description Micro degrees for the longitude.
Category ATTRIBUTE
Data Type INT32
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.proximity.radius

Field description The radius of the proximity.
Category ATTRIBUTE
Data Type DOUBLE
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.proximity.radius_units

Field description The unit of measurement of the radius. Default is KILOMETERS.
Category ATTRIBUTE
Data Type
Type URL google.ads.googleads.v15.enums.ProximityRadiusUnitsEnum.ProximityRadiusUnits
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.resource_name

Field description Immutable. The resource name of the campaign criterion. Campaign criterion resource names have the form: customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated False

campaign_criterion.status

Field description The status of the criterion.
Category ATTRIBUTE
Data Type
Type URL google.ads.googleads.v15.enums.CampaignCriterionStatusEnum.CampaignCriterionStatus
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.topic.path

Field description The 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.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated True

campaign_criterion.topic.topic_constant

Field description The Topic Constant resource name.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated False

campaign_criterion.type

Field description Output only. The type of the criterion.
Category ATTRIBUTE
Data Type
Type URL google.ads.googleads.v15.enums.CriterionTypeEnum.CriterionType
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.user_interest.user_interest_category

Field description The UserInterest resource name.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated False

campaign_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

campaign_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.googleads.v15.common.WebpageConditionInfo
Filterable False
Selectable True
Sortable False
Repeated True

campaign_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

campaign_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

campaign_criterion.webpage.sample.sample_urls

Field description Webpage sample urls
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated True

campaign_criterion.youtube_channel.channel_id

Field description The YouTube uploader channel id or the channel code of a YouTube channel.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False

campaign_criterion.youtube_video.video_id

Field description YouTube video id as it appears on the YouTube watch page.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False