customer_negative_criterion

AI-generated Key Takeaways

• A customer_negative_criterion in the Google Ads API represents an exclusion applied at the customer level.

• You can select fields from customer, mobile_app_category_constant, and shared_set resources along with customer_negative_criterion in your SELECT and WHERE clauses, but these will not segment metrics.

• The customer_negative_criterion resource has various fields for specifying exclusion types like content labels, IP addresses, mobile apps, negative keyword lists, placements, YouTube channels, and YouTube videos.

• Key output-only fields include customer_negative_criterion.id, customer_negative_criterion.resource_name, and customer_negative_criterion.type, which indicates the criterion type.

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.v19.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 YOUTUBE_CHANNEL YOUTUBE_VIDEO Type URL google.ads.googleads.v19.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