ProductPartition Data Object - Campaign Management

Article
03/20/2023

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

Share via