Справочник событий
Kixo автоматически собирает типовые события ниже; точный набор и формат зависят от платформы. Во все события входят стандартные поля: device_id, session_id, timestamp и properties.
События, собираемые автоматически
| Тип события | Имя события | Платформа | Свойства |
|---|---|---|---|
screen_view | Имя экрана | iOS, Android | screen_name, screen_class |
screen_visit | Определённое имя экрана | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, метаданные триггера; в iOS также передаются tap_count и scroll_count |
page_view | page_view | Веб | url, path, title, referrer |
tap | Метка элемента | iOS, Android | target_class, target_text, screen_name |
click | click | Веб | tag, path, text, href, x, y |
session_start | session_start | Web, iOS, Android | session_id; контекст жизненного цикла, зависящий от платформы |
session_end | session_end | Web, iOS, Android | session_id; в Web также передаётся duration_ms, если момент завершения можно определить |
scroll_depth | scroll_25 … scroll_100 | Веб | глубина (25, 50, 75, 100), url, path |
interaction | rage_click | Веб | tag, path, text, click_count, x, y |
interaction | dead_click | Веб | tag, path, text, x, y |
error | js_error или unhandled_rejection | Веб | сообщение, стек, тип |
crash | Тип сбоя | iOS, Android | контекст сообщения, стека, исключения или сигнала |
network | network_request (Web); агрегированная метка или метка маршрута (iOS) | Согласие в Web, согласие в iOS | Очищенный маршрут, группа метода/статуса, длительность и результат |
performance | Название метрики (LCP, FCP, CLS, INP, TTFB) | Веб | value, rating, id, delta |
heatmap_click | heatmap_click | Веб | x, y, viewport_width, viewport_height, page_url, element_selector |
push_received | Идентификатор push-уведомления | iOS; Android/Web при наличии интеграции | push_id, kixo_campaign_id, app_state, content_hash |
push_open | Идентификатор push-уведомления | Все (на Android/Web нужна интеграция на стороне хоста) | push_id, kixo_campaign_id, time_to_open_ms, interaction_type |
push_silent | Идентификатор push-уведомления | iOS, Android | push_id, kixo_campaign_id, content_hash |
push_dismissed | Идентификатор push-уведомления | iOS; Android/Web при интеграции в приложении-хосте | push_id, kixo_campaign_id, interaction_type |
push_action | Идентификатор push-уведомления | iOS; Android при интеграции на стороне хоста | push_id, kixo_campaign_id, action_id |
custom | Имя вашего события | Все | Любые пары ключ-значение, которые вы передадите |
Стандартные события (распознаются по имени)
Kixo распознаёт одиннадцать канонических имён событий. Если отправить любое из них через Kixo.track("purchase", {amount: 49.99, currency: "USD"}), Kixo при приёме добавит событию standard_kind. После этого в запросах чата, сегментах и кампаниях можно использовать standard_kind = 'purchase', и Kixo учтёт все алиасы (purchase / purchased / purchase_completed / order_completed / checkout_completed) без ручного перечисления.
Эти имена также используются в эвристиках AI для монетизации, конверсии и активации: Kixo.track("purchase") без дополнительной настройки понимается как выручка; необязательное свойство amount_cents (или amount / value) суммируется для целей по выручке. Если суммы в вашей системе хранятся в младших денежных единицах, amount_cents тоже поддерживается.
| Канонический тип | Псевдонимы | Рекомендуемые свойства | Что можно анализировать |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Воронка привлечения |
activation | activated, user_activated, aha_moment | — | Воронка активации, aha-moment |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Выручка / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, удержание по когортам |
subscribe_renewed | subscription_renewed | plan, amount | Регулярная выручка |
trial_start | trial_started, free_trial_started | plan, days | Воронка перехода с триала на оплату |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Жизненный цикл подписки, отток |
upgrade | plan_upgraded | from_plan, to_plan | Доход от расширения |
downgrade | plan_downgraded | from_plan, to_plan | Снижение выручки |
share | shared, content_shared | channel | Коэффициент вирусности |
invite | invited, invite_sent, referral_sent | — | K-фактор |
Имена сопоставляются без учёта регистра. Алиасы вне списка, например bought и customer_paid, намеренно отклоняются — используйте каноническую форму, чтобы таксономия оставалась стабильной между командами.
Помечать пользователя вместо события. Если нужен постоянный признак пользователя «has purchased», а не только сигнал на уровне события, вызовите Kixo.setUserProperty("subscribe", true). См. раздел "Tag a user for segmentation" в документации каждого SDK (Веб / iOS / Android).
Структура события
Каждое событие, отправляемое в Kixo, имеет такую структуру:
- event_type — семейство события, например один из типов выше
- event_name — понятное имя события
- device_id — уникальный идентификатор устройства
- session_id — связывает события внутри сессии
- метка времени — метка времени в формате ISO 8601
- свойства — объект JSON с дополнительными данными