Типы рекомендаций

Рекомендации — товарные блоки на главной, в карточке, в корзине и на странице «ничего не найдено». Каждый блок — это виджет, созданный в личном кабинете: у него есть тип (алгоритм), настройки (фильтры, лимиты, правила) и ID. Показывать виджет можно двумя способами — готовым HTML-блоком <sb-widget> или через API, отрисовывая товары самостоятельно.

Главная

Персональныеpersonal

Популярныеpopular

Вы смотрелиrecently

Карточка товара

В корзину

Похожие по фотоsimilar-by-photo

С этим покупаютcross-sale

Похожие по описаниюsimilar-by-text

Корзина

Оформить

Дополните заказcross-sale

Со скидкойdiscount

Где обычно ставят блоки рекомендаций. Подпись под заголовком — тип виджета в личном кабинете.

Типы

Тип	Что показывает	На каких данных	Нужно передать
Персональные personal	Подборка под интересы посетителя	История просмотров, корзин и покупок; поведение похожих пользователей	userId
Персональные популярные personal-popular	Популярные товары с учётом интересов	Популярность + история	userId
Популярные popular	Хиты магазина или категории	Покупки, корзины, просмотры	— (опционально categoryId)
Со скидкой discount	Товары с oldprice > price	Фид + популярность	—
Недавно просмотренные recently	Что посетитель смотрел	События view_item	userId
Похожие по фото similar-by-photo	Визуально похожие на текущий товар	Векторы картинок	id товара
Похожие по описанию similar-by-text	Аналоги по названию и описанию	Текст фида, совместные просмотры	id товара
С этим покупают (персональный виджет + корзина)	Сопутствующие товары	Совместные покупки, таблица кросс-сейла, категории-компаньоны	crossSaleIds — товары в корзине
Пустой empty	Ручная подборка по фильтрам и сортировке	Фид	—

Попробуйте

У каждого проекта есть встроенные виджеты для предпросмотра — их можно вызвать, даже не создавая свои. Переключайте тип:

GET/api/{uuid}/widgets/{widgetId}

uuid проектДемо-проект SearchBooster. Подставьте UUID своего проекта из личного кабинета.idТовар на странице (для похожих)userIdlimit

cURLJavaScriptPHPPythonКопировать

Отправить запрос⌘↵

Как улучшается качество

• Трекер — главный источник данных. Без событий view_item, add_to_cart, purchase персональные блоки работают как «популярные», а «С этим покупают» — по категориям. Установите трекер с первого дня — данные начнут копиться сразу.
• Один userId везде. Тот же ID посетителя в событиях, поиске и рекомендациях — иначе история не свяжется.
• Добивка. Если алгоритму не хватило товаров (новый посетитель, редкий товар), блок добивается популярными из категории, а затем из всего каталога — пустых блоков не бывает.
• Бизнес-правила — исключить категории, закрепить товары, ограничить цену: Бизнес-правила.
• A/B-тесты виджетов настраиваются в личном кабинете; код на сайте менять не нужно.

Виджеты на сайтеГотовые блоки — без программирования

API рекомендацийСвоя вёрстка, мобильные приложения, SSR