События

Если на сайте стоят поисковый виджет и трекер, события отправляются автоматически. Эта страница — для интеграций через API: своя выдача, мобильное приложение, серверные события.

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

Что отправлять

Ситуация	Метод	Без него не будет
Клик по товару в выдаче или подсказках	GET /event/click	CTR поиска, «поиски без клика», обучение ранжирования
Просмотр, корзина, покупка	POST /event/datalayer.json	Персональные рекомендации, выручка от поиска
Показ и клик блока рекомендаций (своя вёрстка)	POST /widget-analytics	Статистика виджетов
Сессии для «Смотрят/покупают вместе»	POST /recs	Блок with-this-product

Во всех событиях — один и тот же userId, что и в запросах поиска и рекомендаций.

Клики по выдаче

GET/api/{uuid}/event/click.json

uuid проектДемо-проект SearchBooster. Подставьте UUID своего проекта из личного кабинета.entityIdID товараqueryIdТот же queryId, что передан в /searchsearchIduserIdparams {"offerId":"110166","pos":3} pos — позиция товара в выдаче (с 1)

cURLJavaScriptPHPPythonКопировать

Отправить запрос⌘↵

Параметр	Описание
type	productClick — клик в выдаче; productClickCompletions — в подсказках; addToCart — «В корзину» из выдачи.
entityId	ID товара.
queryId	ID поискового ответа, к которому относится клик. Генерируйте его сами и передавайте в /search и в клик.
searchId	ID поисковой сессии (несколько запросов подряд).
userId	ID посетителя.
params	JSON: offerId и pos — позиция в выдаче.
regionId	Регион.

Клик также добавляет товар в «Недавно просмотренные» этого userId.

Ecommerce-события

POST /api/{uuid}/event/datalayer.json — тот же формат, что GA4. Это главный источник данных для персональных рекомендаций.

curl -X POST 'https://api.searchbooster.net/api/{uuid}/event/datalayer.json' \
  -H 'Content-Type: text/plain;charset=UTF-8' \
  --data-raw '{
    "event": "purchase",
    "user_id": "docs-demo-user",
    "session_id": "s-20261017-1",
    "transaction_id": "T-991",
    "value": 1920,
    "currency": "RUB",
    "regionId": "msk",
    "is_searched": true,
    "client": "mobile_app_ios",
    "items": [
      { "item_id": "110166", "item_name": "Самоедская собака 1", "item_category": "Самоедская собака", "price": 960, "quantity": 2 }
    ]
  }'

Поле	Описание
event	view_item, add_to_cart, remove_from_cart, add_to_wishlist, view_cart, begin_checkout, purchase, refund, select_item, page_view и другие события GA4.
user_id	ID посетителя (как userId в поиске).
session_id	ID сессии.
items[]	Товары: item_id (= offer@id), item_name, item_category, price, quantity, item_brand, item_variant.
transaction_id, value, currency	Для purchase: номер заказа, сумма, валюта.
widget_id	Число — ID виджета рекомендаций, если покупка из блока.
is_searched	Покупка после поиска.
client, regionId, pathname	Платформа, регион, страница.

Что нужно для персонализации

Персональные рекомендации строятся только по событиям с user_id и items[].item_id, у которых есть item_category. События без них сохраняются в статистику, но не попадают в историю интересов.

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

Для блоков рекомендаций, которые вы рисуете сами, отправляйте show и click с requestId из ответа /widgets/{id} — подробно в API рекомендаций.

Поведенческие события для рекомендаций

POST /api/{uuid}/recs — пачка поведенческих событий. По ним строятся блоки «Смотрят вместе» и «Покупают вместе» (/with-this-product).

[
  { "feedback": "view_item", "userId": "docs-demo-user", "itemId": "110166", "session_id": "s-20261017-1" },
  { "feedback": "add_to_cart", "userId": "docs-demo-user", "itemId": "99839", "session_id": "s-20261017-1" }
]

feedback — одно из ecommerce-событий (view_item, add_to_cart, purchase, long_page_view…). Ответ — {"status":200}. Метод доступен для проектов с подключёнными виджетами рекомендаций.

Связка поиска и событий

1. Пользователь ищет «самоед» → вы генерируете queryId=q-7f3a и вызываете /search?query=самоед&queryId=q-7f3a&userId=….
2. Кликает по третьему товару → /event/click.json?type=productClick&entityId=110166&queryId=q-7f3a&params={"pos":3}.
3. Покупает → datalayer.json с event: "purchase", is_searched: true и тем же user_id.

Так в статистике появится полная воронка: запрос → клик → покупка → выручка от поиска.