Special price for a limited time

Specify the discount price and the promo period in the price list.

Requirements

General requirements

The old price is higher than the current one.
Percentage discount is at least 5% and no more than 95%. The percentage is rounded to an integer.
The discount is in the currency in which the product price is listed and is not less than 1 unit.
The product was on sale at the old price (or at a higher price) for at least 5 consecutive days within the past 30 days.

Maximum price

Yandex.Market checks that you haven't overpriced the product recently. To do this, it:

Calculates the maximum price, i.e., a value your price didn't fall below for at least 5 consecutive days within the last 30 days.
Counts clicks on highly priced offers, i.e., those with the price not lower than your maximum price.
Checks that you didn't overcharge your customers. The offer is validated if at least one of the following conditions is met:
- Clicks on highly priced offers make up at least 5% of the clicks on all offers.
- Clicks on highly priced offers have been sufficient for purchase. Yandex.Market estimates the amount needed based on the data on average conversion in the category and number of clicks on all offers.

Attention. The offer may again qualify for a discount when the maximum old price changes and all conditions are met. Yandex.Market recalculates the price once per day.

Current price and history

The offer is validated if at least one of the following conditions is met:

The offer is not among the 10% most expensive offers on the product profile.
Over the past 30 days, the offer got at least 10% from clicks on the most popular offer on the product profile.
Over the past 30 days, the offer got sufficient clicks to get a purchase in this category. Yandex.Market estimates the clicks needed based on the data on average conversion and average clicks in the category.

Discount

The discount should be appealing to the customer. How Yandex.Market evaluates this:

It adds up clicks accumulated by all offers on the product profile for the past 30 days (total number of clicks).
It counts clicks on offers priced in the range from your old to your new price (clicks within the discount range).

If clicks within the discount range make up at least 5% of the total, the discount is considered appealing.

Structure

<promos>
   <promo id="promo ID" type="flash discount">
      <start-date>start of promo</start-date>
      <end-date>end of promo</end-date>
      <description>short description</description>
      <url>promo on the store's website</url>
      <purchase>
        <product offer-id=" ID of the promo offer">
          <discount-price currency=" currency">discount price</discount-price>
        </product>
        ...
      </purchase>
   </promo>
</promos>

Attributes and elements


