customer_negative_criterion

AI-generated Key Takeaways

• Customer negative criterion in Google Ads is used for exclusions at the customer level.

• You can select fields from customer, mobile app category constant, and shared set resources along with the customer negative criterion resource in your SELECT and WHERE clauses.

• Various fields are available for customer negative criterion, including content label type, ID, IP block address, mobile app category, mobile application details, negative keyword list, placement URL, resource name, type, YouTube channel ID, and YouTube video ID.

• The resource name field provides an immutable identifier for a customer negative criterion.

• The type field is output-only and indicates the type of the criterion, such as AD_SCHEDULE, KEYWORD, PLACEMENT, or YOUTUBE_CHANNEL.

Help me build a query

A negative criterion for exclusions at the customer level.

Attributed resources
customer
mobile_app_category_constant
shared_set

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.

customer_negative_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.v20.enums.ContentLabelTypeEnum.ContentLabelType Filterable True Selectable True Sortable True Repeated False

customer_negative_criterion.id Field description Output only. The ID of the criterion. Category ATTRIBUTE Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

customer_negative_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

customer_negative_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

customer_negative_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

customer_negative_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

customer_negative_criterion.negative_keyword_list.shared_set Field description The NegativeKeywordListInfo shared set resource name. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

customer_negative_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

customer_negative_criterion.resource_name Field description Immutable. The resource name of the customer negative criterion. Customer negative criterion resource names have the form: customers/{customer_id}/customerNegativeCriteria/{criterion_id} Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

customer_negative_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 WEBPAGE_LIST YOUTUBE_CHANNEL YOUTUBE_VIDEO Type URL google.ads.googleads.v20.enums.CriterionTypeEnum.CriterionType Filterable True Selectable True Sortable True Repeated False

customer_negative_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

customer_negative_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