Справочник за събития
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 ID | iOS; Android/Web при интеграция | push_id, kixo_campaign_id, app_state, content_hash |
push_open | Push ID | Всички (на Android/Web е нужна интеграция в хост приложението) | push_id, kixo_campaign_id, time_to_open_ms, interaction_type |
push_silent | Push ID | iOS, Android | push_id, kixo_campaign_id, content_hash |
push_dismissed | Push ID | iOS; Android/Web с интеграция в хост приложението | push_id, kixo_campaign_id, interaction_type |
push_action | Push ID | 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 за монетизация, конверсия и активация — 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-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 обект с допълнителни данни