AudienceCriterion Data Object - Campaign Management

Article
07/25/2023

Defines a criterion that can be used to show ads to a specific audience.

The AudienceCriterion can be included within AdGroupCriterion, NegativeAdGroupCriterion, CampaignCriterion, and NegativeCampaignCriterion objects. Audience targets cannot be set both campaign and ad group level. If you set any biddable campaign level audience criteria, then you cannot set any biddable ad group level audience criteria. Audience exclusions can be set at both campaign and ad group level. Microsoft Advertising applies a union of both campaign and ad group level exclusions.

Note

For new Video campaigns, only Remarketing lists, Similar audiences, In-market audiences, and Customer match lists are supported.

Syntax

<xs:complexType name="AudienceCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Criterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="AudienceId" nillable="true" type="xs:long" />
        <xs:element minOccurs="0" name="AudienceType" nillable="true" type="tns:AudienceType" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

The AudienceCriterion object has the following elements: AudienceId, AudienceType.

Element	Description	Data Type
AudienceId	The Microsoft Advertising identifier of the Audience. Add: Required Update: Read-only. You must leave this element null or the audience must already be associated with the specified entity. To associate a different audience with the entity, you must add a new audience criterion and optionally delete any existing audience criteria.	long
AudienceType	The audience type. Add: Read-only Update: Read-only	AudienceType

The AudienceCriterion object has Inherited Elements.

Inherited Elements

Inherited Elements from Criterion

The AudienceCriterion object derives from the Criterion object, and inherits the following elements: Type. The descriptions below are specific to AudienceCriterion, and might not apply to other objects that inherit the same elements from the Criterion object.

Element	Description	Data Type
Type	The type of the criterion. This value is Audience when you retrieve an audience criterion. For more information about criterion types, see the Criterion Data Object Remarks. Add: Read-only Update: Read-only	string

Requirements

Service: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Share via