Notikumu atsauce
Kixo automātiski vāc tālāk norādītos izplatītākos notikumus; precīzais kopums un pārsūtāmo datu formāts atšķiras atkarībā no platformas. Visos notikumos ir standarta lauki: device_id, session_id, timestamp un properties.
Automātiski vākti notikumi
| Notikuma tips | Notikuma nosaukums | Platforma | Īpašības |
|---|---|---|---|
screen_view | Ekrāna nosaukums | iOS, Android | screen_name, screen_class |
screen_visit | Noteiktais ekrāna nosaukums | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, trigera metadati; iOS papildus iekļauj arī tap_count un scroll_count |
page_view | page_view | Web | url, path, title, referrer |
tap | Elementa etiķete | 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; platformai raksturīgs dzīves cikla konteksts |
session_end | session_end | Web, iOS, Android | session_id; Web iekļauj duration_ms, ja beigas ir novērojamas |
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 vai unhandled_rejection | Web | ziņojums, steks, tips |
crash | Avārijas tips | iOS, Android | ziņojums, steks, izņēmums vai signāla konteksts |
network | network_request (Web); apkopojuma vai maršruta etiķete (iOS) | Web piekrišana, iOS piekrišana | Attīrīts maršruts, metodes/statusa grupa, ilgums un iznākums |
performance | Metrikas nosaukums (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, ja integrēts | push_id, kixo_campaign_id, app_state, content_hash |
push_open | Push ID | Visi (Android/Web nepieciešama host lietotnes integrācija) | 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 ar hosta integrāciju | push_id, kixo_campaign_id, interaction_type |
push_action | Push ID | iOS; Android ar host lietotnes integrāciju | push_id, kixo_campaign_id, action_id |
custom | Jūsu notikuma nosaukums | Visi | Jebkuri jūsu norādītie atslēgu/vērtību pāri |
Standarta notikumi (atpazīti pēc nosaukuma)
Kixo atpazīst vienpadsmit kanoniskus notikumu nosaukumus. Izsekojiet jebkuru no tiem ar Kixo.track("purchase", {amount: 49.99, currency: "USD"}), un Kixo, saņemot notikumu, tam pievienos standard_kind. Pēc tam čata vaicājumos, segmentos un kampaņās var lietot standard_kind = 'purchase' un aptvert visus aizstājvārdus (purchase / purchased / purchase_completed / order_completed / checkout_completed), tos neuzskaitot atsevišķi.
Šie nosaukumi baro arī AI monetizācijas / konversijas / aktivizācijas heiristiku — Kixo.track("purchase") bez papildu konfigurācijas tiek saprasts kā ieņēmumi; ieņēmumu mērķiem tiek summēta neobligātā amount_cents īpašība (vai amount / value). Ja jūsu sistēma naudas summas glabā mazākajās vienībās, tiek pieņemts arī amount_cents.
| Kanoniskais tips | Aizstājvārdi | Ieteicamās īpašības | Nodrošina |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Iegūšanas piltuve |
activation | activated, user_activated, aha_moment | — | Aktivācijas piltuve, aha brīdis |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Ieņēmumi / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, kohortu noturēšana |
subscribe_renewed | subscription_renewed | plan, amount | Periodiskie ieņēmumi |
trial_start | trial_started, free_trial_started | plan, days | Izmēģinājuma–konversijas piltuve |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Abonementa dzīves cikls, atbirums |
upgrade | plan_upgraded | from_plan, to_plan | Paplašināšanās ieņēmumi |
downgrade | plan_downgraded | from_plan, to_plan | Ieņēmumu samazinājums |
share | shared, content_shared | channel | Viralitātes koeficients |
invite | invited, invite_sent, referral_sent | — | K koeficients |
Nosaukumi tiek salīdzināti bez reģistra jutības. Aizstājvārdi, kas NAV sarakstā (piemēram, bought, customer_paid), tiek apzināti noraidīti — izvēlieties vienu kanonisko formu, lai taksonomija visās komandās paliktu stabila.
Lietotāju, nevis notikumu marķēšana. Ja lietotājam vēlaties pastāvīgu "has purchased" karogu, nevis tikai signālu konkrētam notikumam, izsauciet Kixo.setUserProperty("subscribe", true) — skatiet katra SDK sadaļu "Tag a user for segmentation" (Web / iOS / Android).
Notikuma struktūra
Katrs uz Kixo nosūtītais notikums atbilst šai struktūrai:
- event_type — notikuma saime, piemēram, iepriekš parādītie tipi
- event_name — aprakstošs notikuma nosaukums
- device_id — unikāls ierīces identifikators
- session_id — grupē notikumus vienas sesijas ietvaros
- laika zīmogs — ISO 8601 laikspiedols
- īpašības — JSON objekts ar papildu datiem