Трекер событий
Трекер — скрипт, который собирает действия посетителей: просмотры товаров, корзины, покупки. Эти данные нужны для персональных рекомендаций, «С этим покупают», ранжирования поиска по популярности и статистики выручки.
Установка
Заголовок раздела «Установка»<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) и нужны, чтобы подбирать рекомендации новым посетителям по рекламной кампании или запросу, с которым они пришли. Ничего настраивать не нужно.
Проверка
Заголовок раздела «Проверка»- Откройте карточку товара, в DevTools → Network найдите запрос
datalayer.jsonс"event":"view_item". - Добавьте товар в корзину — должен уйти запрос с
add_to_cartи вашимitem_id. - Через несколько минут события появятся в статистике личного кабинета.
Проверка в личном кабинете
Заголовок раздела «Проверка в личном кабинете»На странице Трекер личного кабинета есть таблица «Проверка установки трекера». Она считает события, которые уже пришли за последние 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-события.
userId меняется на каждой странице
Заголовок раздела «userId меняется на каждой странице»Персональная история посетителя собирается по 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 не совпадает с фидом
Заголовок раздела «item_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 товаров не совпадают.