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

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

1. Сформируйте XML-файл. Он должен содержать следующие параметры:

   Название	Обязательно	Описание	Примечание
   promo_id	Да	Идентификатор промокода. Определяет: к каким предложениям в фиде относится промокод; какой группе пользователей он доступен. Например, для одной группы пользователей доступна скидка 10% — для нее назначается один идентификатор. Для другой группы скидка составляет 15% — назначается другой идентификатор.	Одному пользователю может быть доступно 20 промокодов. Один товар может продаваться только по одному промокоду.
   promo_code	Да	Текст промокода.	Максимальная длина — 20 символов.
   discount	Да	Сумма скидки по промокоду, в процентах или валюте.	В соответствии с общими условиями скидка должна составлять не меньше 5% от стоимости товара (в процентах или валюте) или не меньше 500 руб. unit="percent" — скидка в процентах. Доступные значения: от 5 до 95. unit="currency"currency="RUR" — скидка в валюте. Доступные значения: кратные 50.
   date_from	Нет	Дата начала действия вашей программы лояльности.	Например, 05.03.2023.
   date_to	Нет	Дата окончания действия вашей программы лояльности.	Например, 28.04.2023.
   offer_id	Да	Идентификатор предложения, для которого действует промокод. Должен быть включен в фид.	—
   feed_url	Да	URL-адрес фида, который содержит указанное в offer_id предложение.	—
   email_hash	Нет	Адрес электронной почты пользователя.	Перед отправкой данных используйте хеширование. Информация нужна для определения группы пользователей, которым промокод может быть показан.
   phone_hash	Нет	Номер телефона пользователя.
   price	Нет	Персональная цена товара (например, для пользователей, которые еще не покупали в вашем магазине).	Основная часть данных обновляется в поиске по товарам раз в 4 часа. Чтобы быстро обновить цену, используйте API поиска по товарам.
   oldprice	Нет	Цена до скидки.	Цена указывается в рублях. Число должно быть целым. В соответствии с общими условиями можно указать цену со скидкой от 5 до 75% или не меньше 500 руб.

   Название	Обязательно	Описание	Примечание
   promo_id	Да	Идентификатор промокода. Определяет: к каким предложениям в фиде относится промокод; какой группе пользователей он доступен. Например, для одной группы пользователей доступна скидка 10% — для нее назначается один идентификатор. Для другой группы скидка составляет 15% — назначается другой идентификатор.	Одному пользователю может быть доступно 20 промокодов. Один товар может продаваться только по одному промокоду.
   promo_code	Да	Текст промокода.	Максимальная длина — 20 символов.
   discount	Да	Сумма скидки по промокоду, в процентах или валюте.	В соответствии с общими условиями скидка должна составлять не меньше 5% от стоимости товара (в процентах или валюте) или не меньше 500 руб. unit="percent" — скидка в процентах. Доступные значения: от 5 до 95. unit="currency"currency="RUR" — скидка в валюте. Доступные значения: кратные 50.
   date_from	Нет	Дата начала действия вашей программы лояльности.	Например, 05.03.2023.
   date_to	Нет	Дата окончания действия вашей программы лояльности.	Например, 28.04.2023.
   offer_id	Да	Идентификатор предложения, для которого действует промокод. Должен быть включен в фид.	—
   feed_url	Да	URL-адрес фида, который содержит указанное в offer_id предложение.	—
   email_hash	Нет	Адрес электронной почты пользователя.	Перед отправкой данных используйте хеширование. Информация нужна для определения группы пользователей, которым промокод может быть показан.
   phone_hash	Нет	Номер телефона пользователя.
   price	Нет	Персональная цена товара (например, для пользователей, которые еще не покупали в вашем магазине).	Основная часть данных обновляется в поиске по товарам раз в 4 часа. Чтобы быстро обновить цену, используйте API поиска по товарам.
   oldprice	Нет	Цена до скидки.	Цена указывается в рублях. Число должно быть целым. В соответствии с общими условиями можно указать цену со скидкой от 5 до 75% или не меньше 500 руб.

   Пример файла

   <?xml version="1.0" ?>
   <promo_info>
      <promos>
         <promo>
            <promo_id>promo_10</promo_id>
            <promo_code>SuperFreeze</promo_code>
            <date_from>28.03.2023</date_from>
            <date_to>08.04.2023</date_to>
         </promo>
      </promos>
      <offers>
         <offer>
            <promo_id>promo_10</promo_id>
            <offer_id>4013125</offer_id>
            <feed_url>https://example.com/affiliates_unloads/products.xml</feed_url>
         </offer>
         <offer>
            <promo_id>promo_10</promo_id>
            <offer_id>4013126</offer_id>
            <feed_url>https://example.com/affiliates_unloads/products.xml</feed_url>
         </offer>
      </offers>
      <users>
         <user>
            <email_hash>78ee6d68f49d2c90397d9ff77fc3814d1</email_hash>
            <phone_hash>a31259d185ad013e0a663437c605d056</phone_hash>
            <promo_ids>
               <promo_id>promo_10</promo_id>
            </promo_ids>
         </user>
         <user>
            <email_hash>f5ge43thaeb67df89875777e71bccf88i</email_hash>
            <phone_hash>a31259d185ad013e0a663437c605d056</phone_hash>
            <promo_ids>
               <promo_id>promo_10</promo_id>
            </promo_ids>
         </user>
      </users>
   </promo_info>

2. Разместите файл на сайте вашего магазина и настройте обновление файла не реже раза в сутки. Убедитесь, что ссылка доступна для робота Яндекса, с помощью инструмента Вебмастера Проверка ответа сервера.

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

1. Заполните заявку — укажите:

   • адрес вашего интернет-магазина или маркетплейса, например https://example.com;
   • для каких пользователей доступен промокод;
   • краткое описание программы лояльности (название программы, на какие товары распространяется и пр.).
2. Добавьте фавиконку вашего интернет-магазина или маркетплейса. Она будет отображаться в карточке товара.

   Требования к фавиконке

   Размер: 120 × 120, 32 × 32 или 16 × 16 пикселей.

   Формат: SVG (рекомендуемый), ICO, GIF, JPEG, PNG, BMP. Анимация не поддерживается.

3. Добавьте ссылку на сформированный в Шаге 1 XML-файл.

Как поиск по товарам использует данные о пользователях

Промокоды могут отображаться для всех пользователей поиска по товарам или для отдельной группы пользователей: например, для тех, кто уже посещал интернет-магазин или маркетплейс.

Хеширование данных о пользователях

При подготовке данных используйте хеширование по алгоритму md5. При этом каждая запись должна быть захеширована отдельно.

Перед хешированием нужно нормализовать данные:

Пример записей с захешированными значениями:

phone_hash,emails_hash
a31259d185ad013e0a663437c605d056,78ee6d68f49d2c90397d9ff77fc3814d1
702e8494aeb560dff987eh623e71ccf8,f5ge43thaeb67df89875777e71bccf88i