Сервис рекомендаций

Алгоритмы сервиса

Cross-sale

Рекомендации формируются на основе истории посещений и действий пользователей сайта.

Учитываются просмотры, добавления в корзину и покупки.

✉ Алгоритм доступен к использованию в письмах.

Cart-upsale

Рекомендации формируются за счёт товаров, которые находятся в корзине.

Проверяется история корзинного соседства этих товаров с другими и рекомендуются последние.

✉ Алгоритм доступен к использованию в письмах.

Offer-upsale

Рекомендации работают в том же ключе, что и Cart-upsale рекомендации.

Только в данном случае проверяется корзинное соседство просматриваемого в данный момент товара.

Поисковые рекомендации формируются с учетом последнего поискового запроса пользователя сайта.

Например, человек в поисковом поле ввёл слово "футболка". В этом случае в качестве рекомендованных товаров будут появляться товары со словом "футболка" в названии или в описании.

В алгоритме также учитываются простые орфографические ошибки.
Например, при поиске слова "фтболка" сервис вернёт рекомендации по слову "футболка".

Top-offers

Рекомендуются самые покупаемые товары за последние 14 дней на основе добавлений в корзину и заказов с этими товарами (если подключен код заказ с товарами). Просмотры товаров не учитываются.

У этого алгоритма есть опция "интервал", который позволяет указать за какой период нужны рекомендации самых покупаемых товаров.

Интервал по умолчанию - 14 дней

✉ Алгоритм доступен к использованию в письмах.

Buying-now

Покупают сейчас

Рекомендуются купленные товары за последние 2 часа.

✉ Алгоритм доступен к использованию в письмах.

Similar-offers

Похожие товары

Рекомендации формируются на основе схожести по категории и цене (+- 20%).

Last Viewed

Последние просмотренные товары

Рекомендуются товары, которые пользователь просматривал последними.

Опционально можно исключить товары, которые пользователь уже купил.

Спецификация получения рекомендаций по RSAPI

Для того, чтобы получить рекомендации необходимо сделать HTTP запрос (GET или POST) по следующему адресу https://rs.leadhit.io/get, передав необходимые параметры.

Пример запроса:

https://rs.leadhit.io/get?clid=123abc&lead_uid=456def&service_name=top_offers
Список возможных параметров:
Алгоритмы и используемые в них параметры:
Параметр \ Алгоритм cross_sale top_offers offer_upsale cart_upsale similar_offers buying_now search
clid v v v v v v v
lead_uid v v v v v v
service_name v v v v v v v
source v v v v v
offer_url v
url_list[] v v v v v
search_query v
lead_history_days_count v
category_id v
stock_id v v v v
limit v
extra_fields_filter v
Формат ответа:

Рекомендации отдаются в JSON формате, и представляют из себя список объектов следующего вида:

{
    "available": true, 
    "category_id": "20102", 
    "cities": [], 
    "description": "Air Jordan Legacy 312 – Гибридная модель, использующая элементы Air Jordan 1, Air Jordan 3 и Alpha Force Low.", 
    "extra_fields": {}, 
    "model": "Air Jordan", 
    "name": "Кроссовки Nike Air Jordan Legacy 312 Low", 
    "offer_id": "2145678", 
    "oldprice": "15000", 
    "picture": "https://media.leadhit.io/upload/_/noimage.png", 
    "picture_orig": "https://www.site.ru/product/123456/image.png", 
    "price": "12500", 
    "rating": 1.0, 
    "stock_fields": [], 
    "url": "https://www.site.ru/product/123456/", 
    "url_hash": "4c13e8d0f4b0", 
    "vendor": "Nike"
}

Аналитика по рекомендациям

Аналитика задействует статистику по виджетам рекомендаций. Для отдельного блока товарных рекомендаций, который вы используете на сайте, мы создаем виджет. Для формирования статистики, необходимо отправить запрос с событием с помощью JS функции Leadhit.sendWidgetStats, используя идентификатор виджета в качестве одного из параметров.

Вам необходимо согласовать с менеджером, какие алгоритмы сервиса рекомендаций мы хотите использовать и где разместить, чтобы мы запустили эти алгоритмы и создали к ним виджеты для сбора статистики. После этого менеджер сообщит вам идентификаторы виджетов, которые нужно использовать для отправки событий.

Как отправить событие

Показ (view) — это событие нужно отправить после загрузки блока с рекомендациями:

Leadhit.sendWidgetStats('123', 'view');

где 123 — идентификатор виджета, view — тип события.

Клик (click) — это событие нужно отправить после клика на товар из блока рекомендаций:

Leadhit.sendWidgetStats('123', 'click', {'offer_url': 'https://www.site.ru/product/123456/?lhsource=recommendations'});

где 123 — идентификатор виджета, click — тип события, https://www.site.ru/product/123456/ — URL товара, lhsource=recommendations — сервисный get-параметр для подсчета атрибуции заказов.

Атрибуция заказов

Для того, чтобы товарные рекомендации учитывались в атрибуции заказов, необходимо добавить в URL товаров параметр lhsource=recommendations, например https://www.site.ru/product/123456/?lhsource=recommendations.