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