Appearance
Установка блока
Код блока находится на странице блока: Витрина → Товарные рекомендации → Блоки рекомендаций → блок → Установка.
Если к блоку еще не было обращений, на его странице показывается подсказка со ссылкой на эту инструкцию.
Как установить блок на сайт
- Откройте блок и нажмите «Установка».
- Скопируйте код из поля «Код для вставки на сайт» кнопкой копирования.
- Вставьте код на страницу сайта в место, где должен появиться блок.
- Добавьте к контейнеру параметры, которые нужны алгоритмам блока: например, идентификатор товара для блока в карточке товара.
Код — пустой контейнер div с классом блока рекомендаций и атрибутами data-recommender-block="dynamic" и data-recommender-code с кодом блока. Копируйте код из ЛК целиком: класс контейнера зависит от вашей платформы.
На сайте должен быть подключен JS SDK. Он найдет контейнер, запросит товары и вставит готовый блок. Подробнее — в разделе для разработчиков Подключение рекомендаций через DIV. Получить товары блока через API можно по инструкции Запрос товарных рекомендаций.
Параметры контейнера
Параметры добавляются к контейнеру как атрибуты data-recommender-*.
| Атрибут | Обязателен | Описание |
|---|---|---|
data-recommender-block | Да | Фиксированное значение dynamic |
data-recommender-code | Да | Уникальный код блока |
data-recommender-item | Да* | Идентификатор товара, на странице которого находится блок. Обязателен для алгоритмов «Похожие товары» и «С этим товаром также покупают» |
data-recommender-exclude | Нет | Идентификаторы товаров через запятую, которые нужно исключить из рекомендаций |
data-recommender-category | Да* | Идентификатор категории для алгоритма «Популярные товары в категориях» |
data-recommender-categories | Да* | Идентификаторы категорий через запятую для алгоритма «Популярные товары в категориях» |
data-recommender-locations | Да* | Идентификатор текущей локации (города), чтобы учитывать наличие товаров в этом городе |
data-recommender-search_query | Да* | Поисковый запрос со страницы полного поиска для алгоритма «Результаты поиска» |
data-recommender-brands | Нет | Бренды через запятую: в ответе будут только товары этих брендов |
data-recommender-callback | Нет | Имя функции, в которую передается результат успешного запроса |
data-recommender-error | Нет | Имя функции, в которую передается результат неудачного запроса |
data-recommender-min | Нет | Минимальное количество товаров в ответе, при котором блок показывается |
data-recommender-collapse | Нет | Группировка товаров по group_id. По умолчанию true: из группы вариантов остается один товар |
* Нужен хотя бы один из отмеченных параметров. Какой именно — зависит от алгоритмов в правилах блока.
Параметры и фильтры
Категория или бренды, переданные в контейнере, сужают выдачу всех алгоритмов блока, как фильтр. Если блок должен показывать товары всего магазина, не передавайте эти параметры или добавьте алгоритму фильтр «Игнорировать входящие параметры».
Как проверить установку
После установки откройте страницу сайта с блоком и вернитесь в список блоков. В колонке «Статус» должно появиться время последнего запроса, а в колонке «Запросы за 30 минут» — обращения к блоку. Если блок не показывается посетителям, проверьте его статус и заполняемость.