# Товарные рекомендации

Есть несколько способов подключения товарных рекомендаций

# Самый простой способ

Самый простой способ установить блок рекомендаций: установить в нужном месте страницы 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 Строка нет Рекомендовать товары только указанных брендов: список брендов через запятую.