Как подключить отображение промокодов для всех пользователей

Информация о промокодах, которые доступны всем пользователям, передается в Яндекс Товарах в товарном YML-фиде. В блоке данных о промокодах указываются условия акции и идентификаторы товаров или категорий, которые в ней участвуют.

Шаг 1. Подготовьте данные

Добавьте информацию о промокодах в товарный фид.

Требования

Укажите товарные предложения и промокоды, которые к ним относятся, в одном товарном фиде.
Укажите конкретное предложение только в одной акции.

Внимание

Если предложение указано в разных акциях, для него случайным образом будет выбрана одна. В остальных акциях предложение участвовать не будет.

Важно

Чтобы промокоды правильно индексировались, в товарном фиде элемент <promos> должен предшествовать элементу <offers>.

Элемент	Описание	Обязателен
`promos`	Блок данных о промокодах.	Да

Элементы внутри `promos`

promo

Данные о промокодах.

Да

Атрибут `id`	Идентификатор промокода. Не может совпадать с идентификаторами программ лояльности и других акций. Может содержать только цифры, латинские буквы и кириллицу. Максимальная длина `id` — 20 символов.	Да
Атрибут `type`	Тип акции — `promo code`.	Да
`start-date` `end-date`	Дата и время начала акции. Должна быть меньше даты завершения акции (`end-date`). Дата и время завершения акции. Допустимые форматы: `YYYY-MM-DD` — дата: год, месяц, день (часовой пояс региона, в котором находится магазин); `YYYY-MM-DD hh:mm` / `YYYY-MM-DDThh:mm` — дата и время (часовой пояс региона, в котором находится магазин); `YYYY-MM-DD hh:mm:ss` / `YYYY-MM-DDThh:mm:ss` — дата и время c секундами (часовой пояс региона, в котором находится магазин); `YYYY-MM-DD hh:mmZ` / `YYYY-MM-DDThh:mmZ` — дата и время (`Z` — часовой пояс, например, +0300); `YYYY-MM-DD hh:mm:ssZ` / `YYYY-MM-DDThh:mm:ssZ` — дата и время c секундами (`Z` — часовой пояс, например, +0300). Примеры `2023-03-01` `2023-03-01 09:00` `2023-03-01 09:00:01` `2023-03-01 09:00+0500` `2023-03-01 09:00:01+0500`	Да
`url`	Ссылка на описание акции на сайте магазина. Максимальная длина ссылки — 2048 символов. Допускаются кириллические ссылки. URL-адрес формируется по стандарту RFC 3986.	Да
`promo-code`	Текст промокода. Может содержать цифры, латинские буквы и символы "-", "—", "_". Максимальная длина — 20 символов.	Да
`discount`	Размер скидки в процентах от стоимости или в валюте. Тип скидки указывается в атрибутах: `unit="percent"` — скидка в процентах, доступные значения: от 5 до 95 процентов; `unit="currency" currency="RUR"` — скидка в валюте, доступно значение `RUR`. Примеры Скидка 300 руб. `<discount unit="currency" currency="RUR">300</discount>` Скидка 10% `<discount unit="percent">10</discount>`	Да
`purchase`	Информация о товарах, участвующих в акции. Может содержать несколько элементов `product`, но не больше 1 000 000.	Да

Элементы внутри `purchase`

product

Товары, на которые действует акция. Содержит обязательный атрибут offer-id — идентификатор предложения.

Один элемент product соответствует одному товару. Максимальное количество элементов product — 1 000 000.

В элементе purchase может быть несколько элементов product.

<purchase>
  <product offer-id="03"/>
  <product offer-id="04"/>
</purchase>

Да

Описание элементов в разметке:

...
     <promos>
          <promo id="Идентификатор акции" type="promo code">
              <start-date>Дата начала акции</start-date>
              <end-date>Дата завершения акции</end-date>
              <url>Акция на сайте магазина</url>
              <promo-code>Промокод</promo-code>
              <discount unit="Скидка в процентах или валюте" currency="Валюта">Размер скидки</discount>
              <purchase>
                  <product offer-id="Идентификатор предложения, которое участвует в акции"></product>
                  <!-- другие товары, на которые действует акция -->
              </purchase>
          </promo>
     </promos>

Шаг 2. Передайте данные в Яндекс

Добавьте ссылку на фид в Яндекс Товарах на странице Товарные фиды и дождитесь проверки.

Примеры

Скидка 100 руб.

...
         <promo id="bestpromo00" type="promo code">
             <start-date>2023-01-11 09:00:00</start-date>
             <end-date>2023-12-01 09:00:00</end-date>
             <promo-code>TESTPROMOCODE1</promo-code>
             <discount unit="currency" currency="RUR">100</discount>
             <url>http://best.seller.ru/promos/bestpromo00</url>
             <purchase>
                 <product offer-id="1001"></product>
                 <product offer-id="1002"></product>
             </purchase>
         </promo>
...

Скидка 10%

...
         <promo id="bestpromo02" type="promo code">
             <start-date>2022-02-01 09:00:00</start-date>
             <end-date>2022-12-01 09:00:00</end-date>
             <promo-code>TESTPROMOCODE2</promo-code>
             <discount unit="percent">10</discount>
             <url>http://best.seller.ru/promos/bestpromo02</url>
             <purchase>
                 <product offer-id="1004"></product>
                 <product offer-id="1005"></product>
             </purchase>
         </promo>
