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

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

Каждый шаг покупателя — событие. Чем полнее события, тем точнее персонализация и тем честнее статистика выручки от поиска.

Установка

<script defer src="https://cdn2.searchbooster.net/scripts/tracker/PROJECT_UUID/searchbooster.js"></script>

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

Откуда трекер берёт события

Трекер читает события электронной коммерции из контейнера 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: 960,
    items: [{ item_id: '110166', item_name: 'Самоедская собака 1', price: 960, 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 при первом запуске, храните его и используйте во всех запросах и событиях.

Проверка

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