# Товарные рекомендации
Есть несколько способов подключения товарных рекомендаций
# Самый простой способ
Самый простой способ установить блок рекомендаций: установить в нужном месте страницы DIV
блок. JS SDK автоматически найдет все блоки на странице, сделает запросы к API и отобразит их.
<div class="rees46-recommend" data-recommender-block="dynamic" data-recommender-code="977cb67194a72fdc7b424f49d69a862d" data-recommender-item="822">
Изменить внешний вид блока можно в личном кабинете.
# Простой способ с собственным оформлением
То же самое, что и выше, но добавьте
в блок параметр data-recommender-callback="имя_JS_функции"
чтобы
указать, какую функцию использовать для обработки и отображения результатов запроса товарных
рекомендаций. В этой функции вы сможете использовать собственный шаблон отображения,
добавить карусель/слайдер и так далее.
# Использование метода JS SDK
Если вам по какой-то причине не подходит вариант с установкой блоков в HTML-шаблон, вы можете воспользоваться JS SDK для прямых запросов к API (opens new window).
# Параметры DIV-блока
Не забудьте установить необходимые параметры блока рекомендаций. Некоторым алгоритмам требуются на вход идентификатор категории, товара, содержимое корзины или поисковый запрос.
Параметры, управляющие поведением блока рекомендаций, начинаются с data-recommender-
и выглядят так:
<div class="rees46-recommend"
data-recommender-block="dynamic"
data-recommender-min="10"
data-recommender-code="RECOMMENDER_CODE"
></div>
Параметр | Тип значения | Базовое значение | Описание |
---|---|---|---|
block | Строка | dynamic | |
min | Число | нет | Минимальное количество товаров в ответе, при которых блок отрисовывается. Если товаров вернулось меньше, блок скрывается. |
code | Строка | нет | Идентификатор блока товарных рекомендаций. |
item | Строка | нет | Идентификатор текущего товара, если пользователь находится на карточке товара. Обязателен для блока с алгоримами "Похожие" и "С этим также покупают". |
exclude | Строка | нет | Список идентификаторов товаров через запятую, которые обязательно нужно исключить из рекомендаций. |
search_query | Строка | нет | Текущий поисковый запрос. Используется в блоке на странице с результатами поиска. |
callback | Строка | нет | Имя JS-фукции, куда будут переданы результаты запроса к API, если требуется собственный обработчик товарных рекомендаций. |
error | Строка | нет | Имя JS-фукции, куда будет передано управление, если запрос товарный рекомендаций завершился ошибкой. |
category | Строка | нет | Рекомендовать товары только из указанной категории. |
categories | Строка | нет | Рекомендовать товары только из указанных категорий: список идентификаторов категорий через запятую. |
for_user | Строка | нет | ... |
brands | Строка | нет | Рекомендовать товары только указанных брендов: список брендов через запятую. |