Referenční přehled událostí
Kixo automaticky sbírá níže uvedené běžné události; jejich přesný výčet i struktura přenášených dat se liší podle platformy. Všechny události obsahují standardní pole: device_id, session_id, timestamp a properties.
Automaticky sbírané události
| Typ události | Název události | Platforma | Vlastnosti |
|---|---|---|---|
screen_view | Název obrazovky | iOS, Android | screen_name, screen_class |
screen_visit | Vyhodnocený název obrazovky | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, metadata triggeru; iOS navíc zahrnuje tap_count a scroll_count |
page_view | page_view | Web | url, path, title, referrer |
tap | Popisek prvku | iOS, Android | target_class, target_text, screen_name |
click | click | Web | tag, path, text, href, x, y |
session_start | session_start | Web, iOS, Android | session_id; kontext životního cyklu podle platformy |
session_end | session_end | Web, iOS, Android | session_id; Web zahrnuje i duration_ms, pokud lze konec spolehlivě rozpoznat |
scroll_depth | scroll_25 … scroll_100 | Web | hloubka (25, 50, 75, 100), url, path |
interaction | rage_click | Web | tag, path, text, click_count, x, y |
interaction | dead_click | Web | tag, path, text, x, y |
error | js_error nebo unhandled_rejection | Web | zpráva, stack trace, typ |
crash | Typ pádu | iOS, Android | zpráva, stack trace, kontext výjimky nebo signálu |
network | network_request (Web); agregační nebo směrovací štítek (iOS) | Opt-in na Webu, opt-in v iOS | Očištěná cesta, skupina metod/stavových kódů, trvání a výsledek |
performance | Název metriky (LCP, FCP, CLS, INP, TTFB) | Web | value, rating, id, delta |
heatmap_click | heatmap_click | Web | x, y, viewport_width, viewport_height, page_url, element_selector |
push_received | ID push notifikace | iOS; Android/Web po integraci | push_id, kixo_campaign_id, app_state, content_hash |
push_open | ID push notifikace | Vše (na Android/Web vyžaduje integraci hostitelské aplikace) | push_id, kixo_campaign_id, time_to_open_ms, interaction_type |
push_silent | ID push notifikace | iOS, Android | push_id, kixo_campaign_id, content_hash |
push_dismissed | ID push notifikace | iOS; Android/Web s integrací hostitelské aplikace | push_id, kixo_campaign_id, interaction_type |
push_action | ID push notifikace | iOS; Android s integrací hostitelské aplikace | push_id, kixo_campaign_id, action_id |
custom | Název vaší události | Vše | Libovolné páry klíč–hodnota, které zadáte |
Standardní události (rozpoznané podle názvu)
Kixo rozpoznává jedenáct kanonických názvů událostí. Když kteroukoli z nich pošlete přes Kixo.track("purchase", {amount: 49.99, currency: "USD"}), Kixo při ingestu k události doplní standard_kind. Dotazy v Chatu, segmenty i kampaně pak mohou používat standard_kind = 'purchase' a pokrýt všechny aliasy (purchase / purchased / purchase_completed / order_completed / checkout_completed) bez ručního vypisování.
Tyto názvy vstupují i do heuristik AI pro monetizaci, konverze a aktivaci — Kixo.track("purchase") se bez jakékoli konfigurace chápe jako tržba; volitelná vlastnost amount_cents (nebo amount / value) se sčítá pro cíle založené na tržbách. Pokud váš systém ukládá peněžní částky v menších jednotkách, podporuje se i amount_cents.
| Kanonický typ | Aliasy | Doporučené vlastnosti | Měří |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Akviziční funnel |
activation | activated, user_activated, aha_moment | — | Aktivační funnel, aha moment |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Tržby / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, retence kohort |
subscribe_renewed | subscription_renewed | plan, amount | Opakované výnosy |
trial_start | trial_started, free_trial_started | plan, days | Trychtýř konverze ze zkušebního období |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Životní cyklus předplatného, churn |
upgrade | plan_upgraded | from_plan, to_plan | Tržby z rozšíření |
downgrade | plan_downgraded | from_plan, to_plan | Zhuštění tržeb |
share | shared, content_shared | channel | Koeficient virality |
invite | invited, invite_sent, referral_sent | — | K-faktor |
Názvy se porovnávají bez ohledu na velikost písmen. Aliasy, které v seznamu NEJSOU (např. bought, customer_paid), se záměrně odmítají — držte se kanonického tvaru, aby taxonomie zůstala stabilní napříč týmy.
Označování uživatelů místo událostí. Pokud chcete uživateli nastavit trvalý příznak „has purchased“, nejen signál u jedné události, zavolejte Kixo.setUserProperty("subscribe", true) — viz část „Označení uživatele pro segmentaci“ v jednotlivých SDK (Web / iOS / Android).
Struktura události
Každá událost odeslaná do Kixo má tuto strukturu:
- event_type — rodina události, například typy uvedené výše
- event_name — popisný název události
- device_id — jedinečný identifikátor zařízení
- session_id — seskupuje události v rámci relace
- časová značka — časové razítko ve formátu ISO 8601
- vlastnosti — objekt JSON s doplňujícími daty