Рекомендации и каталог товаров

OneTrace.ru подбирает товары каждому покупателю: популярное, «с этим покупают», похожие, недавно просмотренные и персональную подборку. Рекомендации показываются на сайте, в письмах, цепочках и рассылках. Для работы нужны товарный каталог и события просмотров, корзины и покупок.

Раздел открывается в меню Коммуникации → Рекомендации. Смотреть его могут все участники проекта, а подключать фиды, менять настройки и запускать пересчёт — «Владелец», «Администратор» и «Менеджер».

Каталог товаров

Вверху страницы видно, сколько товаров в каталоге, сколько из них в наличии и сколько категорий. Пока каталог пуст, рекомендовать нечего: подключите фид или загрузите товары через API.

Как подключить фид

1. В блоке Товарные фиды нажмите Добавить фид.
2. Укажите Название и Адрес фида — ссылку на файл.
3. Выберите Формат: YML (Яндекс), Google Merchant, CSV, JSON или JSON Lines.
4. В поле Обновление выберите, как часто перечитывать фид: каждые 1, 3, 6 или 12 часов либо раз в сутки.
5. Если фид закрыт паролем или токеном, заполните Заголовок Authorization, например Bearer …. Он хранится зашифрованным.
6. Нажмите Сохранить. Первый импорт начнётся сразу.

В CSV и JSON колонки узнаются по названиям: id, name или title, url, image, price, old_price, currency, available, category, brand (подходят и русские названия: «название», «цена», «бренд»). Остальные колонки считаются характеристиками товара. id товара должен совпадать с тем, что сайт передаёт в событиях — иначе действия покупателей не свяжутся с каталогом.

У каждого фида видны статус (Работает или Ошибка), время последнего импорта и итог: сколько товаров и категорий прочитано и сколько снято с продажи. Кнопка Обновить запускает импорт вне расписания. Кнопка Пауза останавливает импорт по расписанию (статус «На паузе»), Обновить снимает паузу. Фид с ошибкой повторяется по расписанию, текст ошибки показан под ним.

Что важно знать:

• Товары, которых больше нет в фиде, снимаются с продажи, а не удаляются: история событий по ним сохраняется, а вернувшийся в фид товар снова становится доступен.
• При удалении фида товары остаются в каталоге.

Копии изображений

В настройках фида можно включить Копировать изображения товаров в наше хранилище. Тогда картинки в письмах и виджетах открываются с CDN OneTrace.ru и не зависят от доступности вашего сайта.

• Скачивать не больше … изображений в секунду, минуту или час — ограничение, чтобы не нагружать ваш сайт. По умолчанию — 5 в секунду.
• Под фидом видно, сколько изображений скопировано, в очереди и не скачано. Пока копии нет (или адрес картинки в фиде изменился), показывается исходная картинка.
• Копии учитываются в лимите хранилища изображений тарифа. Если переключатель недоступен, хранилище изображений в вашей установке не настроено.

Остатки

Остатки товаров нужны не всем магазинам, поэтому их учёт включается отдельно: переключатель Учитывать остатки есть в настройках каждого фида, а для товаров из API и плагинов магазинов — в карточке настроек раздела (Учитывать остатки из API и плагинов). По умолчанию он выключен.

• Включён — остаток сохраняется, а товар с нулевым остатком снимается с продажи. Работают функции на остатках, например цепочки «осталось мало». В фиде остаток берётся из <count> (YML), g:quantity (Google) или колонки stock, quantity, «остаток» (CSV и JSON), в API — из поля stock.
• Выключен — остаток не используется: товар показывается по признаку наличия из фида или поля available, даже если магазин передаёт нулевой остаток.

Загрузка через API

Разработчики могут загружать и удалять товары запросами к https://cdp.onetrace.ru/api/v1/products — до 1000 товаров и категорий за запрос. Нужен секретный ключ с правом «Загрузка и удаление товаров», см. API-ключи и Интеграция с сервера.

Языки каталога

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

• Фид на другом языке. Добавьте второй фид — ту же выгрузку на другом языке — и выберите для него Язык фида. Такой фид не создаёт товары и не снимает их с продажи: он дописывает переводы названий, ссылок и характеристик товарам основного фида с теми же id. Поле появляется, если в проекте несколько языков, см. Настройки проекта.
• Через API. Передайте переводы в поле translations товара и категории, например "translations": {"en": {"name": "Linen dress", "url": "https://shop.example/en/linen-dress"}}.

Язык выбирается сам: на сайте — язык посетителя, который передаёт трекер, в письме — язык его версии, см. Языковые версии. Если перевода на этот язык нет, показываются основные название и ссылка. Поиск по товарам находит товар по названию на любом из языков. В таблице товаров рядом с названием видны языки, на которые он переведён.

События для моделей

В блоке События для моделей укажите, какие события означают действия с товарами:

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

Модели и ночной расчёт

Карточка Модели показывает статус (Ожидает, Считается, Готово, Нет каталога, Ошибка), время расчёта и число связей между товарами.

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

Кроме связей, расчёт записывает в профили трейты favorite_category, favorite_brand и top_products, а для отраслей с размерами — pref_… (размер покупателя, см. Отрасль магазина) и replenish_at (дата «пора повторить»). Их можно использовать в сегментах, например «любимая категория — обувь».

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

Новый посетитель без истории получает популярные товары. В подборки попадают только товары в наличии.

Проверка выдачи

В блоке Проверить выдачу выберите Вид и укажите ID товара, ID категории или ID профиля — в зависимости от вида. Нажмите Показать, чтобы увидеть карточки товаров, которые получит покупатель.

Отчёт об эффекте

Таблица Эффект на сайте за 30 дней показывает по каждому виду показы, клики, CTR, покупки и выручку. Покупка засчитывается, если покупатель купил товар в течение 7 дней после клика по рекомендации, выручка считается по цене каталога. Эффект рекомендаций в письмах виден в отчётах рассылок и цепочек.

Где показывать рекомендации

• На сайте — готовые виджеты из раздела «Сайт» или вызов трекера, см. Виджеты рекомендаций на сайте.
• В письмах — блок Товары в конструкторе писем. В нём выбираются Какие товары, Сколько, число колонок, Показывать цену и Кнопка под товаром. Для видов «С этим смотрят», «С этим покупают» и «Похожие» товар берётся из события, запустившего письмо (Свойство события с id товара), — так строится письмо о брошенной корзине. Если подходящих товаров нет, блок в письме не показывается.
• В шаблонах любых каналов — функция recommendations():

{% for product in recommendations('personal', 4) %}
  <a href="{{ product.url }}">{{ product.name }}</a> — {{ product.price }}
{% endfor %}