Įvykių žinynas
Kixo automatiškai renka toliau nurodytus dažniausius įvykius; tikslus rinkinys ir perduodamų duomenų struktūra priklauso nuo platformos. Visi įvykiai turi standartinius laukus: device_id, session_id, timestamp ir properties.
Automatiškai renkami įvykiai
| Įvykio tipas | Įvykio pavadinimas | Platforma | Savybės |
|---|---|---|---|
screen_view | Ekrano pavadinimas | iOS, Android | screen_name, screen_class |
screen_visit | Nustatytas ekrano pavadinimas | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, aktyvavimo metaduomenys; iOS taip pat pateikia tap_count ir scroll_count |
page_view | page_view | Žiniatinklis | url, path, title, referrer |
tap | Elemento žyma | iOS, Android | target_class, target_text, screen_name |
click | click | Žiniatinklis | tag, path, text, href, x, y |
session_start | session_start | Web, iOS, Android | session_id; platformai būdingas gyvavimo ciklo kontekstas |
session_end | session_end | Web, iOS, Android | session_id; Web taip pat pateikia duration_ms, kai galima nustatyti pabaigą |
scroll_depth | scroll_25 … scroll_100 | Žiniatinklis | gylis (25, 50, 75, 100), url, path |
interaction | rage_click | Žiniatinklis | tag, path, text, click_count, x, y |
interaction | dead_click | Žiniatinklis | tag, path, text, x, y |
error | js_error arba unhandled_rejection | Žiniatinklis | pranešimas, stekas, tipas |
crash | Strigties tipas | iOS, Android | pranešimas, stekas, išimtis arba signalo kontekstas |
network | network_request (Web); suvestinės arba maršruto žyma (iOS) | Web sutikimas, iOS sutikimas | Išvalytas maršrutas, metodo / būsenos kodo grupė, trukmė ir rezultatas |
performance | Metrikos pavadinimas (LCP, FCP, CLS, INP, TTFB) | Žiniatinklis | value, rating, id, delta |
heatmap_click | heatmap_click | Žiniatinklis | x, y, viewport_width, viewport_height, page_url, element_selector |
push_received | Push ID | iOS; Android/Web, jei integruota | push_id, kixo_campaign_id, app_state, content_hash |
push_open | Push ID | Visi (Android/Web reikalinga host integracija) | 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 su integracija į host programą | push_id, kixo_campaign_id, interaction_type |
push_action | Push ID | iOS; Android su host integracija | push_id, kixo_campaign_id, action_id |
custom | Jūsų įvykio pavadinimas | Visi | Bet kurios jūsų pateiktos rakto ir reikšmės poros |
Standartiniai įvykiai (atpažįstami pagal pavadinimą)
Kixo atpažįsta vienuolika kanoninių įvykių pavadinimų. Jei bet kurį iš jų sekate per Kixo.track("purchase", {amount: 49.99, currency: "USD"}), Kixo gavimo metu įvykiui priskiria standard_kind. Tada Chat užklausose, segmentuose ir kampanijose galite naudoti standard_kind = 'purchase' ir apimti visus sinonimus (purchase / purchased / purchase_completed / order_completed / checkout_completed) jų neišvardydami ranka.
Šie pavadinimai taip pat naudojami AI monetizavimo, konversijos ir aktyvinimo euristikoms — Kixo.track("purchase") be jokios papildomos konfigūracijos suprantamas kaip pajamos; pajamų tikslams sumuojama pasirenkama savybė amount_cents (arba amount / value). Jei jūsų sistema pinigų sumas saugo smulkiaisiais vienetais, tinka ir amount_cents.
| Pagrindinis tipas | Alternatyvūs pavadinimai | Rekomenduojamos savybės | Galimybės |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Įsigijimo piltuvėlis |
activation | activated, user_activated, aha_moment | — | Aktyvacijos piltuvėlis, aha momentas |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Pajamos / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, kohortų išlaikymas |
subscribe_renewed | subscription_renewed | plan, amount | Pasikartojančios pajamos |
trial_start | trial_started, free_trial_started | plan, days | Bandomojo laikotarpio konversijos piltuvėlis |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Prenumeratos gyvavimo ciklas, atsisakymas |
upgrade | plan_upgraded | from_plan, to_plan | Plėtros pajamos |
downgrade | plan_downgraded | from_plan, to_plan | Pajamų mažėjimas |
share | shared, content_shared | channel | Viralumo koeficientas |
invite | invited, invite_sent, referral_sent | — | K koeficientas |
Pavadinimai lyginami neskiriant didžiųjų ir mažųjų raidžių. Sinonimai, kurių sąraše nėra (pvz., bought, customer_paid), sąmoningai atmetami — laikykitės vienos kanoninės formos, kad taksonomija tarp komandų išliktų stabili.
Žymėti naudotojus, o ne įvykius. Jei norite naudotojui išsaugoti nuolatinę „has purchased“ žymą, o ne tik vieno įvykio signalą, kvieskite Kixo.setUserProperty("subscribe", true) — žr. kiekvieno SDK skiltį „Pažymėkite naudotoją segmentavimui“ (Žiniatinklis / iOS / Android).
Įvykio struktūra
Kiekvienas į Kixo siunčiamas įvykis turi tokią struktūrą:
- event_type — įvykio šeima, pavyzdžiui, aukščiau pateikti tipai
- event_name — aiškus įvykio pavadinimas
- device_id — unikalus įrenginio identifikatorius
- session_id — grupuoja įvykius sesijos viduje
- laiko žyma — ISO 8601 laiko žyma
- savybės — JSON objektas su papildomais duomenimis