Sündmuste viide
Kixo kogub allolevad levinud sündmused automaatselt; täpne valik ja andmevorming sõltuvad platvormist. Kõik sündmused sisaldavad standardvälju: device_id, session_id, timestamp ja properties.
Automaatselt kogutud sündmused
| Sündmuse tüüp | Sündmuse nimi | Platvorm | Omadused |
|---|---|---|---|
screen_view | Ekraani nimi | iOS, Android | screen_name, screen_class |
screen_visit | Tuletatud ekraaninimi | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, käivitaja metaandmed; iOS sisaldab lisaks välju tap_count ja scroll_count |
page_view | page_view | Web | url, path, title, referrer |
tap | Elemendi silt | 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; platvormipõhine elutsükli kontekst |
session_end | session_end | Web, iOS, Android | session_id; Web sisaldab välja duration_ms, kui lõpp on vaadeldav |
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 või unhandled_rejection | Web | sõnum, pinu, tüüp |
crash | Krahhi tüüp | iOS, Android | sõnum, pinu, erind või signaali kontekst |
network | network_request (Web); koondsilt või route'i silt (iOS) | Webi opt-in, iOS-i opt-in | Puhastatud marsruut, meetodi- või staatuseklass, kestus ja tulemus |
performance | Mõõdiku nimi (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 | Pushi ID | iOS; Android/Web, kui integreeritud | push_id, kixo_campaign_id, app_state, content_hash |
push_open | Pushi ID | Kõik (Androidis/Webis on vaja host-integratsiooni) | push_id, kixo_campaign_id, time_to_open_ms, interaction_type |
push_silent | Pushi ID | iOS, Android | push_id, kixo_campaign_id, content_hash |
push_dismissed | Pushi ID | iOS; Android/Web hosti integratsiooniga | push_id, kixo_campaign_id, interaction_type |
push_action | Pushi ID | iOS; Android host-integratsiooniga | push_id, kixo_campaign_id, action_id |
custom | Teie sündmuse nimi | Kõik | Suvalised sinu antud võtme-väärtuse paarid |
Standardsed sündmused (tuvastatakse nime järgi)
Kixo tunneb ära üksteist kanoonilist sündmusenime. Kui saadad neist ükskõik millise läbi Kixo.track("purchase", {amount: 49.99, currency: "USD"}), lisab Kixo sündmusele vastuvõtmisel välja standard_kind. Seejärel saavad Chat-päringud, segmendid ja kampaaniad kasutada kuju standard_kind = 'purchase' ning püüda kinni kõik aliased (purchase / purchased / purchase_completed / order_completed / checkout_completed) ilma neid käsitsi loetlemata.
Need nimed toidavad ka AI monetiseerimise, konversiooni ja aktiveerimise heuristikaid — Kixo.track("purchase") tõlgendatakse tuluna ilma lisaseadistuseta; valikulise omaduse amount_cents (või amount / value) väärtused liidetakse tulueesmärkide jaoks kokku. Kui teie süsteem talletab raha väiksemates ühikutes, sobib ka amount_cents.
| Kanooniline liik | Aliased | Soovitatud omadused | Toidab |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Omandamislehter |
activation | activated, user_activated, aha_moment | — | Aktivatsioonilehter, aha-hetk |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Tulu / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, kohordi säilivus |
subscribe_renewed | subscription_renewed | plan, amount | Korduv tulu |
trial_start | trial_started, free_trial_started | plan, days | Prooviperioodist tasuliseks lehter |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Tellimuse elutsükkel, loobumine |
upgrade | plan_upgraded | from_plan, to_plan | Laienemistulu |
downgrade | plan_downgraded | from_plan, to_plan | Tulude kokkusurumine |
share | shared, content_shared | channel | Viraalsuskoefitsient |
invite | invited, invite_sent, referral_sent | — | K-tegur |
Nimesid võrreldakse tõstutundetult. Aliased, mida loendis ei ole (nt bought, customer_paid), lükatakse teadlikult tagasi — kasutage üht kanoonilist kuju, et taksonoomia püsiks tiimide vahel stabiilne.
Kasutaja märgistamine sündmuse asemel. Kui soovid kasutajale püsivat "has purchased" lippu, mitte ainult sündmusepõhist signaali, kutsu Kixo.setUserProperty("subscribe", true) — vaata iga SDK jaotist "Tag a user for segmentation" (Web / iOS / Android).
Sündmuse struktuur
Iga Kixo'le saadetud sündmus järgib seda struktuuri:
- event_type — sündmuse perekond, näiteks ülal näidatud tüübid
- event_name — sündmuse kirjeldav nimi
- device_id — seadme unikaalne identifikaator
- session_id — rühmitab sündmused seansi piires
- ajatempel — ISO 8601 ajatempel
- omadused — lisaandmetega JSON-objekt