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: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, Industry, InMarketAudience, JobFunction, Location, LocationIntent, 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, 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, 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 For internal use only.
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.
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.
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