Referencja zdarzeń
Kixo automatycznie zbiera typowe zdarzenia wymienione poniżej; ich dokładny zestaw i format przesyłanych danych zależą od platformy. Każde zdarzenie zawiera standardowe pola: device_id, session_id, timestamp i properties.
Zdarzenia zbierane automatycznie
| Typ zdarzenia | Nazwa zdarzenia | Platforma | Właściwości |
|---|---|---|---|
screen_view | Nazwa ekranu | iOS, Android | screen_name, screen_class |
screen_visit | Ustalona nazwa ekranu | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, metadane wyzwalacza; w iOS także tap_count i scroll_count |
page_view | page_view | Web | url, path, title, referrer |
tap | Etykieta elementu | 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; kontekst cyklu życia zależny od platformy |
session_end | session_end | Web, iOS, Android | session_id; w Web także duration_ms, jeśli moment zakończenia da się zaobserwować |
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 lub unhandled_rejection | Web | message, stack, type |
crash | Typ awarii | iOS, Android | message, stack, kontekst exception albo signal |
network | network_request (Web); etykieta agregatu lub trasy (iOS) | Zgoda Web, zgoda iOS | Oczyszczona ścieżka, grupa metody/statusu, czas trwania i wynik |
performance | Nazwa metryki (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 | Identyfikator push | iOS; Android/Web po integracji | push_id, kixo_campaign_id, app_state, content_hash |
push_open | Identyfikator push | Wszystkie (na Android/Web wymagana integracja po stronie hosta) | push_id, kixo_campaign_id, time_to_open_ms, interaction_type |
push_silent | Identyfikator push | iOS, Android | push_id, kixo_campaign_id, content_hash |
push_dismissed | Identyfikator push | iOS; Android/Web z integracją z hostem | push_id, kixo_campaign_id, interaction_type |
push_action | Identyfikator push | iOS; Android z integracją hosta | push_id, kixo_campaign_id, action_id |
custom | Nazwa zdarzenia | Wszystkie | Dowolne podane pary klucz-wartość |
Zdarzenia standardowe (rozpoznawane po nazwie)
Kixo rozpoznaje jedenaście kanonicznych nazw zdarzeń. Jeśli wyślesz dowolną z nich przez Kixo.track("purchase", {amount: 49.99, currency: "USD"}), Kixo podczas przyjmowania danych dopisze do zdarzenia standard_kind. Dzięki temu zapytania w czacie, segmenty i kampanie mogą używać standard_kind = 'purchase' i objąć wszystkie aliasy (purchase / purchased / purchase_completed / order_completed / checkout_completed) bez ręcznego ich wymieniania.
Te nazwy zasilają też heurystyki AI dotyczące monetyzacji, konwersji i aktywacji — Kixo.track("purchase") jest bez dodatkowej konfiguracji rozumiane jako przychód, a opcjonalna właściwość amount_cents (lub amount / value) jest sumowana w celach przychodowych. Jeśli kwoty w Twoim systemie są zapisane w mniejszych jednostkach, akceptowane jest też amount_cents.
| Typ kanoniczny | Aliasy | Zalecane właściwości | Obsługuje |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Lejek pozyskania |
activation | activated, user_activated, aha_moment | — | Lejek aktywacji, moment aha |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Przychód / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, retencja kohort |
subscribe_renewed | subscription_renewed | plan, amount | Przychód cykliczny |
trial_start | trial_started, free_trial_started | plan, days | Lejek konwersji z okresu próbnego |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Cykl życia subskrypcji, churn |
upgrade | plan_upgraded | from_plan, to_plan | Przychód z rozszerzenia |
downgrade | plan_downgraded | from_plan, to_plan | Kompresja przychodu |
share | shared, content_shared | channel | Współczynnik wirusowości |
invite | invited, invite_sent, referral_sent | — | Współczynnik K |
Nazwy są dopasowywane bez rozróżniania wielkości liter. Aliasy spoza tej listy (np. bought, customer_paid) są celowo odrzucane — trzymaj się formy kanonicznej, żeby taksonomia pozostała spójna między zespołami.
Tagowanie użytkowników zamiast zdarzeń. Jeśli chcesz ustawić u użytkownika trwałą flagę „has purchased”, a nie tylko sygnał dla pojedynczego zdarzenia, wywołaj Kixo.setUserProperty("subscribe", true) — zobacz sekcję „Oznacz użytkownika do segmentacji” w dokumentacji każdego SDK (Web / iOS / Android).
Struktura zdarzenia
Każde zdarzenie wysyłane do Kixo ma następującą strukturę:
- event_type — rodzina zdarzenia, np. typy pokazane wyżej
- event_name — opisowa nazwa zdarzenia
- device_id — unikalny identyfikator urządzenia
- session_id — grupuje zdarzenia w ramach sesji
- znacznik czasu — znacznik czasu w formacie ISO 8601
- właściwości — obiekt JSON z dodatkowymi danymi