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