ProductAd Data Object - Campaign Management

Defines a product ad. A product ad is not used directly for delivered ad copy. Instead, the delivery engine generates product ads from the product details that it finds in the customer's Microsoft Merchant Center store.


<xs:complexType name="ProductAd" xmlns:xs="">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
        <xs:element minOccurs="0" name="PromotionalText" nillable="true" type="xs:string" />


Element Description Data Type
PromotionalText This property is reserved for internal use and will be removed from a future version of the API.

You can use Merchant Promotions if you want tags to appear at the bottom of your product ad as "special offer" links, helping to increase customer engagement.

Add: Optional
Update: Optional

The ProductAd object has Inherited Elements.

Inherited Elements

Inherited Elements from Ad

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

Element Description Data Type
AdFormatPreference This element is not applicable for product ads. string
DevicePreference Not supported for product ads. long
EditorialStatus The editorial review status of the ad, which indicates whether the ad is pending review, has been approved, or has been disapproved.

Add: Read-only
Update: Read-only
FinalAppUrls Not supported for product ads. AppUrl array
FinalMobileUrls Not supported for product ads. string array
FinalUrls Not supported for product ads. string array
FinalUrlSuffix Not supported for product ads. string
ForwardCompatibilityMap The list of key and value strings for forward compatibility to avoid otherwise breaking changes when new elements are added in the current API version.

There are currently not any ForwardCompatibilityMap key and value pairs that are applicable for product ads.
KeyValuePairOfstringstring array
Id The unique Microsoft Advertising identifier for the ad.

Add: Read-only
Update: Required and Read-only
Status The status of the ad.

You can set the ad status to Active or Paused.

Add: Optional
Update: Optional
TrackingUrlTemplate Not supported for product ads. string
Type The type of the ad. This value is Product when you retrieve a product ad. For more information about ad types, see the Ad Data Object Remarks.

Add: Read-only
Update: Read-only
UrlCustomParameters Not supported for product ads. CustomParameters


Service: CampaignManagementService.svc v13