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:restriction>
    </xs:simpleType>
  </xs:list>
</xs:simpleType>

Values

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., custom audiences, in-market audiences, product 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., CustomAudience, InMarketAudience, ProductAudience, RemarketingList, and SimilarRemarketingList.
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.
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.
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