...

Фид с элементом promos

<yml_catalog date="2023-04-10 06:00+0300">
 <shop>
  <name>BestSeller</name>
  <company>Tne Best inc.</company>
  <url>http://best.seller.ru</url>
  <version>1.0</version>
  <email>example-email@yandex.ru</email>
  <currencies>
   <currency id="RUB" rate="1"></currency>
  </currencies>
  <categories>
   <category id="1">Бытовая техника</category>
   <category id="10" parentId="1">Мелкая техника для кухни</category>
   <category id="101" parentId="10">Расходные материалы</category>
  </categories>
  <promos>
   <promo id="bestpromo00" type="promo code">
    <start-date>2023-01-11 09:00:00</start-date>
    <end-date>2023-12-01 09:00:00</end-date>
    <promo-code>TESTPROMOCODE1</promo-code>
    <discount unit="currency" currency="RUR">100</discount>
    <url>http://best.seller.ru/promos/bestpromo00</url>
    <purchase>
     <product offer-id="1001"></product>
     <product offer-id="1002"></product>
    </purchase>
   </promo>
   <promo id="bestpromo02" type="promo code">
    <start-date>2022-02-01 09:00:00</start-date>
    <end-date>2022-12-01 09:00:00</end-date>
    <promo-code>TESTPROMOCODE2</promo-code>
    <discount unit="percent">10</discount>
    <url>http://best.seller.ru/promos/bestpromo02</url>
    <purchase>
     <product offer-id="1004"></product>
     <product offer-id="1005"></product>
    </purchase>
   </promo>
  </promos>
  <offers>
   <offer id="1000" available="true">
    <url>http://best.seller.ru/9728.html</url>
    <price>900</price>
    <currencyId>RUB</currencyId>
    <categoryId>101</categoryId>
    <name>Заправка картриджа Samsung CLT-M504S красный</name>
    <picture>http://best.seller.ru/upload/2b6d0675ad027a19e6377278746437ef3.jpg</picture>
    <description>
     <![CDATA[<p>Заправка картриджа Samsung CLT-M504S красный</p>]]>
    </description>
   </offer>
   <offer id="1001" available="true">
    <url>http://best.seller.ru/10752.html</url>
    <price>1650</price>
    <currencyId>RUB</currencyId>
    <categoryId>101</categoryId>
    <name>Заправка картриджа Kyocera TK-3130</name>
    <picture>http://best.seller.ru/upload/2eb840e22702d851ef2610623942830b3.jpg</picture>
    <description>
     <![CDATA[<p>Заправка картриджа Kyocera TK-3130</p>]]>
    </description>
   </offer>
   <offer id="1002" available="true">
    <url>http://best.seller.ru/21504.html</url>
    <price>1680</price>
    <currencyId>RUB</currencyId>
    <categoryId>101</categoryId>
    <name>Заправка картриджа HP CF237X</name>
    <picture>http://best.seller.ru/upload/312715ab35bdd8f8a288baa874c5a8791.jpg</picture>
    <description>
     <![CDATA[<p>Заправка картриджа HP CF237X</p>]]>
    </description>
   </offer>
   <offer id="1003" available="true">
    <url>http://best.seller.ru/21760.html</url>
    <price>550</price>
    <currencyId>RUB</currencyId>
    <categoryId>101</categoryId>
    <name>Заправка картриджа Ricoh Type SP200HE, с чипом</name>
    <picture>http://hananodou.ru/upload/iblock/a14/a14b7e8ee83eefaa18649e3e3da8a36d.jpg</picture>
    <description>
     <![CDATA[<p>Заправка картриджа Ricoh Type SP200HE, с чипом</p>]]>
    </description>
   </offer>
   <offer id="1004" available="true">
    <url>http://best.seller.ru/9729.html</url>
    <price>920</price>
    <currencyId>RUB</currencyId>
    <categoryId>101</categoryId>
    <name>Заправка картриджа Samsung CLT-Y504S желтый</name>
    <picture>http://best.seller.ru/upload/444bee3b54adbcb384a9ddaeeeeb374b4.jpg</picture>
    <description>
     <![CDATA[<p>Заправка картриджа Samsung CLT-Y504S желтый</p>]]>
    </description>
   </offer>
   <offer id="1005" available="true">
    <url>http://best.seller.ru/10753.html</url>
    <price>1270</price>
    <currencyId>RUB</currencyId>
    <categoryId>101</categoryId>
    <name>Заправка картриджа Kyocera TK-400</name>
    <picture>http://best.seller.ru/upload/3aadd586142598ab139325cf5ce0ed771.jpg</picture>
    <description>
     <![CDATA[<p>Заправка картриджа Kyocera TK-400</p>]]>
    </description>
   </offer>
  </offers>
 </shop>
</yml_catalog>

Написать в службу поддержки

Как подключить отображение промокодов для всех пользователей

Шаг 1. Подготовьте данные

Требования

Элементы внутри promos

Элементы внутри promo

Элементы внутри purchase

Шаг 2. Передайте данные в Яндекс

Примеры

Была ли статья полезна?

Элементы внутри `promos`

Элементы внутри `promo`

Элементы внутри `purchase`