ShoppingSetting Data Object - Campaign Management

Defines the campaign level settings to leverage your Microsoft Merchant Center store.

You can include a shopping setting with both Shopping campaigns and feed-based Audience campaigns i.e., those campaigns that leverage a Microsoft Merchant Center store ID.

Supported shopping settings vary by campaign type.

  • Audience campaigns only support the StoreId element.
  • Shopping campaigns support all shopping settings.

Syntax

<xs:complexType name="ShoppingSetting" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Setting">
      <xs:sequence>
        <xs:element minOccurs="0" name="LocalInventoryAdsEnabled" nillable="true" type="xs:boolean" />
        <xs:element minOccurs="0" name="Priority" nillable="true" type="xs:int" />
        <xs:element minOccurs="0" name="SalesCountryCode" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="StoreId" nillable="true" type="xs:long" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

Element Description Data Type
LocalInventoryAdsEnabled Determines whether local inventory ads are enabled for the Microsoft Merchant Center store.

Not everyone has this feature yet. If you don't, don't worry. It's coming soon.

Set this property to true if you want to enable local inventory ads, and otherwise set it to false.

Add: Optional. If you do not specify this element or leave it empty, the default value of false will be set and local inventory ads will not be enabled.
Update: Optional. If no value is set for the update, this setting is not changed.
boolean
Priority Helps determine which Microsoft Shopping campaign serves ads, in the event that two or more campaigns use the product catalog feed from the same Microsoft Merchant Center store.

You must specify one of the supported values: 0, 1, or 2. The higher numbers are given higher priority.

If two shopping campaigns use the product catalog feed from same Microsoft Merchant Center store, then ads will be delivered for the BiddableAdGroupCriterion with the highest bid.

In the Microsoft Advertising web application, the default priority selected is "Low" which is the equivalent of '0'.

Add: Required
Update: Optional
int
SalesCountryCode The country code for the Microsoft Merchant Center store.

The Microsoft Merchant Center store catalog will be filtered to only include products for the specified country.

To get the list of supported country codes use the GetBSCCountries operation.

Add: Required
Update: Read-only
string
StoreId The unique identifier for the Microsoft Merchant Center store that contains a product catalog feed that you want to use for the campaign.

Once you choose a store for a campaign, you can't change it. If at some point you want to use a different store, you would need to create a new shopping campaign with a new shopping setting.

To get the StoreId, call the GetBMCStoresByCustomerId operation. The Id element of a BMCStore corresponds to this StoreId.

Add: Required
Update: Read-only
long

The ShoppingSetting object has Inherited Elements.

Inherited Elements

Inherited Elements from Setting

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

Element Description Data Type
Type The type of the setting. This value is Shopping when you retrieve a shopping setting. For more information about setting types, see the Setting Data Object Remarks.

Add: Read-only
Update: Read-only
string

Requirements

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