Element/attribute	Description	Required
Attribute `id`	ID of the promotion. May not be identical to the IDs of loyalty programs or other promotions. It may contain only numbers and Latin letters. The maximum length of `id` is 20 characters. Attention. Specific offers may only participate in one promo or loyalty program. If an offer is included in multiple promos or loyalty programs, one will be selected for it at random.	Required
Attribute `type`	Type of promo — `flash discount`.	Required
`start-date` `end-date`	Date and time when the promo starts. Date and time the promo ends. Permissible formats: `YYYY-MM-DD` — Date: year, month, day (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mm` / `YYYY-MM-DDThh:mm` — Date and time (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mm:ss` / `YYYY-MM-DDThh:mm:ss` — Date and time with seconds (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mmZ` / `YYYY-MM-DDThh:mmZ` — Date and time (`Z` — time zone, for example, +0300). `YYYY-MM-DD` `hh:mm:ssZ` / `YYYY-MM-DDThh:mm:ssZ` — Date and time with seconds (`Z` — time zone, for example, +0300). Examples `2018-09-01` `2018-09-01 09:00` `2018-09-01 09:00:01` `2018-09-01 09:00+0500` `2018-09-01 09:00:01+0500` The maximum duration of a promo is 7 days.	Required
`description`	Brief description of the promo. Maximum of 500 characters. You can use XHTML markup, but only as a `CDATA` block of character data.	Optional
`url`	Link to the promotion description on the store's website. Link may not exceed 2048 symbols. Cyrillic links are permitted. The URL address must conform to the RFC 3986 standard.	Optional
`purchase`	Information about items participating in the promotion.	Required
Elements in `purchase`
`product`	Items that the promotion applies to. Specify their IDs in the `offer-id` attribute. Attention. Categories cannot participate in the promotion (only individual items can participate). Each `product` element corresponds to a single item. A `purchase` element may contain multiple `product` elements.	Required
`discount-price`	Discount price during the promo. Specify the currency in the `currency` attribute.	Required


Element/attribute	Description	Required
Attribute `id`	ID of the promotion. May not be identical to the IDs of loyalty programs or other promotions. It may contain only numbers and Latin letters. The maximum length of `id` is 20 characters. Attention. Specific offers may only participate in one promo or loyalty program. If an offer is included in multiple promos or loyalty programs, one will be selected for it at random.	Required
Attribute `type`	Type of promo — `flash discount`.	Required
`start-date` `end-date`	Date and time when the promo starts. Date and time the promo ends. Permissible formats: `YYYY-MM-DD` — Date: year, month, day (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mm` / `YYYY-MM-DDThh:mm` — Date and time (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mm:ss` / `YYYY-MM-DDThh:mm:ss` — Date and time with seconds (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mmZ` / `YYYY-MM-DDThh:mmZ` — Date and time (`Z` — time zone, for example, +0300). `YYYY-MM-DD` `hh:mm:ssZ` / `YYYY-MM-DDThh:mm:ssZ` — Date and time with seconds (`Z` — time zone, for example, +0300). Examples `2018-09-01` `2018-09-01 09:00` `2018-09-01 09:00:01` `2018-09-01 09:00+0500` `2018-09-01 09:00:01+0500` The maximum duration of a promo is 7 days.	Required
`description`	Brief description of the promo. Maximum of 500 characters. You can use XHTML markup, but only as a `CDATA` block of character data.	Optional
`url`	Link to the promotion description on the store's website. Link may not exceed 2048 symbols. Cyrillic links are permitted. The URL address must conform to the RFC 3986 standard.	Optional
`purchase`	Information about items participating in the promotion.	Required
Elements in `purchase`
`product`	Items that the promotion applies to. Specify their IDs in the `offer-id` attribute. Attention. Categories cannot participate in the promotion (only individual items can participate). Each `product` element corresponds to a single item. A `purchase` element may contain multiple `product` elements.	Required
`discount-price`	Discount price during the promo. Specify the currency in the `currency` attribute.	Required

Example

Special price from February 1 to February 7 (the store is located in Yekaterinburg, in the time zone UTC+5):

<promo id="Promo2" type="flash discount">
  <start-date>2018-02-01 09:00:00+0500</start-date>
  <end-date>2018-02-07 22:00:00+0500</end-date>
  <description>Скидка на старую коллекцию.</description>
  <url>http://best.seller.ru/promos/2</url>
  <purchase>
    <product offer-id="77">
      <discount-price currency="RUR">300</discount-price>
    </product>
    <product offer-id="88">
      <discount-price currency="RUR">501</discount-price>
    </product>
  </purchase>
</promo>

Changing offers and price history

Yandex.Market considers an offer to be new and resets the price history if you changed:

id The offer.
The name of the offer.

Note. The offer may again qualify for a discount in 5 days if all the requirements are met.

Changes in the title that don't affect the meaning are ignored. The history won't be reset if you:

Add or remove spaces. For example, there is no difference between:
iPhone8 64Gb и iPhone 8 64 Gb
Change the case. For example, there is no difference between:
Apple iPhone 8 64 Gb и apple iphone 8 64 gb.
Add or remove punctuation marks (a period, comma, semicolon, colon, hyphen, quotation marks, or parentheses). For example, there is no difference between:
iPhone 8, 64 Gb, "Gold" и iPhone 8 64 Gb Gold.

Changes in price during a promo

If you specify a price during a promo (element price) and that price is equal to or below the special promo price (element discount-price), then the offer will no longer be subject to the special price. Yandex.Market will display the offer price that you specified in element price.