Referință pentru evenimente
Kixo colectează automat evenimentele uzuale de mai jos; setul exact și structura payloadului diferă în funcție de platformă. Toate evenimentele includ câmpurile standard: device_id, session_id, timestamp și properties.
Evenimente colectate automat
| Tipul evenimentului | Numele evenimentului | Platformă | Proprietăți |
|---|---|---|---|
screen_view | Nume ecran | iOS, Android | screen_name, screen_class |
screen_visit | Nume de ecran rezolvat | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, metadate despre declanșator; pe iOS sunt incluse și tap_count și scroll_count |
page_view | page_view | Web | url, path, title, referrer |
tap | Eticheta elementului | 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; context de lifecycle specific platformei |
session_end | session_end | Web, iOS, Android | session_id; pe Web include duration_ms când sfârșitul poate fi observat |
scroll_depth | scroll_25 … scroll_100 | Web | adâncime (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 sau unhandled_rejection | Web | message, stack, type |
crash | Tipul crash-ului | iOS, Android | message, stack, exception sau context de semnal |
network | network_request (Web); etichetă agregată sau de rutare (iOS) | Opt-in pe Web, opt-in pe iOS | Rută sanitizată, familie metodă/status, durată și rezultat |
performance | Numele metricii (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 notificare push | iOS; Android/Web când sunt integrate | push_id, kixo_campaign_id, app_state, content_hash |
push_open | ID notificare push | Toate (integrare în aplicația gazdă necesară pe Android/Web) | push_id, kixo_campaign_id, time_to_open_ms, interaction_type |
push_silent | ID notificare push | iOS, Android | push_id, kixo_campaign_id, content_hash |
push_dismissed | ID notificare push | iOS; Android/Web cu integrare în aplicația gazdă | push_id, kixo_campaign_id, interaction_type |
push_action | ID notificare push | iOS; Android cu integrare în aplicația gazdă | push_id, kixo_campaign_id, action_id |
custom | Numele evenimentului | Toate | Orice perechi cheie-valoare pe care le trimiți |
Evenimente standard (recunoscute după nume)
Kixo recunoaște unsprezece denumiri canonice de evenimente. Dacă trimiți oricare dintre ele prin Kixo.track("purchase", {amount: 49.99, currency: "USD"}), Kixo adaugă standard_kind la ingestie. Apoi, interogările din chat, segmentele și campaniile pot folosi standard_kind = 'purchase' și vor acoperi toate aliasurile (purchase / purchased / purchase_completed / order_completed / checkout_completed) fără să le enumeri manual.
Aceste nume alimentează și euristicile AI pentru monetizare / conversie / activare — Kixo.track("purchase") este înțeles ca venit fără nicio configurare; proprietatea opțională amount_cents (sau amount / value) este însumată pentru obiectivele de venit. Dacă sistemul tău stochează sumele în unități minore, este acceptat și amount_cents.
| Tip canonic | Aliasuri | Proprietăți recomandate | Susține |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Pâlnie de achiziție |
activation | activated, user_activated, aha_moment | — | Pâlnie de activare, momentul „aha” |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Venit / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, retenția pe cohorte |
subscribe_renewed | subscription_renewed | plan, amount | Venit recurent |
trial_start | trial_started, free_trial_started | plan, days | Funnel de conversie din trial |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Ciclul de viață al abonamentului, churn |
upgrade | plan_upgraded | from_plan, to_plan | Venit din extindere |
downgrade | plan_downgraded | from_plan, to_plan | Comprimarea veniturilor |
share | shared, content_shared | channel | Coeficient de viralitate |
invite | invited, invite_sent, referral_sent | — | Factor K |
Numele sunt comparate fără a ține cont de litere mari sau mici. Aliasurile care NU sunt în listă (de ex. bought, customer_paid) sunt respinse intenționat — standardizați pe o formă canonică, ca taxonomia să rămână stabilă între echipe.
Etichetezi utilizatorii, nu evenimentele. Dacă vrei un marcaj persistent „has purchased” pe utilizator, nu doar un semnal per eveniment, apelează Kixo.setUserProperty("subscribe", true) — vezi secțiunea „Etichetează un utilizator pentru segmentare” din fiecare SDK (Web / iOS / Android).
Structura evenimentului
Fiecare eveniment trimis către Kixo urmează această structură:
- event_type — familia evenimentului, de exemplu tipurile afișate mai sus
- event_name — nume descriptiv al evenimentului
- device_id — identificator unic al dispozitivului
- session_id — grupează evenimentele în cadrul unei sesiuni
- timestamp — marcaj temporal ISO 8601
- proprietăți — obiect JSON cu date suplimentare