Перейти к содержимому

Трекер событий

Трекер — скрипт, который собирает действия посетителей: просмотры товаров, корзины, покупки. Эти данные нужны для персональных рекомендаций, «С этим покупают», ранжирования поиска по популярности и статистики выручки.

Путь покупателя и событияПокупательСобытие → что улучшает🔎 Поиск/searchистория, статистика👆 Кликevent/clickCTR, ранжирование👀 Карточкаview_itemперсональные, «вы смотрели»🛒 Корзинаadd_to_cart«с этим покупают»✅ Заказpurchaseвыручка, популярность
Каждый шаг покупателя — событие. Чем полнее события, тем точнее персонализация и тем честнее статистика выручки от поиска.
<script defer src="https://cdn2.searchbooster.net/scripts/tracker/PROJECT_UUID/searchbooster.js"></script>

Разместите в <head> всех страниц. Если используете установку виджетов одной строкой (init.js), трекер уже подключён.

Отдельный тег можно не ставить, если на сайте стоит Код SearchBooster: включите в кабинете на странице Код SearchBooster переключатель Трекер событий, и трекер загрузится через код. Если трекер уже подключён отдельно или в вашем коде, второй раз он не запустится: события не задвоятся.

Трекер читает события электронной коммерции из контейнера dataLayer — того же, что используют Google Analytics 4 и Google Tag Manager. Если ecommerce-разметка на сайте уже есть, дополнительно ничего делать не нужно.

Событие Когда отправлять Для чего нужно
view_item Открыта карточка товара Персональные, «Недавно просмотренные», «Смотрели вместе»
add_to_cart Товар добавлен в корзину Персональные, «С этим покупают», популярность
add_to_wishlist Товар в избранном Персональные
begin_checkout Начато оформление Воронка
purchase Заказ оформлен Выручка поиска и виджетов, «С этим покупают», популярность

Пример разметки в формате GA4:

window.dataLayer = window.dataLayer || [];
dataLayer.push({
event: 'add_to_cart',
ecommerce: {
currency: 'RUB',
value: 219,
items: [{ item_id: '1077', item_name: 'Сыр Российский 50% «Сырная лавка» 200 г', price: 219, quantity: 1, item_category: 'Твёрдые и полутвёрдые сыры' }],
},
});

Если dataLayer называется иначе или события лежат по другим путям, настройте соответствие в личном кабинете (Трекер):

  • имя контейнера (по умолчанию dataLayer);
  • для каждого события — путь к имени события, его значение и путь к массиву товаров;
  • имя cookie с вашим ID пользователя — чтобы трекер использовал ваш ID вместо своего;
  • режим GTM — если page_view и просмотры каталога уже отправляются из GTM.

Разметки нет совсем, или нужна отправка с сервера (например, покупка подтверждается в CRM)? Отправляйте события напрямую в API — События.

Трекер создаёт cookie searchbooster_v2_user_id — стабильный ID посетителя. Передавайте это значение как userId во все запросы к API поиска и рекомендаций, если вызываете их сами:

const userId = document.cookie.match(/(?:^|; )searchbooster_v2_user_id=([^;]*)/)?.[1];

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

На первой странице сессии трекер запоминает, откуда пришёл посетитель, и прикладывает это к каждому событию сессии:

  • домен внешнего сайта-реферера (yandex.ru, google.com) — без пути и параметров;
  • метки utm_source, utm_medium, utm_campaign, utm_term, utm_content из адреса страницы входа;
  • имя параметра рекламного клика, если он есть в адресе (yclid, gclid, fbclid, vkclid), — само значение не сохраняется;
  • путь страницы входа.

Новый внешний заход или новые UTM-метки в течение сессии заменяют сохранённые значения; переходы внутри сайта их не меняют. Данные хранятся в localStorage (sb_tracker_session_source) и нужны, чтобы подбирать рекомендации новым посетителям по рекламной кампании или запросу, с которым они пришли. Ничего настраивать не нужно.

  1. Откройте карточку товара, в DevTools → Network найдите запрос datalayer.json с "event":"view_item".
  2. Добавьте товар в корзину — должен уйти запрос с add_to_cart и вашим item_id.
  3. Через несколько минут события появятся в статистике личного кабинета.

