ProductScope Data Object - Campaign Management

Defines a campaign level product scope with list of conditions that help determine which items from your catalog to include in the campaign e.g., filter by brand or condition.

You can use campaign product scopes with Shopping campaigns, feed-based Audience campaigns, and Search campaigns with multimedia ads i.e., those campaigns that leverage a Microsoft Merchant Center store ID. (Note: Not everyone has Search campaigns with multimedia ads yet. If you don't, don't worry - it's coming soon!)

Note

Product scope conditions are not supported with smart shopping campaigns i.e., campaigns with CampaignType set to Shopping and SubType set to ShoppingSmartAds.

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

Syntax

XML

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

JSON

{
  "Type": "ProductScope",
  "Conditions": [
    {
      "Attribute": "ValueHere",
      "Operand": "ValueHere",
      "Operator": "ValueHere"
    }
  ]
}

Elements

The ProductScope object has the following elements: Conditions.

Element	Description	Data Type
Conditions	A list of up to 7 product conditions that helps determine whether a product from the Microsoft Merchant Center store gets served as an ad. Product conditions might not be returned in the order that you submitted them. The available Attribute and Operand values vary depending on the campaign type. For supported attribute and operand values, see ProductCondition Remarks. Conditions might not be returned in the order that you submitted them. Add: Required Update: Required	ProductCondition array

The ProductScope object has Inherited Elements.

Inherited Elements

Inherited Elements from Criterion

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