OneTrace.pro Справка

Виджеты рекомендаций на сайте

Виджет — готовый блок товаров на сайте: «Вам может понравиться» на главной, «С этим покупают» в карточке товара, «Недавно просмотренные» в корзине. Вы настраиваете его в OneTrace.pro, а на сайт вставляете короткий код один раз. Дальше вид, оформление, правила показа и включение меняются без правки сайта.

Для работы нужны установленный трекер (Подключение сайта), товарный каталог и события просмотров, корзины и покупок (Рекомендации и каталог товаров). Создавать и менять виджеты могут «Владелец», «Администратор» и «Менеджер», остальные видят настройки и статистику без права сохранять.

Список виджетов

Откройте Сайт → Виджеты. В карточке каждого виджета — статус, статистика за 30 дней, сравнение вариантов, если они есть, и код для сайта.

Страница «Виджеты рекомендаций»: список виджетов со статистикой и кодом для сайта

Переключатель Показывать на сайте выключает виджет без правки сайта: статус меняется на «Выключен», блок на странице очищается. Включите снова — товары вернутся. Кнопка с корзиной удаляет виджет совсем.

Чтобы создать виджет, нажмите Создать виджет. Чтобы изменить, нажмите на название или на кнопку с карандашом. Оба действия открывают страницу редактора.

Редактор виджета

Слева — настройки в четырёх разделах: Товары, Вид, Показ и Варианты. Справа — предпросмотр: он рисует виджет так же, как на сайте, на настоящих товарах вашего каталога. Если в разделе есть ошибка, рядом с его названием появляется отметка. Нажмите Сохранить — изменения появятся на сайте при следующей загрузке страницы, код менять не нужно. Если уйти со страницы с несохранёнными изменениями, браузер предупредит.

Редактор виджета: раздел «Товары» и предпросмотр

Переключатель Компьютер / Телефон над предпросмотром показывает обе раскладки. На сайте раскладка подстраивается под ширину места, а не экрана: в узкой колонке виджет выглядит так же, как на телефоне. Шрифт и цвет текста виджет берёт у сайта, если вы не задали свои.

Товары

Поле Что задаёт
Название имя виджета; видно только в админке
Что показывать вид рекомендаций: Персональные, Популярные, Набирают популярность, С этим смотрят, С этим покупают, Похожие, Недавно просмотренные, Пора повторить
Категория для популярных и набирающих популярность: id категории каталога; пусто — весь каталог
Всего товаров от 1 до 24
Товар для предпросмотра для «С этим смотрят», «С этим покупают» и «Похожие»: id товара, для которого строится предпросмотр; пусто — первый товар в наличии

Если подходящих товаров нет, предпросмотр показывает серые заглушки, чтобы можно было оценить оформление.

Вид

Поле Что задаёт
Заголовок текст над товарами, например «Вам может понравиться»
Кнопка текст кнопки в карточке, например «Подробнее»; пусто — без кнопки
Расположение Сетка или Карусель с прокруткой
Карточек в ряд от 1 до 8
Показывать цену цена в карточке
Готовые стили «Как на сайте», «Карточки», «Минимализм», «Контраст» — заполняют поля оформления, дальше их можно менять
Что показывать в карточке бренд, старая цена, бейдж скидки, рамка и тень карточки
Пропорции картинки и Картинка 1:1, 3:4 или 4:3; картинка целиком или заполняет место с обрезкой краёв
Цвета акцент, фон карточки, фон картинки, текст, цена, кнопка и текст кнопки; без цвета — как на сайте, фон картинки — белый
Размер текста, Размер заголовка, Заголовок размеры в процентах от шрифта сайта и выравнивание заголовка
Скругление, Между карточками, Отступ внутри карточки в пикселях
Стрелки карусели кнопки прокрутки по краям карусели
Телефон карточек в ряд на узком экране (от 1 до 3) и своя раскладка, например карусель вместо сетки
Свой CSS правила для классов виджета: .cdp-rec__name, .cdp-rec__price, .cdp-rec__button и других

Свой CSS действует только внутри этого виджета и не меняет остальную страницу. В нём нельзя загружать внешние ресурсы: @import, url() и подобные конструкции отклоняются при сохранении.

Если в проекте несколько языков, над заголовком есть переключатель Язык текстов. На языке по умолчанию заполняются Заголовок и Кнопка, на остальных — их переводы; в пустом поле показан текст языка по умолчанию. Посетитель видит заголовок и кнопку на своём языке — том же, который трекер передаёт в профиль (Язык покупателя), а если перевода нет — на языке по умолчанию. Цены выводятся в формате языка посетителя.

Стиль по картинке

Кнопка Стиль по картинке в разделе Вид подбирает оформление по снимку экрана с карточками товаров — с вашего сайта или с сайта, который нравится.

  1. Нажмите Стиль по картинке.
  2. Перетащите картинку, вставьте её из буфера (Ctrl+V) или выберите файл: PNG, JPEG или WebP до 3 МБ.
  3. Если у виджета есть варианты, выберите, к какому применить стиль.
  4. Нажмите Подобрать стиль.

ИИ заполнит цвета, размеры, скругления, раскладку и что показывать в карточке, а то, чего нет в настройках, допишет в Свой CSS. Каждое значение проверяется так же, как при ручном вводе, неподходящие отбрасываются. Результат — черновик: посмотрите предпросмотр и сохраните или нажмите Вернуть как было.

Стиль по снимку экрана

