Как подключить отображение промокодов для всех пользователей
Информация о промокодах, которые доступны всем пользователям, передается в Вебмастере в товарном YML-фиде. В блоке данных о промокодах указываются условия акции и идентификаторы товаров или категорий, которые в ней участвуют.
Шаг 1. Подготовьте данные
Добавьте информацию о промокодах в товарный фид.
Требования
-
-
Укажите товарные предложения и промокоды, которые к ним относятся, в одном товарном фиде.
-
Укажите конкретное предложение только в одной акции.
Внимание
Если предложение указано в разных акциях, для него случайным образом будет выбрана одна. В остальных акциях предложение участвовать не будет.
Важно
Чтобы промокоды правильно индексировались, в товарном фиде элемент
<promos>
должен предшествовать элементу<offers>
.
-
Элемент |
Описание |
Обязателен |
|
Блок данных о промокодах. |
Да |
promos
Элементы внутри
|
Данные о промокодах. |
Да |
promo
Элементы внутри
Атрибут |
Идентификатор промокода. Не может совпадать с идентификаторами программ лояльности и других акций. Может содержать только цифры, латинские буквы и кириллицу. Максимальная длина |
Да |
Атрибут |
Тип акции — |
Да |
|
Дата и время начала акции. Должна быть меньше даты завершения акции ( Дата и время завершения акции. Допустимые форматы:
Примеры
|
Да |
|
Ссылка на описание акции на сайте магазина. Максимальная длина ссылки — 2048 символов. Допускаются кириллические ссылки. URL-адрес формируется по стандарту RFC 3986. |
Да |
|
Текст промокода. Может содержать цифры, латинские буквы и символы "-", "—", "_". Максимальная длина — 20 символов. |
Да |
|
Размер скидки в процентах от стоимости или в валюте. Тип скидки указывается в атрибутах:
ПримерыСкидка 300 руб.
Скидка 10%
|
Да |
|
Информация о товарах, участвующих в акции. Может содержать несколько элементов |
Да |
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>
Описание
Блок данных о промокодах.
Обязателен
Да
Описание
Данные о промокодах.
Обязателен
Да
Описание
Дата и время начала акции. Должна быть меньше даты завершения акции (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
Обязателен
Да
Описание
Ссылка на описание акции на сайте магазина. Максимальная длина ссылки — 2048 символов. Допускаются кириллические ссылки. URL-адрес формируется по стандарту RFC 3986.
Обязателен
Да
Описание
Текст промокода. Может содержать только цифры и латинские буквы. Максимальная длина — 20 символов.
Обязателен
Да
Описание
Размер скидки в процентах от стоимости или в валюте. Тип скидки указывается в атрибутах:
-
unit="percent"
— скидка в процентах, доступные значения: от 5 до 95 процентов; -
unit="currency" currency="RUR"
— скидка в валюте, доступно значениеRUR
.
Примеры
Скидка 300 руб.
<discount unit="currency" currency="RUR">300</discount>
Скидка 10%
<discount unit="percent">10</discount>
Обязателен
Да
Описание
Информация о товарах, участвующих в акции. Может содержать несколько элементов product
, но не больше 1 000 000.
Обязателен
Да
Описание
Товары, на которые действует акция. Содержит обязательный атрибут offer-id
— идентификатор предложения.
Один элемент product
соответствует одному товару. Максимальное количество элементов product
— 1 000 000.
В элементе purchase
может быть несколько элементов product
.
<purchase>
<product offer-id="03"/>
<product offer-id="04"/>
</purchase>
Обязателен
Да