The CampaignCriterionService, AdGroupCriterionService, and CustomerNegativeCriterionService support targeting or excluding various types of criteria.
Campaign criteria
The CampaignCriterionService lets you specify targeting at the campaign level for the following types. You can also specify bid modifiers at this level using a multiplier, but you cannot set absolute bids.
- AdScheduleInfo
By default a new campaign will contain no ad schedules, meaning that ads will run for all time periods. You can set up an ad schedule, down to a quarter of an hour, to determine more precisely when to run your ads.
You can only target ad schedules. Exclusion is not supported.
- AgeRangeInfo
By default a new campaign will contain no age range criteria, which means that all ages are included.
- BrandListInfo
Specifies a list of brands. A criterion of this type can be either targeted or excluded.
- CarrierInfo
By default a new campaign will contain no content carrier criteria, which means all carriers are included. Only positive criteria are supported at the campaign level.
- CombinedAudienceInfo
Any number of Audience criteria can be combined in a combined audience. By default new campaigns do not contain any combined audiences. For more details see the Help Center article about combined audiences.
- ContentLabelInfo
By default a new campaign will contain no content label criteria, which means all categories are included. Only negative criteria are supported at the campaign level.
- CustomAffinityInfo
By default a new campaign will contain no custom affinity criteria. Custom affinity criteria are defined by CustomInterest resources that must be created by the user. Only positive criteria are supported. This article contains more details about how custom affinity criteria work and how to use them.
- CustomAudienceInfo
A list of users by interest. Custom audience criteria are defined by CustomAudience resources that must be created by the user. This article contains more details about how custom audience criteria work and how to use them.
- DeviceInfo
Define
DeviceInfocriteria using one of the predefined Device enums. The main use case for device targeting is to adjust bids for a specific device using thebid_modifiervalue of CampaignCriterion.You can only target devices. Exclusion is not supported.
- GenderInfo
By default a new campaign will contain no gender criteria, which means that all genders are included. Only negative criteria are supported at the campaign level.
- IncomeRangeInfo
By default a new campaign will contain no income range criteria, which means that all incomes are included. Only negative criteria are supported at the campaign level.
- IpBlockInfo
By default a new campaign won't contain IP blocking criteria, which means everything is included.
- KeywordInfo
Keywords are created using free-form text and one of the match type enum values.
You can only exclude keywords at the campaign level, so you must specify
negative = trueon a keyword's CampaignCriterion.- KeywordThemeInfo
Either a predefined keyword theme constant or free-form text may be specified.
- LanguageInfo
By default a new campaign won't contain language criteria, which means all languages are included. Only positive criteria are supported.
- ListingScopeInfo
By default a new campaign won't contain listing scope criteria. Only positive criteria are supported.
- LocalServiceIdInfo
Represents a service type (such as
install_faucet) that a Local Services Campaign can target.- LocationInfo
Named location targeting is implemented as
LocationInfoand are created using a fixed set of criteria IDs. The available IDs are listed in the documentation and can be individually searched for using theGeoTargetConstantService. These criteria can be configured as either positive or negative, with negative targets overriding positive ones. By default a new campaign will contain no location criteria, which means that all locations are targeted. With no location targeting, the ads are served everywhere. With location targeting added, the ads are served only in that region.Learn more about Named location targeting and Why is geo targeting important?.
- LocationGroupInfo
A
LocationGrouplets campaigns target multiple geographic regions. These regions are defined by a set of locations and a distance radius around each location in either meters or miles. The targeting of these locations can be filtered using a list of geotargeting criteria IDs.Learn more about targeting multiple geographic regions.
- MobileAppCategoryInfo
By default a new campaign won't contain mobile app category criteria, which means all categories are included. Only negative criteria at the campaign level are supported.
- MobileApplicationInfo
By default a new ad group won't contain mobile app criteria. Individual mobile apps must be identified according to the value of the
app_idfield.- MobileDeviceInfo
By default a new campaign won't contain mobile device criteria, which means that all devices are included.
To specify an individual mobile device you must use the resource name of a MobileDeviceConstant to set the
devicefield on campaign criteria.You can only target mobile devices. Exclusion is not supported.
- OperatingSystemVersionInfo
By default a new campaign will contain no operating system version criteria, which means that all operating systems are targeted. Only positive criteria are supported at the campaign level.
- ParentalStatusInfo
By default a new campaign will contain no parental status criteria, which means that all parental status categories are included. Only negative criteria are supported at the campaign level.
- PlacementInfo
These are created using a customer URL. There are limits on the length (250 characters) and depth (2 levels) of the URLs used. They can only be configured as negative, and by default a new campaign won't contain placement criteria. Negative placements with a URL of exactly
adsenseformobileapps.comare not allowed.- ProximityInfo
Radius targets are implemented as ProximityInfo criteria. They can be created using either an address or latitude-longitude, and by specifying a radius. They can only be configured as positive, and by default a new campaign won't contain proximity criteria.
Learn more about Radius targeting.
- TopicInfo
By default a new campaign won't contain topic criteria. Only negative criteria are supported at the campaign level. See Topics.
- UserInterestInfo
By default a new campaign won't contain user interest criteria. Only negative criteria are supported at the campaign level.
When retrieving
UserInterestto set inUserInterestInfo, verify theavailabilities[]are compatible with the campaign type. SomeUserInterestoptions are only available for specific campaign types.- UserListInfo
By default a new campaign won't contain user lists criteria. Use the ID of the user list to identify the user list in the criterion. Positive and negative criteria are supported at the campaign level.
- WebpageInfo
By default a new campaign won't contain web page criteria, which means all webpages are included. Only negative criteria at the campaign level are supported.
- YouTubeChannelInfo
By default a new campaign won't contain YouTube channel criteria. Only negative criteria are supported at the campaign level.
- YouTubeVideoInfo
By default a new campaign won't contain YouTube video criteria. Only negative criteria are supported at the campaign level.
Ad group criteria
The AdGroupCriterionService lets you specify targeting at the ad group level for the following types.
- AgeRangeInfo
- By default a new ad group will contain no age range criteria, which means that all ages are included. At the ad group level, you can bid on or exclude age ranges.
- AppPaymentModelInfo
- At the ad group level, you can only target app payment model criteria.
- AudienceInfo
- By default a new ad group won't contain audience criteria. Refer to the Create and manage audiences guide for how to set audience targeting for an ad group in Demand Gen campaigns.
- CombinedAudienceInfo
- Any number of Audience criteria can be combined in a combined audience. By default new ad groups do not contain any combined audiences. For more details see the Help Center article about combined audiences.
- CustomAffinityInfo
- By default a new ad group will contain no custom affinity criteria. Custom affinity criteria are defined by CustomInterest resources that must be created by the user. Only positive criteria are supported.This article contains more details about how custom affinity criteria work and how to use them.
- CustomAudienceInfo
- A list of users by interest. Custom audience criteria are defined by CustomAudience resources that must be created by the user. This article](https://support.google.com/google-ads/answer/2497941) contains more details about how custom audience criteria work and how to use them.
- CustomIntentInfo
- By default a new ad group won't contain custom intent criteria. Custom intent criteria are defined by CustomInterest resources that must be created by the user. Only positive criteria are supported. This article contains more information about how custom intent criteria work and how to use them.
- GenderInfo
- By default a new ad group will contain no gender criteria, which means that all genders are included. At the ad group level, you can bid on or exclude genders.
- IncomeRangeInfo
- By default a new ad group will contain no income range criteria, which means that all incomes are included. At the ad group level, you can bid on or exclude income ranges.
- KeywordInfo
- At the ad group level, you can either target or exclude keywords.
- LanguageInfo
- By default a new campaign won't contain language criteria, which means all languages are included. Only positive criteria are supported.
- ListingGroupInfo
- Listing groups define a tree-based structure of criteria for Hotel Ads and Shopping campaigns.
- LocationInfo
Named location targeting is implemented as
LocationInfoand are created using a fixed set of criteria IDs. The available IDs are listed in the documentation and can be individually searched for using theGeoTargetConstantService. These criteria can be configured as either positive or negative, with negative targets overriding positive ones. By default a new campaign will contain no location criteria, which means that all locations are targeted. With no location targeting, the ads are served everywhere. With location targeting added, the ads are served only in that region.Learn more about Named location targeting and Why is geo targeting important?.
- MobileAppCategoryInfo
At the ad group level, you can either target or exclude mobile app category criteria.
- MobileApplicationInfo
By default a new ad group won't contain mobile app criteria. Individual mobile apps must be identified according to the value of the
app_idfield.- ParentalStatusInfo
By default a new ad group will contain no parental status criteria, which means that all parental status categories are included. At the ad group level, you can bid on or exclude parental status categories.
- PlacementInfo
These are created using a customer URL. There are limits on the length (250 characters) and depth (2 levels) of the URLs used. They can only be configured as negative, and by default a new ad group won't contain placement criteria. Negative placements with a URL of exactly
adsenseformobileapps.comare not allowed.- TopicInfo
By default a new ad group won't contain topic criteria. At the ad group level, you can bid on or exclude income ranges.
- UserInterestInfo
By default a new ad group won't contain user interest criteria. At the ad group level, you can bid on or exclude user interests.
When retrieving
UserInterestto set inUserInterestInfo, verify theavailabilities[]are compatible with the campaign type. SomeUserInterestoptions are only available for specific campaign types.- UserListInfo
By default a new ad group won't contain user lists criteria. Use the ID of the user list to identify the user list in the criterion. At the ad group level, you can bid on or exclude user lists.
- WebpageInfo
At the ad group level, you can either target or exclude web page criteria.
- YouTubeChannelInfo
At the ad group level, you can either target or exclude YouTube channel criteria.
- YouTubeVideoInfo
At the ad group level, you can either target or exclude YouTube video criteria.
Customer criteria
The CustomerNegativeCriterionService lets you specify negative targeting at the account level for the following types.
- ContentLabelInfo
- By default a new campaign will contain no content label criteria, which means all categories are included. At the customer level, only negative ContentLabelInfo criteria are supported.
- IpBlockInfo
- By default a new campaign won't contain IP blocking criteria, which means everything is included. At the customer level, only negative IpBlockInfo criteria are supported.
- MobileAppCategoryInfo
- Exclude a mobile app category in the MobileAppCategoryConstant list.
- MobileApplicationInfo
- Exclude individual mobile apps according to the value of the
app_idfield. - NegativeKeywordList
- Exclude a
SharedSetof keywords. Only one negative keyword list criterion can be attached per account. - PlacementInfo
- These are created using a customer URL. There are limits on the length
(250 characters) and depth (2 levels) of the URLs used. Negative placements
with a URL of exactly
adsenseformobileapps.comare not allowed. - YouTubeChannelInfo
- Exclude a YouTube channel by its channel ID or channel code.
- YouTubeVideoInfo
- Exclude a specific YouTube video by its video ID as it appears on the YouTube watch page.