Prehľad udalostí
Kixo automaticky zbiera bežné udalosti uvedené nižšie; presná sada aj štruktúra prenášaných dát sa líši podľa platformy. Všetky udalosti obsahujú štandardné polia: device_id, session_id, timestamp a properties.
Automaticky zbierané udalosti
| Typ udalosti | Názov udalosti | Platforma | Vlastnosti |
|---|---|---|---|
screen_view | Názov obrazovky | iOS, Android | screen_name, screen_class |
screen_visit | Určený názov obrazovky | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, metadáta triggera; iOS obsahuje aj tap_count a scroll_count |
page_view | page_view | Web | url, path, title, referrer |
tap | Označenie 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 špecifický pre platformu |
session_end | session_end | Web, iOS, Android | session_id; Web obsahuje aj duration_ms, ak je možné určiť koniec |
scroll_depth | scroll_25 … scroll_100 | Web | depth (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 alebo unhandled_rejection | Web | message, stack, type |
crash | Typ pádu | iOS, Android | message, stack, exception alebo kontext signálu |
network | network_request (Web); súhrnný názov alebo označenie trasy (iOS) | Webový opt-in, iOS opt-in | Očistená cesta, skupina metódy/stavového kódu, trvanie a výsledok |
performance | Názov 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 | Push ID | iOS; Android/Web po integrácii | push_id, kixo_campaign_id, app_state, content_hash |
push_open | Push ID | Všetky (na Android/Web je potrebná integrácia v hostiteľskej aplikácii) | 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 s integráciou do hostiteľskej aplikácie | push_id, kixo_campaign_id, interaction_type |
push_action | Push ID | iOS; Android s integráciou v hostiteľskej aplikácii | push_id, kixo_campaign_id, action_id |
custom | Váš názov udalosti | Všetky | Ľubovoľné dvojice kľúč – hodnota, ktoré zadáte |
Štandardné udalosti (rozpoznávané podľa názvu)
Kixo rozpoznáva jedenásť kanonických názvov udalostí. Ak ktorúkoľvek z nich sledujete cez Kixo.track("purchase", {amount: 49.99, currency: "USD"}), Kixo pri prijatí udalosti doplní standard_kind. Dopyty v chate, segmenty aj kampane potom môžu používať standard_kind = 'purchase' a zachytia všetky aliasy (purchase / purchased / purchase_completed / order_completed / checkout_completed) bez toho, aby ste ich museli vypisovať ručne.
Tieto názvy používajú aj heuristiky AI pre monetizáciu, konverziu a aktiváciu — Kixo.track("purchase") sa bez konfigurácie chápe ako výnos; voliteľná vlastnosť amount_cents (alebo amount / value) sa sčítava pre výnosové ciele. Ak váš systém ukladá peniaze v menších jednotkách, akceptuje sa aj amount_cents.
| Kanonický typ | Aliasy | Odporúčané vlastnosti | Použitie |
|---|---|---|---|
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 | Príjmy / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, retencia kohort |
subscribe_renewed | subscription_renewed | plan, amount | Opakované príjmy |
trial_start | trial_started, free_trial_started | plan, days | Konverzný funnel z trialu |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Životný cyklus predplatného, churn |
upgrade | plan_upgraded | from_plan, to_plan | Expanzné výnosy |
downgrade | plan_downgraded | from_plan, to_plan | Pokles príjmov |
share | shared, content_shared | channel | Koeficient virality |
invite | invited, invite_sent, referral_sent | — | K-faktor |
Názvy sa porovnávajú bez ohľadu na veľkosť písmen. Aliasy, ktoré v zozname NIE SÚ (napr. bought, customer_paid), sa zámerne odmietajú — držte sa kanonického tvaru, aby taxonómia zostala stabilná naprieč tímami.
Označovanie používateľov namiesto udalostí. Ak chcete mať pri používateľovi trvalý príznak „has purchased“ — nie len signál pri jednej udalosti — zavolajte Kixo.setUserProperty("subscribe", true). Pozrite si sekciu „Označenie používateľa na segmentáciu“ v jednotlivých SDK (Web / iOS / Android).
Štruktúra udalosti
Každá udalosť odoslaná do Kixo má túto štruktúru:
- event_type — kategória udalosti, napríklad typy uvedené vyššie
- event_name — výstižný názov udalosti
- device_id — jedinečný identifikátor zariadenia
- session_id — zoskupuje udalosti v rámci relácie
- časová pečiatka — časová pečiatka vo formáte ISO 8601
- vlastnosti — objekt JSON s doplnkovými údajmi