Referenca e eventeve
Kixo i mbledh automatikisht eventet e zakonshme më poshtë; grupi i saktë dhe formati në wire ndryshojnë sipas platformës. Të gjitha eventet përfshijnë fushat standarde: device_id, session_id, timestamp dhe properties.
Ngjarje të mbledhura automatikisht
| Lloji i ngjarjes | Emri i ngjarjes | Platforma | Veti |
|---|---|---|---|
screen_view | Emri i ekranit | iOS, Android | screen_name, screen_class |
screen_visit | Emri i zgjidhur i ekranit | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, metadata e trigger-it; iOS përfshin gjithashtu tap_count dhe scroll_count |
page_view | page_view | Web | url, path, title, referrer |
tap | Etiketa e elementit | 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; kontekst lifecycle specifik për platformën |
session_end | session_end | Web, iOS, Android | session_id; Web përfshin duration_ms kur fundi mund të vëzhgohet |
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 ose unhandled_rejection | Web | mesazhi, stack, lloji |
crash | Lloji i crash-it | iOS, Android | mesazhi, stack, konteksti i exception ose i signal |
network | network_request (Web); etiketë agregimi ose route (iOS) | Pranim Web, pranim në iOS | Rruga e sanitizuar, familja e method/status, kohëzgjatja dhe rezultati |
performance | Emri i metrikës (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 e push-it | iOS; Android/Web kur integrohen | push_id, kixo_campaign_id, app_state, content_hash |
push_open | ID e push-it | Të gjitha (në Android/Web kërkohet integrim në host) | push_id, kixo_campaign_id, time_to_open_ms, interaction_type |
push_silent | ID e push-it | iOS, Android | push_id, kixo_campaign_id, content_hash |
push_dismissed | ID e push-it | iOS; Android/Web me integrim në host | push_id, kixo_campaign_id, interaction_type |
push_action | ID e push-it | iOS; Android me integrim në host | push_id, kixo_campaign_id, action_id |
custom | Emri i eventit tuaj | Të gjitha | Çdo çift çelës-vlerë që jepni |
Evente standarde (të njohura sipas emrit)
Kixo njeh njëmbëdhjetë emra kanonikë eventesh. Gjurmo cilindo prej tyre me Kixo.track("purchase", {amount: 49.99, currency: "USD"}) dhe Kixo i vendos eventit një standard_kind gjatë ingestimit. Pastaj pyetjet në chat, segmentet dhe fushatat mund të përdorin standard_kind = 'purchase' dhe të kapin të gjitha aliaset (purchase / purchased / purchase_completed / order_completed / checkout_completed) pa i renditur manualisht.
Këta emra ushqejnë edhe heuristikat e AI për monetizim / konvertim / aktivizim — Kixo.track("purchase") kuptohet si të ardhurë pa asnjë konfigurim; vetia opsionale amount_cents (ose amount / value) mblidhet për objektivat e të ardhurave. Nëse sistemi juaj i ruan vlerat monetare në njësi të vogla, pranohet edhe amount_cents.
| Lloji kanonik | Alias-et | Veti të rekomanduara | Mundëson |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Hinka e përftimit |
activation | activated, user_activated, aha_moment | — | Hinka e aktivizimit, aha-moment |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Të ardhura / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, mbajtja sipas kohortës |
subscribe_renewed | subscription_renewed | plan, amount | Të ardhura të përsëritura |
trial_start | trial_started, free_trial_started | plan, days | Hinka e konvertimit nga trial |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Cikli i abonimit, churn |
upgrade | plan_upgraded | from_plan, to_plan | Të ardhura nga zgjerimi |
downgrade | plan_downgraded | from_plan, to_plan | Kompresimi i të ardhurave |
share | shared, content_shared | channel | Koeficienti i viralitetit |
invite | invited, invite_sent, referral_sent | — | Faktori K |
Emrat përputhen pa dallim mes shkronjave të mëdha dhe të vogla. Aliaset që NUK janë në listë (p.sh. bought, customer_paid) refuzohen qëllimisht — përdorni një formë kanonike që taksonomia të mbetet e qëndrueshme në të gjitha ekipet.
Etiketimi i përdoruesve në vend të eventeve. Nëse doni një flamur të qëndrueshëm “has purchased” te përdoruesi (jo vetëm një sinjal për ngjarje), thërrisni Kixo.setUserProperty("subscribe", true) — shihni seksionin “Tag a user for segmentation” te çdo SDK (Web / iOS / Android).
Struktura e ngjarjes
Çdo ngjarje e dërguar te Kixo ndjek këtë strukturë:
- event_type — familja e ngjarjes, si p.sh. llojet e paraqitura më sipër
- event_name — një emër përshkrues për ngjarjen
- device_id — identifikues unik i pajisjes
- session_id — grupon ngjarjet brenda një sesioni
- vulë kohore — timestamp në format ISO 8601
- veti — objekt JSON me të dhëna shtesë