AdGroupCriterion Data Object - Campaign Management

Article
11/13/2024

Defines a criterion that you want applied to the specified ad group.

Do not try to instantiate an AdGroupCriterion. You can create one or more of the following objects that derive from it.

Syntax

<xs:complexType name="AdGroupCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AdGroupId" type="xs:long" />
    <xs:element minOccurs="0" name="Criterion" nillable="true" type="tns:Criterion" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdGroupCriterionStatus" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Elements

The AdGroupCriterion object has the following elements: AdGroupId, Criterion, Id, Status, Type.

Element	Description	Data Type
AdGroupId	The identifier of the ad group to apply the criterion to.	long
Criterion	The criterion to apply to the ad group. The criterion helps determine whether ads in the ad group are served. For a list of available criterion types, see AdGroupCriterionType.	Criterion
Id	The unique Microsoft Advertising identifier for the ad group criterion.	long
Status	A status value that determines whether to apply the criterion to the ad group.	AdGroupCriterionStatus
Type	The type of ad group criterion. For more information, see Remarks.	string

Remarks

For Java and the .NET languages, do not set the Type element because the value is determined by whether you instantiate a BiddableAdGroupCriterion or NegativeAdGroupCriterion.

If you generate the SOAP manually, use the type attribute of the <AdGroupCriterion> node as shown in the following example, to specify the type of criterion.

<AdGroupCriterion i:type="BiddableAdGroupCriterion" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <Id i:nil="true" />
    <Status i:nil="true" />
     . . .
</AdGroupCriterion>

Requirements

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

Used By

AddAdGroupCriterions
AdGroupCriterionAction
GetAdGroupCriterionsByIds
UpdateAdGroupCriterions

Share via