Skip to content

Установка блока ​

Код блока находится на странице блока: Витрина → Товарные рекомендации → Блоки рекомендаций → блок → Установка.

Если к блоку еще не было обращений, на его странице показывается подсказка со ссылкой на эту инструкцию.

Как установить блок на сайт ​

  1. Откройте блок и нажмите «Установка».
  2. Скопируйте код из поля «Код для вставки на сайт» кнопкой копирования.
  3. Вставьте код на страницу сайта в место, где должен появиться блок.
  4. Добавьте к контейнеру параметры, которые нужны алгоритмам блока: например, идентификатор товара для блока в карточке товара.

Код — пустой контейнер 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 минут» — обращения к блоку. Если блок не показывается посетителям, проверьте его статус и заполняемость.