ProductPartition Data Object - Campaign Management

Defines an ad group level product partition with one condition that helps determine whether a product from the Microsoft Merchant Center store gets served as a product ad.

The ProductPartition criterion can be included within BiddableAdGroupCriterion and NegativeAdGroupCriterion. Also note that campaign level ProductScope can be added to BiddableCampaignCriterion. Duplicate or conflicting product conditions attempted within an ad group's product partition group will fail via the ApplyProductPartitionActions operation; however, the operation will not validate whether duplicate or conflicting conditions already exist within the campaign level ProductScope.

Tip

For an implementation overview, see the Microsoft Shopping Campaigns technical guide.

Syntax

<xs:complexType name="ProductPartition" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Criterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="Condition" nillable="true" type="tns:ProductCondition" />
        <xs:element minOccurs="0" name="ParentCriterionId" nillable="true" type="xs:long" />
        <xs:element name="PartitionType" type="tns:ProductPartitionType" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

The ProductPartition object has the following elements: Condition, ParentCriterionId, PartitionType.

Element Description Data Type
Condition A condition that helps determine whether a product from the Microsoft Merchant Center store gets served as an ad.

Multiple product conditions can be specified by creating a tree of ProductPartition objects using ApplyProductPartitionActions. For a catalog item to be served as an ad, it must meet all conditions. To get a list of all conditions for an ad group, call GetAdGroupCriterionsByIds with the AdGroupCriterionIds element set to null and the CriterionType element set to ProductPartition.

Add: Required
Update: Update is not supported for this object
ProductCondition
ParentCriterionId The identifier of the parent BiddableAdGroupCriterion or NegativeAdGroupCriterion.

This element must be set to null if the product partition represents the root node of a product partition tree.

Add: Required
Update: Update is not supported for this object
Delete: Required
long
PartitionType The type of product partition, for example Subdivision or Unit.

Add: Required
Update: Update is not supported for this object
ProductPartitionType

The ProductPartition object has Inherited Elements.

Inherited Elements

Inherited Elements from Criterion

The ProductPartition object derives from the Criterion object, and inherits the following elements: Type. The descriptions below are specific to ProductPartition, 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 ProductPartition when you retrieve a product partition 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