Картинка не сохраняется. Подбор оплачивается с баланса проекта по фактическому расходу; если баланса не хватает или ИИ не входит в тариф, кнопка недоступна, а под ней написана причина.

Показ

Раздел «Показ»: правила, включение и код для сайта

Поле Что задаёт
Показывать на сайте включение виджета, как в списке
Только на страницах и Кроме страниц адреса страниц без домена, по одному в строке; * — любые символы, например /catalog/*. Пусто — на всех страницах
Устройства все, только компьютеры или только телефоны
Посетители все, только новые или только вернувшиеся
Только участникам сегментов и Кроме участников сегментов сегменты посетителя; участие проверяется по профилю при каждом показе

Правила проверяет сервер при каждой загрузке виджета. Вне правил место на странице остаётся пустым, и вёрстка не ломается. Правила те же, что у форм подписки.

Здесь же — Код для сайта, о нём ниже.

Варианты

Варианты нужны, чтобы проверить, какой заголовок, вид рекомендаций или оформление приносят больше кликов и покупок. Основные настройки виджета — вариант A. Нажмите Добавить вариант — можно добавить до трёх вариантов: B, C и D. В каждом можно поменять:

  • вид рекомендаций — Что показывать;
  • Заголовок и Кнопку с переводами;
  • раскладку и всё оформление.

Пустые поля берутся у варианта A.

Раздел «Варианты»: вариант B с другим заголовком и оформлением

Посетители делятся между вариантами поровну, и каждый посетитель всегда видит один и тот же вариант. Переключатель над предпросмотром показывает выбранный вариант. Результаты сравнения — в статистике под редактором.

Посмотреть на своём сайте

Кнопка Посмотреть на своём сайте над предпросмотром открывает страницу вашего сайта с виджетом в сохранённом виде. Укажите адрес страницы, где стоит код виджета, выберите вариант и нажмите Открыть.

Так виджет виден, даже если он выключен или страница не подходит под правила показа. Показы и клики в таком режиме в статистику не попадают. Ссылка действует сутки; пока вкладка открыта, режим просмотра сохраняется и при переходах по страницам сайта. Несохранённые изменения на сайте не видны — сначала сохраните.

Код для сайта

Код виджета есть в его карточке в списке и в разделе Показ редактора. Вставьте его в шаблон страницы там, где должен быть блок:

<div data-cdp-widget="a1b2c3d4e5f6" data-item="SKU-1"></div>

Атрибуты:

  • data-item — id товара страницы или товаров корзины через запятую: data-item="SKU-1,SKU-7". Обязателен для видов «С этим смотрят», «С этим покупают» и «Похожие» — подставьте его из шаблона страницы.
  • data-category — id категории для популярных товаров, если на разных страницах нужны разные категории.
  • data-exclude — id товаров через запятую, которые не нужно показывать, например уже лежащие в корзине.

Персональные и недавно просмотренные товары подбираются по посетителю, им data-item не нужен.

Если подходящих товаров нет, место на странице остаётся пустым — вёрстка не ломается.

Статистика

Под редактором — статистика виджета за 7, 30 или 90 дней: итоги, график по дням и сравнение вариантов. Над графиком выберите показатель: показы, клики, CTR или выручку. Если у виджета есть варианты, на графике у каждого своя линия.

Статистика виджета: итоги, график по дням и сравнение вариантов

Показатель Как считается
Показы виджет попал в поле зрения посетителя хотя бы наполовину. Загрузка страницы без прокрутки до блока не считается, поэтому CTR виджета внизу страницы честный
Клики переходы по карточкам товаров
CTR клики, делённые на показы
Покупки покупки товара тем же покупателем в течение 7 дней после клика по нему; на графике — в день первого клика
Выручка сумма этих покупок

Дни считаются по UTC. Показы и клики при просмотре на своём сайте не учитываются.

В таблице вариантов — показы, клики, CTR, покупки и выручка каждого варианта. Под ней — вывод по кликам и по покупкам на показ: какой вариант лучше и достаточно ли уже данных, чтобы на него полагаться. Пока данных мало, вывод так и говорит — подождите, а не выбирайте вариант по случайной разнице.

Общий эффект рекомендаций на сайте по видам — в разделе Рекомендации.

Одностраничные сайты

Трекер сам находит виджеты после загрузки страницы, при появлении новых элементов и при смене data-item. Поэтому на сайтах на React, Vue и подобных достаточно менять атрибут — блок перерисуется.

Если товары нужно обновить без изменения атрибутов, например после изменения корзины, вызовите:

cdp.widgets({ force: true });

Свой код вместо виджета

Разработчики могут вывести блок рекомендаций из кода, без настройки в админке:

window.addEventListener('load', () => {
  cdp.renderRecommendations('#recs', {
    type: 'viewed_with', item: 'SKU-1', title: 'С этим смотрят', layout: 'carousel', columns: 4,
  });
});

Блок выглядит так же, как виджет, показы и клики учитываются сами. Вызов можно делать и до загрузки трекера: он подождёт в очереди. Элемент должен уже быть на странице, поэтому в примере вызов ждёт события load. Пустая выдача очищает элемент. Оформление задаётся теми же параметрами, что у виджетов из админки, например imageRatio: '4:3', imageFit: 'cover', imageBackground: 'transparent', background: '#111827', textColor: '#f9fafb'; imageBackground — цвет или transparent. Правила показа и варианты доступны только у виджетов из админки.