На странице Трекер личного кабинета есть таблица «Проверка установки трекера». Она считает события, которые уже пришли за последние 24 часа и 7 дней, и для каждой проблемы ведёт в нужный раздел ниже. Результат обновляется не чаще раза в 10 минут.

За последние 24 часа нет ни одного события datalayer.json.

  • Проверьте, что тег трекера стоит на всех страницах или что в Коде SearchBooster включён Трекер событий.
  • Откройте карточку товара и найдите в DevTools → Network запрос datalayer.json. Если запроса нет, а события в dataLayer есть, проверьте нестандартную разметку: имя контейнера и пути к событиям.
  • Если события шли раньше и пропали — скорее всего, после обновления сайта изменилась разметка dataLayer или тег трекера убрали из шаблона.

Типы событий проверяются по отдельности:

Событие Если его нет
view_item Ошибка: не работают «Недавно просмотренные», персональные рекомендации и «Смотрели вместе».
add_to_cart Предупреждение: нет данных для «С этим покупают» и популярности.
begin_checkout, purchase Не ошибка: без них не считаются воронка и выручка, рекомендации работают.

Отправляйте view_item при открытии карточки товара — формат события.

В заметной части событий пустые items[].item_id или user_id, а у покупок — сумма value. Пустым считается и значение "undefined" или "null": так GTM передаёт переменную, которая не нашлась на странице. Список полей — в разделе Ecommerce-события.

Персональная история посетителя собирается по user_id. Если user_id новый на каждой странице, у каждого «посетителя» оказывается одно действие, и персональные рекомендации построить не из чего.

Проверка считает, какая доля user_id за 7 дней совершила ровно одно действие с товаром:

  • до 90% — норма: большинство посетителей магазина смотрят один товар и уходят. Обычно таких около 60%, у магазинов с разовыми заходами из рекламы — до 90%;
  • больше 90% — предупреждение: проверьте, не сбрасывается ли идентификатор;
  • больше 97% — ошибка: идентификатор почти наверняка меняется на каждой странице.

Что проверить:

  • Если в настройках трекера указано имя cookie с вашим ID пользователя, эта cookie должна жить дольше одной страницы и не перезаписываться при каждой загрузке. Если такой cookie нет, трекер использует свою — searchbooster_v2_user_id.
  • Если отправляете события сами (из GTM или с сервера), передавайте в user_id одно и то же значение для одного посетителя, то же, что userId в запросах поиска и рекомендаций. Не используйте ID запроса, страницы или случайное число.
  • Откройте две страницы подряд и сравните user_id в запросах datalayer.json — он должен совпадать.

Ошибкой считаются и обратные случаи: user_id пустой в большинстве событий или один и тот же у всех посетителей.

item_id в событиях должен совпадать с id товара (offer@id) в фиде. Проверка берёт самые частые item_id за 7 дней, ищет их в каталоге проекта и показывает несколько примеров, которых в каталоге нет. Если совпало меньше 30% — это ошибка, меньше 80% — предупреждение.

Частые причины:

  • в dataLayer передаётся артикул, SKU или ID из учётной системы, а в фиде — другой ID;
  • передаётся ID группы товаров (group_id) вместо ID конкретного предложения;
  • ID дополнен префиксом или суффиксом (sku-123 вместо 123).

Сравните примеры из таблицы с id в фиде и передавайте в item_id то же значение. Если исправить разметку нельзя, а ID группы в фиде совпадает с тем, что передаёте, обратитесь в поддержку.

items[].item_category попадает в персональную историю посетителя и нужна персональным рекомендациям (подробнее). В статистике категория не хранится, поэтому таблица её не проверяет: убедитесь в DevTools, что у товаров в datalayer.json заполнено item_category.

Чтобы считать выручку рекомендаций, события корзины и покупки должны содержать widget_id. Трекер проставляет его сам: после клика по товару в виджете или в ИИ-чате (widget_id 100922) он помечает add_to_cart этого товара в течение 24 часов, begin_checkout и purchase — в течение 7 дней. Товар узнаётся по item_id или ID группы, поэтому при несовпадении item_id с фидом атрибуция тоже не работает.

Проверка предупреждает, если по виджетам за 7 дней кликали, а ни в одном событии корзины, оформления или покупки нет widget_id. Причины: события отправляются не через трекер (из GTM или с сервера) — тогда передавайте widget_id сами; на странице оформления заказа трекер не подключён; ID товаров не совпадают.