Трекинг событий: SDK и API

События — это действия пользователей, привязанные к профилю контакта. Собираются тремя способами.

Автоматически

После установки сниппета SDK сам шлёт page_view при каждой загрузке страницы и собирает браузер, ОС, устройство, язык и страну (по IP на сервере).

Произвольные события (фронтенд)

cep('track', 'added_to_cart', { product: 'Стол Осло', price: 12990 });

События буферизуются и отправляются пакетами; при обрыве сети — повтор.

Идентификация

cep('identify', 'user-42', { email: 'anna@shop.ru', name: 'Анна' });

Вызовите identify после логина — вся анонимная история склеится с профилем клиента. Повторный вызов с тем же ID с другого устройства попадёт в тот же контакт.

Серверные события (REST API)

Оплаты, регистрации и другие серверные действия отправляйте с бэкенда:

POST https://livecontext.ru/v1/events
Authorization: Bearer СЕКРЕТНЫЙ_КЛЮЧ
Content-Type: application/json

{ "external_id": "user-42", "name": "purchase", "properties": { "amount": 4990 } }

Также доступен POST /v1/contacts для создания/обновления контакта (upsert по внешнему ID или email).