Виджеты рекомендаций
Для обработки сервисом SearchBooster товаров необходимо завести проект в нашей админ-панели и передавать каталог магазина в формате Yandex Market Language - подробнее.
Для работы всех виджетов рекомендаций SearchBooster необходимо собирать события (действия пользователя на сайте).
API - интеграция
Такая интеграция понадобится в случаях, когда у клиента есть нужда только в нашем сервисе выдачи товаров без наших виджетов. Такое может произойти, когда у пользователя уже имеется собственное решение для показа товаров.
Шаги для api - интеграции
- Посетить раздел виджетов персонализации в админ - панели https://admin.searchbooster.io
- Создать любой виджет с подходящим вам типом (Персональный, Популярные товары и т.д.)
- Получить ID виджета в списке созданных виджетов
- Обратиться по ссылке методом GET https://api4.searchbooster.io/api/{projectId}/widgets/{widgetId}?{userId}&{categoryId}&{segmentId}&{recentId}&{id}
Параметр запроса | Значение |
---|---|
userId | ID пользователя. Нужен для работы персональных рекомендаций и недавно просмотренных товаров. Хранится в куки сайта под ключом searchbooster_v2_user_id |
projectId | ID проекта. В админ - панели https://admin.searchbooster.io |
categoryId | ID категории товара из фида. Нужен для учёта категории при выдаче товаров. Необязательный |
segmentId | ID формулы релевантности. Определяет поведение выдачи товаров. Находится в расширенных настройках проекта. Необязательный |
widgetId | ID виджета. Находится во вкладке виджетов рекомендаций. |
id | ID товара из фида. Добавляется программно на сайте. Нужен для работы товаров похожих по описанию или по фото |
Сбор событий
Виджет по сбору событий может быть установлен при помощи размещения соответствующего проекту JS-кода на сайт.
События могут быть переданы SearchBooster при помощи API - подробнее.
Мы обрабатываем следующий набор событий (параметр feedback
):
-
catalog_long_view - просмотр товара в каталоге дольше N секунд
-
page_view - просмотр страницы товара
-
long_pageview - просмотр страницы товара дольше N секунд
-
add_to_cart - добавление товара в корзину
При использовании виджета для удобства интеграции событие добавления товара в корзину может быть обработано в формате:
SearchBoosterTracker.sendEvent('add_to_cart',["1234", "4321"])
где 1234, 4321 - айди товаров, добавляемых в корзину.
При использовании API для более эффективной работы виджетов мы рекомендуем передавать информацию о пользователе в формате тегов в параметре user_label
— это могут быть выделенные внутренние сегменты, информация об операционной системе, используемой пользователем и другая информация, которую вы сочтете важной.
Виджет "Рекомендации"
Для эффективной работы механизма рекомендаций необходимо определенное количество собранных событий
Мы можем предоставлять персональные рекомендации для пользователя, рекомендовать товары только из определенной категории, выводить популярные товары в магазине с учетом характеристик пользователя и категории и без.
Виджет "Рекомендации" может быть установлен при помощи размещения соответствующего проекту JS-кода на сайт.
Рекомендации могут быть получены при помощи API - подробнее.
Рекомендации рассчитываются исходя из действий данного пользователя за последнее время - мы аккумулируем "сессию" (session) пользователя, состоящую из событий, описанных в предыдущем пункте, и на основе данной "сессии" рассчитываем персональные рекомендации.
Подобного сценария взаимодействия необходимо придерживаться и при использовании API; для получения популярных товаров "сессию" пользователя запоминать не нужно.
Виджет "Похожие товары"
Виджет "Похожие товары" может быть установлен при помощи размещения соответствующего проекту JS-кода на сайт.
Похожие товары могут быть получены при помощи API - подробнее. Метод similar
.
Мы можем предоставлять похожие товары в двух режимах - похожие по описанию (сравнение всей передаваемой текстовой информации о товарах) type = 0
и похожие по изображению (сравнение изображений, относящихся к товарам на основе машинного обучения) type = 1
.
Для работы виджета в режиме "похожие по изображению" необходимо активировать индексацию изображений из переданного каталога.
Похожие на данный товары могут быть из той же категории, только в наличии, а также может быть ограничена разница в цене - данные настройки можно комбинировать для получения желаемого результата.
Виджет "Недавно просмотренные"
Виджет "Недавно просмотренные" может быть установлен при помощи размещения соответствующего проекту JS-кода на сайт.
В рамках данного виджета мы запоминаем товары, просмотренные пользователям, и отображаем информацию о них на сайте.