What can I include in my Bing Merchant Promotion feed file?

What can I include in my Bing Merchant Promotion feed file?

Take a look at what the required and optional fields are for your Bing Merchant Promotion feed file.

Your feed file is a text delimited file that contains all the information needed to submit a promotion. After you create a feed file, submit it to Bing Merchant Center.

Here are the required and optional fields you can include in the catalog feed:

Required Fields expando image
Field name Description What you need to know
promotion_id The unique ID for the promotion.

Example:
50off

Requirements:
Alphanumeric
60-character limit

  • ID must be unique for each promotion.
  • For online promotions that apply to specific products, the promotion_id in the promotions feed must match the promotion_id in the product feed so Bing Ads knows which products apply to the promotion.
  • Spaces or symbols (for example, $ or %) are not allowed.
  • Values must be separated by commas.
product_applicability Indicates if the promotion is applicable to all products or specific products.

Valid values:
ALL_PRODUCTS
SPECIFIC_PRODUCTS

  • If the promotion is only applicable to specific products, the promotion_id column must be present in the product feeds. This is to ensure that the promotion is mapped to the right products.
  • If the promotion applies to all products, the promotion_id does not need to be added in the products feed.
offer_type Indicates if there is a code or not.

Valid values:
NO_CODE
GENERIC_CODE

  • This determines if the coupon code is required to redeem the offer.
  • A GENERIC_CODE is a code that is the same for all users.
long_title The full title of the promotion

Example:
Extra 50% off shoes

Requirements:
60-character limit

promotion_effective_dates Date and time that the promotion will be live on Bing.com

Example:
2016-07-07T01:00:00-08:00/2016-08-07T01:00:00-08:00

Requirements:
Format is Start-Date-Time/End-Date-Time

  • The promotion must be live on your website to be live on Bing.com.
  • Separate the start and end date with a forward slash (/).
  • The start and end date format is: (YYYY-MM-DD), followed by the letter T, then the time of day when the promotion starts, followed by the time zone expression as defined by the ISo 8601 standard. For example:

    If you want your promotion to run from 1:00 p.m. on July 7, 2016, to 1:00 p.m. on August 7, 2016 (Pacific Standard Time), you would submit: 2016_07-07T13:00:00-08:00/2016-08-07T13:00:00-08:00.

    If you want your promotion to run from 1:00 p.m. on July 7, 2016, to 1:00 p.m. on August 7, 2016 (Greenwich Mean Time), you would submit: 2016_07-07T13:00:00-00:00/2016-08-07T13:00:00-00:00.

    If you want your promotion to run from 1:00 p.m. on July 7, 2016, to 1:00 p.m. on August 7, 2016 (Eastern Standard Time), you would submit: 2016_07-07T13:00:00-05:00/2016-08-07T13:00:00-05:00.
redemption_channel Indicates if the promotion is online.

Valid value:
ONLINE

Optional Fields expando image
Field name Description What you need to know
generic_redemption_code The text code that customers use online

Example:
EXTRA50

Requirements:
Alphanumeric
60-character limit

  • This code is provided only when offer_type has a value of GENERIC_CODE.
promotion_display_dates Date and time that the promotion will be live on Bing.com that falls within the promotion_effective_dates

Example:
2016-07-07T01:00:00-08:00/2016-08-07T01:00:00-08:00

Requirements:
Format is Start-Date-Time/End-Date-Time

  • This can be used with promotion_effective_date to validate promotions before they are active.
  • Separate the start and end date with a forward slash (/).
  • The start and end date format is: (YYYY-MM-DD), followed by the letter T, then the time of day when the promotion starts, followed by the time zone expression as defined by the ISo 8601 standard. For example:

    If you want your promotion to run from 1:00 p.m. on July 7, 2016, to 1:00 p.m. on August 7, 2016 (Pacific Standard Time), you would submit: 2016_07-07T13:00:00-08:00/2016-08-07T13:00:00-08:00.

    If you want your promotion to run from 1:00 p.m. on July 7, 2016, to 1:00 p.m. on August 7, 2016 (Greenwich Mean Time), you would submit: 2016_07-07T13:00:00-00:00/2016-08-07T13:00:00-00:00.

    If you want your promotion to run from 1:00 p.m. on July 7, 2016, to 1:00 p.m. on August 7, 2016 (Eastern Standard Time), you would submit: 2016_07-07T13:00:00-05:00/2016-08-07T13:00:00-05:00.
minimum_purchase_amount The minimum amount of purchase for the promotion to be applicable.

Example:
15 USD

Requirements:
Numerica
No symbols (for example, $)

  • Only currencies in the specified country/region are supported.

See more videos...