Оформление
Товарные рекомендации
Товарные рекомендации помогают интернет-магазину подобрать товары под текущую задачу посетителя и показать их в нужном месте сайта. Например, предложить аксессуары в карточке товара, альтернативы отсутствующей позиции или дополнения к корзине.
Раздел в кабинете: Сайт → Товарные рекомендации.
Коротко
Продукт состоит из трёх независимых частей: товарная рекомендация выбирает товары, отображение задаёт дизайн карточек, а размещение определяет место, сценарий и аудиторию показа.
Эта документация описывает возможности, доступные в личном кабинете. Конструктор отображения позволяет вручную собрать адаптивный дизайн. Автоматическое обучение или выбор лучшего дизайна в текущую версию продукта не входят.
Какие задачи решает продукт
| Задача | Типичная страница | Подходящий сценарий |
|---|---|---|
| Предложить совместимые товары | Карточка товара | Дополнение к товару |
| Дать альтернативы | Карточка товара | Похожие товары |
| Увеличить состав заказа | Корзина или оформление заказа | Дополнение корзины |
| Продолжить интерес посетителя | Главная, каталог, личный кабинет | Интересы пользователя |
| Вернуть просмотренные посетителем товары | Любая подходящая страница | Тип рекомендации «Просмотренные товары» |
| Заполнить блок без истории посетителя | Главная или каталог | Холодный старт |
| Собрать универсальную подборку | Любая подходящая страница | Общие рекомендации |
Сценарий не привязан навсегда к модели. Одну товарную рекомендацию можно использовать в нескольких размещениях: например, в карточке товара и в корзине, но с разными сценариями, фильтрами и текстами.
Три части продукта
Товарная рекомендация — какие товары выбрать
Объединяет каталог и бизнес-сигнал, на которых обучается модель подбора. Модель определяет состав и порядок товаров. Дизайн блока и место на странице в неё не входят.
Для настройки рекомендации выберите:
- исходный товарный фид из раздела Смарт фиды;
- метрику оптимизации: количество конверсий, выручку или чистую прибыль;
- полезные цели и, при необходимости, минус-цели;
- при необходимости — моделируемую конверсию, связанную с той же бизнес-задачей.
Выбранные цели задают конечный результат и не подменяются кликами, просмотрами, корзинами или покупкой из товарной разметки. Эти события помогают связать результат с товарами, только когда такая связь подтверждается данными. Если выбранных целей или моделируемой конверсии пока недостаточно для подготовки сигнала, система автоматически использует общий прогноз проекта; отдельно настраивать его не нужно.
Отображение — как выглядит блок
Переиспользуемый дизайн: сетка, список или карусель, карточки, цвета и экраны. Одно отображение можно подключить к нескольким размещениям. Заголовок блока и текст кнопки остаются настройками конкретного размещения.
Размещение — где и когда показать
Соединяет модель, дизайн и страницу сайта: сценарий, условия, фильтр, тексты и способ доставки. Только работающее и полностью настроенное размещение участвует в показе.
Sales Ninja либо вставляет готовый блок на страницу, либо передаёт товары в JavaScript-подписку, а сайт рисует витрину сам.
Как проходит запрос
- Скрипт Sales Ninja проверяет, подходят ли текущая страница и посетитель под условия размещения.
- Размещение выбирает сценарий и запрашивает товары у связанных рекомендаций.
- Рекомендация ранжирует доступные товары из своего источника.
- Фильтр размещения исключает товары, которые нельзя показывать в этом месте.
- Sales Ninja либо вставляет готовый блок, либо передаёт данные обработчику JavaScript.
- При переходе внутри SPA условия проверяются снова; старый блок очищается, если размещение больше не подходит.
Если после фильтрации не осталось товаров, пустой блок не показывается.
Как обучается подбор товаров
Обучается именно модель подбора, а не внешний вид блока.
- Источник задаёт доступный каталог.
- Цели оптимизации и метрика определяют конечный результат, который выбрал пользователь.
- Выбранная моделируемая конверсия может дополнить цели или быть самостоятельным целевым сигналом.
- Если более прямого сигнала пока нет, система автоматически опирается на общий прогноз проекта.
- Товарные взаимодействия помогают отнести результат к товарам, но сами не становятся конечной целью.
- После успешного обучения рабочая версия модели начинает ранжировать товары.
- При изменении значимых настроек новая версия готовится отдельно; существующая рабочая версия продолжает обслуживать сайт до успешной замены.
На карточке рекомендации виден текущий этап: обучение, недостаточно данных, необходимость переобучения или ошибка последнего запуска. Для новой рекомендации в статусе Работает первое обучение запускается после сохранения. Черновую рекомендацию можно оставить остановленной и запустить позже из карточки.
Как выбирается сценарий
В размещении доступны два режима:
- Сценарий выбираю я — рекомендации опрашиваются в заданном порядке, а размещение использует выбранный сценарий;
- Сценарий выбирает система — система выбирает подходящий доступный сценарий по контексту, а выбранный вручную сценарий служит резервным.
Доступность конкретной подборки всё равно зависит от каталога, накопленных сигналов и контекста страницы. Например, для дополнений к карточке нужен текущий товар, а для интересов пользователя — история его действий.
Два способа доставки
Готовый блок Sales Ninja
Sales Ninja формирует карточки по выбранному отображению и вставляет блок по CSS-селектору. Этот режим подходит, когда блок нужно запустить без разработки собственного компонента. Он поддерживает предпросмотр и адаптивный дизайн из конструктора.
Данные через JavaScript
Sales Ninja передаёт товары, состояние, сценарий, идентификатор размещения и настройки отображения, а сайт сам рисует интерфейс. Режим подходит для SPA и витрин с собственным дизайн-системным компонентом. DOM-вставка не применяется; витрина сама решает, как использовать переданные настройки внешнего вида.
Подробнее о подключении обработчика — в пошаговой инструкции и разделе JavaScript API.
Что нужно до запуска
- На сайте установлен скрипт Sales Ninja.
- В проекте есть актуальный товарный фид в разделе Смарт фиды.
- Сайт передаёт товарные взаимодействия и бизнес-конверсии.
- Настроены цели оптимизации либо выбрана подходящая моделируемая конверсия. Если ни один сигнал не выбран, система попробует использовать общий прогноз проекта.
- Команда знает страницу, аудиторию и бизнес-задачу будущего блока.
Качество модели зависит от полноты каталога и сигналов. Предпросмотр отображения проверяет только дизайн: он не повторяет персональную выдачу конкретного посетителя.
Как начать
- Пройдите короткий путь запуска.
- Настройте рекомендацию, отображение и размещение.
- Возьмите готовую сборку из примеров.
- Если витрину рисует сайт, откройте JavaScript API.