Eventreferentie
Kixo verzamelt de veelvoorkomende events hieronder automatisch. Welke events precies worden verzonden en hoe ze op de wire zijn opgebouwd, verschilt per platform. Alle events bevatten de standaardvelden: device_id, session_id, timestamp en properties.
Automatisch verzamelde events
| Eventtype | Eventnaam | Platform | Properties |
|---|---|---|---|
screen_view | Schermnaam | iOS, Android | screen_name, screen_class |
screen_visit | Afgeleide schermnaam | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, triggermetadata; iOS bevat daarnaast tap_count en scroll_count |
page_view | page_view | Web | url, path, title, referrer |
tap | Label van element | 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; platformspecifieke lifecyclecontext |
session_end | session_end | Web, iOS, Android | session_id; Web bevat duration_ms als het einde waarneembaar is |
scroll_depth | scroll_25 … scroll_100 | Web | diepte (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 of unhandled_rejection | Web | bericht, stacktrace, type |
crash | Type crash | iOS, Android | bericht, stacktrace, exception- of signaalcontext |
network | network_request (Web); aggregatie- of routeringslabel (iOS) | Web-opt-in, iOS-opt-in | Opgeschoonde route, methode-/statusgroep, duur en uitkomst |
performance | Naam van de metric (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 indien geïntegreerd | push_id, kixo_campaign_id, app_state, content_hash |
push_open | Push-id | Alle (hostintegratie vereist op 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 met hostkoppeling | push_id, kixo_campaign_id, interaction_type |
push_action | Push-id | iOS; Android met hostintegratie | push_id, kixo_campaign_id, action_id |
custom | Je eventnaam | Alle | Alle sleutel-waardeparen die je meegeeft |
Standaardevents (herkend op naam)
Kixo herkent elf canonieke eventnamen. Track er een via Kixo.track("purchase", {amount: 49.99, currency: "USD"}) en Kixo zet bij ingestie standard_kind op het event. Query's in Chat, segmenten en campagnes kunnen daarna standard_kind = 'purchase' gebruiken en pakken dan alle aliassen mee (purchase / purchased / purchase_completed / order_completed / checkout_completed) zonder dat je die handmatig hoeft op te sommen.
Deze namen voeden ook de monetization-, conversion- en activation-heuristieken van de AI — Kixo.track("purchase") wordt zonder configuratie als omzet herkend; de optionele property amount_cents (of amount / value) wordt opgeteld voor omzetdoelen. Als je systeem bedragen in de kleinste munteenheid opslaat, wordt amount_cents ook geaccepteerd.
| Canoniek type | Aliassen | Aanbevolen properties | Stuurt aan |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Acquisitiefunnel |
activation | activated, user_activated, aha_moment | — | Activatiefunnel, aha-moment |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Omzet / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, cohortretentie |
subscribe_renewed | subscription_renewed | plan, amount | Terugkerende omzet |
trial_start | trial_started, free_trial_started | plan, days | Funnel voor trialconversie |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Abonnementslevenscyclus, churn |
upgrade | plan_upgraded | from_plan, to_plan | Uitbreidingsomzet |
downgrade | plan_downgraded | from_plan, to_plan | Omzetdaling |
share | shared, content_shared | channel | Viraliteitscoëfficiënt |
invite | invited, invite_sent, referral_sent | — | K-factor |
Namen worden hoofdletterongevoelig gematcht. Aliassen die NIET in de lijst staan (zoals bought, customer_paid) worden bewust afgewezen — kies één canonieke vorm, zodat de taxonomie tussen teams stabiel blijft.
Gebruikers taggen in plaats van events. Wil je een blijvende "has purchased"-flag op de gebruiker, en niet alleen een signaal per event, roep dan Kixo.setUserProperty("subscribe", true) aan — zie in elke SDK de sectie "Tag a user for segmentation" (Web / iOS / Android).
Eventstructuur
Elk event dat naar Kixo wordt verstuurd, heeft deze structuur:
- event_type — de eventfamilie, zoals de typen hierboven
- event_name — een beschrijvende naam voor het event
- device_id — unieke apparaat-id
- session_id — groepeert events binnen een sessie
- timestamp — ISO 8601-tijdstempel
- properties — JSON-object met extra gegevens