Händelsereferens
Kixo samlar automatiskt in de vanliga händelserna nedan. Exakt vilka som ingår och hur de serialiseras varierar mellan plattformar. Alla händelser innehåller standardfälten device_id, session_id, timestamp och properties.
Automatiskt insamlade händelser
| Händelsetyp | Händelsenamn | Plattform | Egenskaper |
|---|---|---|---|
screen_view | Skärmnamn | iOS, Android | screen_name, screen_class |
screen_visit | Löst skärmnamn | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, utlösarmetadata; iOS innehåller också tap_count och scroll_count |
page_view | page_view | Webb | url, path, title, referrer |
tap | Elementetikett | iOS, Android | target_class, target_text, screen_name |
click | click | Webb | tag, path, text, href, x, y |
session_start | session_start | Webb, iOS, Android | session_id; plattformsspecifik livscykelkontext |
session_end | session_end | Webb, iOS, Android | session_id; på webben ingår även duration_ms när slutet går att observera |
scroll_depth | scroll_25 … scroll_100 | Webb | djup (25, 50, 75, 100), url, path |
interaction | rage_click | Webb | tag, path, text, click_count, x, y |
interaction | dead_click | Webb | tag, path, text, x, y |
error | js_error eller unhandled_rejection | Webb | meddelande, stackspårning, typ |
crash | Kraschtyp | iOS, Android | meddelande, stackspårning, undantags- eller signalkontext |
network | network_request (Web); aggregat- eller route-etikett (iOS) | Opt-in på webben, opt-in på iOS | Sanerad väg, metod-/statusfamilj, varaktighet och utfall |
performance | Måttnamn (LCP, FCP, CLS, INP, TTFB) | Webb | value, rating, id, delta |
heatmap_click | heatmap_click | Webb | x, y, viewport_width, viewport_height, page_url, element_selector |
push_received | Push-id | iOS; Android/Web när det är integrerat | push_id, kixo_campaign_id, app_state, content_hash |
push_open | Push-id | Alla (värdintegration krävs på 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/webb med värdintegration | push_id, kixo_campaign_id, interaction_type |
push_action | Push-id | iOS; Android med värdintegration | push_id, kixo_campaign_id, action_id |
custom | Ditt händelsenamn | Alla | Valfria nyckel/värde-par som du skickar med |
Standardhändelser (känns igen på namn)
Kixo känner igen elva kanoniska händelsenamn. Spårar du något av dem via Kixo.track("purchase", {amount: 49.99, currency: "USD"}) lägger Kixo till standard_kind på händelsen vid inläsning. Frågor i chatten, segment och kampanjer kan sedan använda standard_kind = 'purchase' och fånga alla alias (purchase / purchased / purchase_completed / order_completed / checkout_completed) utan att du behöver lista dem manuellt.
De här namnen matar också AI:s heuristik för intäkter, konvertering och aktivering — Kixo.track("purchase") tolkas som intäkt utan någon konfiguration, och den valfria egenskapen amount_cents (eller amount / value) summeras för intäktsmål. Om ert system lagrar belopp i mindre valutaenheter accepteras även amount_cents.
| Kanonisk typ | Alias | Rekommenderade egenskaper | Driver |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Förvärvstratt |
activation | activated, user_activated, aha_moment | — | Aktiveringstratt, aha-ögonblick |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Intäkter / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, kohortretention |
subscribe_renewed | subscription_renewed | plan, amount | Återkommande intäkter |
trial_start | trial_started, free_trial_started | plan, days | Tratt för konvertering från provperiod |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Prenumerationslivscykel, churn |
upgrade | plan_upgraded | from_plan, to_plan | Expansionsintäkter |
downgrade | plan_downgraded | from_plan, to_plan | Intäktskompression |
share | shared, content_shared | channel | Viralitetskoefficient |
invite | invited, invite_sent, referral_sent | — | K-faktor |
Namnen matchas utan hänsyn till versaler och gemener. Alias som INTE finns i listan, till exempel bought och customer_paid, avvisas medvetet — använd en kanonisk form så att taxonomin hålls stabil mellan team.
Tagga användare i stället för händelser. Om du vill ha en bestående "has purchased"-flagga på användaren, och inte bara en signal per händelse, anropar du Kixo.setUserProperty("subscribe", true) — se avsnittet "Tagga en användare för segmentering" i respektive SDK (Webb / iOS / Android).
Händelsestruktur
Varje händelse som skickas till Kixo följer den här strukturen:
- event_type — händelsefamiljen, till exempel typerna ovan
- event_name — ett beskrivande namn på händelsen
- device_id — unik enhetsidentifierare
- session_id — grupperar händelser inom en session
- timestamp — tidsstämpel i ISO 8601-format
- properties — JSON-objekt med ytterligare data