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