Оформление
Ранжирование товаров
Ранжирование ставит порядок товаров, которые сайт уже выбрал сам: каталог, выдачу поиска, подборку, блок на странице. Скрипт Sales Ninja на странице передаёт список и получает его обратно в порядке, который скорее приведёт этого посетителя к вашей цели, с баллом у каждого товара.
Раздел в кабинете: Сайт → Ранжирование товаров.
Ранжирование не добавляет и не убирает товары: оно только меняет порядок того, что прислал сайт. Ранжирует только скрипт на странице сайта — он передаёт вместе со списком и поведение посетителя.
Что можно передать
- Один список — например, все товары страницы каталога.
- Список групп — когда товары на странице разбиты на блоки: по мощности двигателя, по бренду, по наличию. Порядок меняется только внутри каждой группы, сами группы остаются на своих местах.
Элементом списка может быть что угодно: идентификатор товара, объект с данными карточки или элемент страницы. Sales Ninja нужен только идентификатор товара — id предложения из фида или артикул. Всё остальное возвращается без изменений.
Откуда берётся порядок
В редакторе ранжирования вы выбираете, что оптимизировать:
- цели — например, заявку или покупку, а также минус-цели, которые снижают оценку;
- моделируемую конверсию — предсказание Sales Ninja, когда реальных целей мало;
- воронку — тогда цели берутся из её этапов;
- метрику — число конверсий, выручку или прибыль.
Под эту цель Sales Ninja обучает модель ранжирования на истории вашего сайта. Ставя порядок, модель учитывает сразу всё, что о нём известно:
- текущую популярность товаров по вашей цели — что сейчас чаще приводит к заявкам или покупкам;
- какие товары посетители смотрят вместе — по всему сайту;
- свойства товаров — бренд, категорию, цену;
- что смотрел этот посетитель — в этом визите и раньше;
- что лежит у него в корзине;
- раздел страницы, на которой стоит список;
- устройство посетителя, пришёл ли он из рекламы и новый он или вернувшийся.
Скрипт на странице передаёт всё о посетителе сам — ничего настраивать не нужно. Сколько веса дать поведению посетителя, а сколько — популярности, модель решает по данным вашего сайта, поэтому у посетителя без истории порядок тоже осмысленный, а у того, кто уже смотрел товары, он подстраивается под его интерес.
Модель переобучается каждый день и сразу после изменения цели. До первого обучения порядок задаёт популярность товаров за последние 30 дней.
Как это срабатывает
| Посетитель | Что меняется в порядке |
|---|---|
| Зашёл впервые, с телефона, из рекламы | Наверху товары, которые сейчас чаще покупают по вашей цели — с поправкой на то, что выбирают с телефона и после рекламы |
| Смотрел кроссовки, в корзине куртка | Поднимаются кроссовки и товары, которые смотрят вместе с ними и с курткой |
| Вернулся на сайт, открыл раздел «Обувь» | Учитываются его прошлые просмотры и раздел страницы |
Посмотреть порядок для разных посетителей на своих товарах можно в редакторе ранжирования, в блоке Проверка.
Как устроен ответ
- Внутри каждой группы сначала идут товары с баллом — по убыванию балла. При равном балле сохраняется исходный порядок.
- Балл сравним только внутри одной группы одного ответа. Не сохраняйте его и не сравнивайте между посетителями.
- Товары без балла (
score: null) идут следом в исходном порядке. Это товары, о которых у модели нет данных, или те, которых Sales Ninja не нашёл в каталоге проекта: новинки, которых ещё нет в фиде, опечатки в идентификаторе. - Возвращаются все присланные элементы, включая повторы.
Как подключить
- Откройте Сайт → Ранжирование товаров и нажмите Создать.
- Укажите название и цель — что оптимизировать — и сохраните. Обучение модели начнётся сразу.
- В редакторе появятся идентификатор ранжирования и готовые примеры кода. Там же можно проверить порядок на своих товарах — для посетителя без истории или описанного вами, ничего не меняя на сайте.
- Вызовите ранжирование из JavaScript на сайте.
Ранжирование можно остановить в кабинете: сайт продолжит работать, а товары будут приходить в исходном порядке.
Как проверить
Вызовите ранжирование на странице и посмотрите поле status в ответе:
status | Что значит | Что делать |
|---|---|---|
ranked | Порядок поставлен | Ничего |
rankingNotFound | Ранжирование с таким идентификатором не найдено в проекте | Проверьте идентификатор в редакторе |
rankingStopped | Ранжирование остановлено | Включите его в кабинете |
catalogUnavailable | Каталог проекта временно недоступен | Повторите запрос позже |
experimentUnavailable | Вариант теста временно недоступен | Товары остаются в исходном порядке; повторите запрос позже |
timeout | Ответ не успел за timeout | Задайте timeout под бюджет страницы |
invalidRequest | Больше 2000 товаров или идентификатор ранжирования не в формате из редактора | Проверьте запрос |
error | Сетевая или серверная ошибка | Ничего: страница работает с исходным порядком |
Во всех случаях, кроме ranked, ответ возвращает товары в исходном порядке без баллов, и страница продолжает работать. Если ответ не успел за timeout с момента вызова, скрипт сразу возвращает исходный список без изменений со статусом timeout.
Если у всех товаров score: null, проверьте две вещи: что вы передаёте id предложения из фида или артикул, а не внутренний номер страницы, и что скрипт Sales Ninja видит на сайте просмотры карточек товаров. Как прошло обучение модели, видно в списке ранжирований — в строке ранжирования.
Статистика и A/B-тест
В сохранённом редакторе выберите запуск теста или все запуски и нажмите Статистика. Откроется общий отчёт аналитики с выбранным ранжированием; для отдельного запуска подставляются его период и цели. Период, метрики и разрезы меняются уже в отчёте.
Статистика показывает запросы, подтверждённые показы списков, клики, сессии и результат по выбранной цели. Для показов и кликов подключите методы отслеживания в JS API. Полученный порядок сам по себе не подтверждает, что посетитель увидел список.
Перед запуском теста сохраните изменения и включите ранжирование. Во время активного теста его цель изменить нельзя. При ошибке загрузки истории повторите загрузку, прежде чем запускать или останавливать тест.
Запуск теста делит посетителей поровну: исходный порядок сайта или персонализированный. Посетитель сохраняет назначение до остановки теста. Сравнение показывает разницу результата на сессию и её погрешность; при недостатке данных вывод откладывается, победитель автоматически не выбирается. Модель продолжает обновляться, поэтому тест оценивает работу персонализированного ранжирования целиком. Для изменения цели остановите тест и запустите новый; история остаётся доступной.
Ограничения
- В одном запросе — не больше 2000 товаров во всех группах вместе. Больший запрос отклоняется целиком: ранжирование не отбрасывает часть присланных товаров.
- Новый товар получает балл после того, как попадёт в каталог проекта и в следующее обучение.