This feature is currently available in Australia, Austria, Belgium, Canada, France, Germany, India, Italy, Netherlands, Spain, Sweden, Switzerland, the United Kingdom, and the United States.
Your feed file is a text delimited file that contains all the information needed to submit a promotion. For manual uploads, .tsv or .xml file formats are accepted. For FTP uploads (available in the United States only), .tsv, .txt, or .xml file formats are accepted. After you create a feed file, submit it to Microsoft Merchant Center.
Here are the required and optional fields you can include in the catalog feed:
Field name | Description | What you need to know |
---|---|---|
promotion_id |
The unique ID for the promotion.
Example:
Requirements:
|
|
product_applicability |
Indicates if the promotion is applicable to all products or specific products.
Valid values:
|
|
offer_type |
Indicates if there is a code or not.
Valid values:
|
|
long_title |
The full title of the promotion.
Example:
Requirements:
|
|
promotion_effective_dates |
Date and time that the promotion will be live on Bing.com.
Example:
Requirements:
|
|
redemption_channel |
Indicates if the promotion is online.
Valid value:
|
Field name | Description | What you need to know |
---|---|---|
generic_redemption_code |
The text code that customers use online.
Example:
Requirements:
|
|
promotion_display_dates |
Date and time that the promotion will be live on Bing.com that falls within the promotion_effective_dates.
Example:
Requirements:
|
|
microsoft_exclusive |
This allows you to indicate to potential customers that your promotional code is only available on the Microsoft Search Network (Bing, AOL, and Yahoo).
Valid values:
|
|
coupon_value_type |
Indicates the type of promotion that you would like to offer potential customers.
Valid values:
|
|
minimum_purchase_amount |
The minimum amount of purchase for the promotion to be applicable.
Example:
Requirements:
|
|
money_off_amount |
The discount amount that you are offering.
Example:
Requirements:
|
|
percent_off |
Indicates the percentage discount offered in the promotion.
Example:
Requirements:
|
|
free_gift_description |
Indicates the description (but not the value) of any free gift offered in the promotion.
Example:
Requirements:
|
|
free_gift_item_id |
The free gift item’s unique identifier in your Merchant Center From the top menu, select Tools > Merchant Center. If you're using the new Microsoft Advertising navigation, from the navigation menu on the left, select Tools > Merchant Center. store feed file.
Example:
Requirements:
|
|
free_gift_value |
Indicates the monetary value of the free gift offered in the promotion.
Example:
Requirements:
|
|
buy_this_quantity |
The minimum quantity of purchased products required for the promotion to be applicable.
Example:
Requirements:
|
|
free_shipping_type |
Indicates the type of free shipping that you are offering.
Valid values:
|