Довідник подій
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. Після цього в Chat-запитах, сегментах і кампаніях можна вказати standard_kind = 'purchase' й охопити всі аліаси (purchase / purchased / purchase_completed / order_completed / checkout_completed) без ручного переліку.
Ці назви також використовуються в AI-евристиках для monetization / conversion / activation — 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 | Воронка переходу з trial у платну підписку |
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-factor |
Назви зіставляються без урахування регістру. Аліаси, яких немає в списку (наприклад, 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 із додатковими даними