campaign_criterion

Help me build a query

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 ENUM FRIDAY MONDAY SATURDAY SUNDAY THURSDAY TUESDAY UNKNOWN UNSPECIFIED WEDNESDAY Type URL google.ads.googleads.v18.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 ENUM FIFTEEN FORTY_FIVE THIRTY UNKNOWN UNSPECIFIED ZERO Type URL google.ads.googleads.v18.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 ENUM FIFTEEN FORTY_FIVE THIRTY UNKNOWN UNSPECIFIED ZERO Type URL google.ads.googleads.v18.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 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.googleads.v18.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 ENUM BELOW_THE_FOLD BRAND_SUITABILITY_CONTENT_FOR_FAMILIES BRAND_SUITABILITY_GAMES_FIGHTING BRAND_SUITABILITY_GAMES_MATURE BRAND_SUITABILITY_HEALTH_SENSITIVE BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED BRAND_SUITABILITY_NEWS_RECENT BRAND_SUITABILITY_NEWS_SENSITIVE BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED BRAND_SUITABILITY_POLITICS BRAND_SUITABILITY_RELIGION EMBEDDED_VIDEO JUVENILE LIVE_STREAMING_VIDEO PARKED_DOMAIN PROFANITY SEXUALLY_SUGGESTIVE SOCIAL_ISSUES TRAGEDY UNKNOWN UNSPECIFIED VIDEO VIDEO_NOT_YET_RATED VIDEO_RATING_DV_G VIDEO_RATING_DV_MA VIDEO_RATING_DV_PG VIDEO_RATING_DV_T Type URL google.ads.googleads.v18.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 ENUM CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v18.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 ENUM FEMALE MALE UNDETERMINED UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v18.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 ENUM INCOME_RANGE_0_50 INCOME_RANGE_50_60 INCOME_RANGE_60_70 INCOME_RANGE_70_80 INCOME_RANGE_80_90 INCOME_RANGE_90_UP INCOME_RANGE_UNDETERMINED UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v18.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 ENUM BROAD EXACT PHRASE UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v18.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.v18.common.ListingDimensionInfo Filterable False Selectable True Sortable False Repeated True

campaign_criterion.listing_scope.dimensions.activity_city.value Field description String value of the activity city. 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.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.activity_state.value Field description String value of the activity state. 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.v18.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 ENUM NOT_A_PARENT PARENT UNDETERMINED UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v18.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 ENUM KILOMETERS MILES UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v18.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 ENUM ENABLED PAUSED REMOVED UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v18.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 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 NEGATIVE_KEYWORD_LIST OPERATING_SYSTEM_VERSION PARENTAL_STATUS PLACEMENT PROXIMITY SEARCH_THEME TOPIC UNKNOWN UNSPECIFIED USER_INTEREST USER_LIST WEBPAGE YOUTUBE_CHANNEL YOUTUBE_VIDEO Type URL google.ads.googleads.v18.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.v18.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