AdGroupCriterionType Value Set - Campaign Management
Defines the possible types of ad group criterions.
Tip
For an overview of how to use target criterions e.g., company name and location, see Show Ads to Your Target Audience.
Syntax
<xs:simpleType name="AdGroupCriterionType" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:list>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="ProductPartition">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">2</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="Webpage">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">4</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="Targets">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">8</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="Age">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">16</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="Gender">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">32</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="DayTime">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">64</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="Device">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">128</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="Location">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">256</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="LocationIntent">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">512</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="Radius">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">1024</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="Audience">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">2048</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="CustomAudience">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">4096</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="InMarketAudience">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">8192</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="RemarketingList">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">16384</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="CompanyName">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">32768</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="JobFunction">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">65536</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="Industry">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">131072</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="ProductAudience">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">262144</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="SimilarRemarketingList">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">524288</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="CombinedList">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">1048576</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="HotelGroup">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">2097152</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="HotelAdvanceBookingWindow">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">4194304</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="HotelCheckInDay">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">8388608</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="HotelLengthOfStay">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">16777216</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="HotelDateSelectionType">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">33554432</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="HotelCheckInDate">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">67108864</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="Genre">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">134217728</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="CustomerList">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">268435456</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="ImpressionBasedRemarketingList">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">536870912</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="Placement">
<xs:annotation>
<xs:appinfo>
<EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">1073741824</EnumerationValue>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
</xs:restriction>
</xs:simpleType>
</xs:list>
</xs:simpleType>
Values
The AdGroupCriterionType value set has the following values: Age, Audience, CombinedList, CompanyName, CustomAudience, CustomerList, DayTime, Device, Gender, Genre, HotelAdvanceBookingWindow, HotelCheckInDate, HotelCheckInDay, HotelDateSelectionType, HotelGroup, HotelLengthOfStay, ImpressionBasedRemarketingList, Industry, InMarketAudience, JobFunction, Location, LocationIntent, Placement, ProductAudience, ProductPartition, Radius, RemarketingList, SimilarRemarketingList, Targets, Webpage.
| Value | Description |
|---|---|
| Age | The ad group criterion is an age criterion. The Criterion element of a BiddableAdGroupCriterion can be an instance of AgeCriterion. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of BidMultiplier when paired with this criterion type. Age exclusions with NegativeAdGroupCriterion are only supported with Audience campaigns. |
| Audience | The ad group criterion is an audience criterion. The Criterion element of either the BiddableAdGroupCriterion or NegativeAdGroupCriterion can be an instance of AudienceCriterion. In other words you can include some audiences, and exclude other audiences. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of BidMultiplier when paired with this criterion type. To add, delete, or update audience criterions i.e., combined lists, custom audiences, customer lists, impression-based remarketing lists, in-market audiences, product audiences, similar audiences, and remarketing lists, you must specify the Audience value. To retrieve these audience criterions via GetAdGroupCriterionsByIds you must request the specific type i.e., CombinedList, CustomAudience, CustomerList, ImpressionBasedRemarketingList, InMarketAudience, ProductAudience, RemarketingList, and SimilarRemarketingList. |
| CombinedList | The ad group criterion is a combined list association. This criterion type value is only used by the GetAdGroupCriterionsByIds operation to request the combined list associations represented by the AudienceCriterion objects. To manage the combined list, see CombinedList. |
| CompanyName | The ad group criterion is a company name profile criterion. The Criterion element of either the BiddableAdGroupCriterion or NegativeAdGroupCriterion can be an instance of ProfileCriterion where the ProfileType is set to CompanyName. In other words you can include some profiles, and exclude other profiles. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of BidMultiplier when paired with this criterion type. |
| CustomAudience | The ad group criterion is a custom audience association. This criterion type value is only used by the GetAdGroupCriterionsByIds operation to request the custom audience associations represented by the AudienceCriterion objects. To manage the custom audience, see CustomAudience. |
| CustomerList | The ad group criterion is a customer list. This criterion type value is only used by the GetAdGroupCriterionsByIds operation to request the customer lists represented by the AudienceCriterion objects. To manage the custom audience, see CustomerList. |
| DayTime | The ad group criterion is a day and time criterion. The Criterion element of a BiddableAdGroupCriterion can be an instance of DayTimeCriterion, but day and time criterion are not supported with NegativeAdGroupCriterion. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of BidMultiplier when paired with this criterion type. |
| Device | The ad group criterion is a device criterion. The Criterion element of a BiddableAdGroupCriterion can be an instance of DeviceCriterion, but device criterion are not supported with NegativeAdGroupCriterion. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of BidMultiplier when paired with this criterion type. |
| Gender | The ad group criterion is a gender criterion. The Criterion element of a BiddableAdGroupCriterion can be an instance of GenderCriterion. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of BidMultiplier when paired with this criterion type. Gender exclusions with NegativeAdGroupCriterion are only supported with Audience campaigns. |
| Genre | The ad group criterion is a genre criterion. The Criterion element of a BiddableAdGroupCriterion can be an instance of GenreCriterion. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of BidMultiplier when paired with this criterion type. |
| HotelAdvanceBookingWindow | The ad group criterion is a hotel advance booking window criterion. The Criterion element of either the BiddableAdGroupCriterion or NegativeAdGroupCriterion can be an instance of HotelAdvanceBookingWindowCriterion. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of BidMultiplier when paired with this criterion type. |
| HotelCheckInDate | The ad group criterion is a hotel check in date criterion. The Criterion element of either the BiddableAdGroupCriterion or NegativeAdGroupCriterion can be an instance of HotelCheckInDateCriterion. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of BidMultiplier when paired with this criterion type. |
| HotelCheckInDay | The ad group criterion is a hotel check in day criterion. The Criterion element of either the BiddableAdGroupCriterion or NegativeAdGroupCriterion can be an instance of HotelCheckInDayCriterion. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of BidMultiplier when paired with this criterion type. |
| HotelDateSelectionType | The ad group criterion is a hotel date selection type criterion. The Criterion element of either the BiddableAdGroupCriterion or NegativeAdGroupCriterion can be an instance of HotelDateSelectionTypeCriterion. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of BidMultiplier when paired with this criterion type. |
| HotelGroup | The criterion type for lodging campaigns. Set AdGroupCriterions to HotelGroup. |
| HotelLengthOfStay | The ad group criterion is a hotel length of stay criterion. The Criterion element of either the BiddableAdGroupCriterion or NegativeAdGroupCriterion can be an instance of HotelLengthOfStayCriterion. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of BidMultiplier when paired with this criterion type. |
| ImpressionBasedRemarketingList | The ad group criterion is an impression-based remarketing list. This criterion type value is only used by the GetAdGroupCriterionsByIds operation to request the impression-based remarketing lists represented by the AudienceCriterion objects. To manage the impression-based remarketing list, see ImpressionBasedRemarketingList. |
| Industry | The ad group criterion is an industry profile criterion. The Criterion element of either the BiddableAdGroupCriterion or NegativeAdGroupCriterion can be an instance of ProfileCriterion where the ProfileType is set to Industry. In other words you can include some profiles, and exclude other profiles. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of BidMultiplier when paired with this criterion type. |
| InMarketAudience | The ad group criterion is an in-market audience association. This criterion type value is only used by the GetAdGroupCriterionsByIds operation to request the in-market audience associations represented by the AudienceCriterion objects. To manage the in-market audience, see InMarketAudience. |
| JobFunction | The ad group criterion is a job function profile criterion. The Criterion element of either the BiddableAdGroupCriterion or NegativeAdGroupCriterion can be an instance of ProfileCriterion where the ProfileType is set to JobFunction. In other words you can include some profiles, and exclude other profiles. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of BidMultiplier when paired with this criterion type. |
| Location | The ad group criterion is a location criterion. The Criterion element of either the BiddableAdGroupCriterion or NegativeAdGroupCriterion can be an instance of LocationCriterion. In other words you can include some locations, and exclude other locations. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of BidMultiplier when paired with this criterion type. |
| LocationIntent | The ad group criterion is a location intent criterion. The Criterion element of a BiddableAdGroupCriterion can be an instance of LocationIntentCriterion, but location intent criterion are not supported with NegativeAdGroupCriterion. The CriterionBid element of a BiddableAdGroupCriterion must be nil or empty when paired with this criterion type. |
| Placement | Reserved. |
| ProductAudience | The ad group criterion is product audience association. This criterion type value is only used by the GetAdGroupCriterionsByIds operation to request the product audience associations represented by the AudienceCriterion objects. To manage the product audience, see ProductAudience. This audience type can only be used with Audience campaigns that have a ShoppingSetting. |
| ProductPartition | The ad group criterion is a product partition criterion. The Criterion element of either the BiddableAdGroupCriterion or NegativeAdGroupCriterion can be an instance of ProductPartition. In other words you can include some product partitions, and exclude other product partitions. This criterion type is only used with Microsoft Shopping Campaigns. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of FixedBid when paired with this criterion type. |
| Radius | The ad group criterion is a radius criterion. The Criterion element of a BiddableAdGroupCriterion can be an instance of RadiusCriterion, but radius criterion are not supported with NegativeAdGroupCriterion. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of BidMultiplier when paired with this criterion type. |
| RemarketingList | The ad group criterion is a remarketing list association. This criterion type value is only used by the GetAdGroupCriterionsByIds operation to request the remarketing list associations represented by the AudienceCriterion objects. To manage the remarketing list, see RemarketingList. |
| SimilarRemarketingList | The ad group criterion is a similar remarketing list association. This criterion type value is only used by the GetAdGroupCriterionsByIds operation to request the similar remarketing list associations represented by the AudienceCriterion objects. To manage the similar remarketing list, see SimilarRemarketingList. |
| Targets | Represents one or more AgeCriterion, DayTimeCriterion, DeviceCriterion, GenderCriterion, LocationCriterion, LocationIntentCriterion, ProfileCriterion, and RadiusCriterion objects that can be managed together to show ads based on your target criteria. To add, delete, or update target criterions i.e., age, company name, day and time, device, gender, industry, job function, location, location intent, and radius criterions, you must specify the CriterionType value as Targets. You can add, delete, and update multiple target criterion types in the same operation. To retrieve these target criterions via GetAdGroupCriterionsByIds you must request the specific type individually i.e., Age, CompanyName, DayTime, Device, Gender, Industry, JobFunction, Location, LocationIntent, and Radius. |
| Webpage | The ad group criterion is a webpage criterion. The Criterion element of either the BiddableAdGroupCriterion or NegativeAdGroupCriterion can be an instance of Webpage, but webpage criterion are not supported with BiddableAdGroupCriterion. In other words you can include some webpages, and exclude other webpages. This criterion type can only be used with Dynamic Search Ads campaigns. The CriterionBid element of a BiddableAdGroupCriterion must be an instance of FixedBid when paired with this criterion type. |
Requirements
Service: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13
Used By
AddAdGroupCriterions
DeleteAdGroupCriterions
GetAdGroupCriterionsByIds
UpdateAdGroupCriterions