Tagairt d’imeachtaí
Bailíonn Kixo na himeachtaí coitianta thíos go huathoibríoch; braitheann an tacar cruinn agus an fhormáid sreinge ar an ardán. Bíonn na réimsí caighdeánacha seo ar gach imeacht: device_id, session_id, timestamp, agus properties.
Imeachtaí a bhailítear go huathoibríoch
| Cineál an imeachta | Ainm an imeachta | Ardán | Airíonna |
|---|---|---|---|
screen_view | Ainm an scáileáin | iOS, Android | screen_name, screen_class |
screen_visit | Ainm an scáileáin réitithe | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, meiteashonraí truicire; tá tap_count agus scroll_count ar iOS freisin |
page_view | page_view | Web | url, path, title, referrer |
tap | Lipéad eiliminte | 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; comhthéacs saolré atá sonrach don ardán |
session_end | session_end | Web, iOS, Android | session_id; bíonn duration_ms san áireamh ar Web nuair is féidir an deireadh a fheiceáil |
scroll_depth | scroll_25 … scroll_100 | Web | doimhneacht (25, 50, 75, 100), url, cosán |
interaction | rage_click | Web | tag, path, text, click_count, x, y |
interaction | dead_click | Web | tag, path, text, x, y |
error | js_error nó unhandled_rejection | Web | teachtaireacht, stack, cineál |
crash | Cineál tuairteála | iOS, Android | teachtaireacht, stack, eisceacht nó comhthéacs comhartha |
network | network_request (Web); lipéad comhiomlánaithe nó bealaigh (iOS) | Web rogha isteach, iOS rogha isteach | Bealach slánaithe, teaghlach modha/stádais, fad agus toradh |
performance | Ainm an mhéadraigh (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 | Aitheantas brúfhógra | iOS; Android/Web nuair atá sé comhtháite | push_id, kixo_campaign_id, app_state, content_hash |
push_open | Aitheantas brúfhógra | Uile (teastaíonn comhtháthú ón óstach ar Android/Web) | push_id, kixo_campaign_id, time_to_open_ms, interaction_type |
push_silent | Aitheantas brúfhógra | iOS, Android | push_id, kixo_campaign_id, content_hash |
push_dismissed | Aitheantas brúfhógra | iOS; Android/Web le comhtháthú ósta | push_id, kixo_campaign_id, interaction_type |
push_action | Aitheantas brúfhógra | iOS; Android le comhtháthú ón óstach | push_id, kixo_campaign_id, action_id |
custom | Ainm d’imeachta | Uile | Aon phéirí eochair-luacha a sholáthraíonn tú |
Imeachtaí caighdeánacha (aithnítear de réir ainm iad)
Aithníonn Kixo aon ainm imeachta canónach déag. Má rianaíonn tú ceann ar bith díobh trí Kixo.track("purchase", {amount: 49.99, currency: "USD"}), cuireann Kixo standard_kind leis an imeacht nuair a ionghabháiltear é. Ansin is féidir le ceisteanna i gcomhrá, deighleoga agus feachtais standard_kind = 'purchase' a úsáid chun gach ailias (purchase / purchased / purchase_completed / order_completed / checkout_completed) a ghabháil gan iad a liostú de láimh.
Cothaíonn na hainmneacha seo heorastachtaí airgeadaíochta / tiontaithe / gníomhachtaithe an AI freisin — tuigtear Kixo.track("purchase") mar ioncam gan aon chumraíocht; suimítear an airí roghnach amount_cents (nó amount / value) do spriocanna ioncaim. Má stórálann do chóras airgead in aonaid bheaga, glactar le amount_cents freisin.
| Cineál canónach | Ailiasanna | Airíonna molta | Cumhachtaí |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Tonnadóir fála |
activation | activated, user_activated, aha_moment | — | Tonnadóir gníomhachtaithe, nóiméad “aha” |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Ioncam / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, coinneáil cohóirt |
subscribe_renewed | subscription_renewed | plan, amount | Ioncam athfhillteach |
trial_start | trial_started, free_trial_started | plan, days | Tonnadóir tiontaithe trialach |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Saolré síntiúis, imeacht custaiméirí |
upgrade | plan_upgraded | from_plan, to_plan | Ioncam fairsingithe |
downgrade | plan_downgraded | from_plan, to_plan | Comhbhrú ioncaim |
share | shared, content_shared | channel | Comhéifeacht víreasachta |
invite | invited, invite_sent, referral_sent | — | K-fachtóir |
Meaitseáiltear ainmneacha gan aird ar chás. Diúltaítear d’aon ghnó d’ailiasanna NACH bhfuil sa liosta (m.sh. bought, customer_paid) — cloí le foirm chanónach amháin ionas go bhfanfaidh an tacsanomaíocht seasmhach ar fud foirne.
Clibeáil úsáideoirí in ionad imeachtaí. Más mian leat bratach bhuan “ceannaithe cheana” a bheith ar an úsáideoir (seachas comhartha in aghaidh an imeachta amháin), glaoigh ar Kixo.setUserProperty("subscribe", true) — féach an rannán “Clibeáil úsáideoir le haghaidh deighilte” i ngach SDK (Web / iOS / Android).
Struchtúr an imeachta
Leanann gach imeacht a sheoltar chuig Kixo an struchtúr seo:
- event_type — clann an imeachta, mar shampla na cineálacha a thaispeántar thuas
- event_name — ainm tuairisciúil ar an imeacht
- device_id — aitheantóir uathúil gléis
- session_id — grúpálann sé imeachtaí laistigh de sheisiún
- stampa ama — stampa ama ISO 8601
- airíonna — oibiacht JSON le sonraí breise