Riferimento degli eventi
Kixo raccoglie automaticamente gli eventi comuni qui sotto; l'insieme preciso e il formato trasmesso variano in base alla piattaforma. Tutti gli eventi includono i campi standard device_id, session_id, timestamp e properties.
Eventi raccolti automaticamente
| Tipo di evento | Nome evento | Piattaforma | Proprietà |
|---|---|---|---|
screen_view | Nome schermata | iOS, Android | screen_name, screen_class |
screen_visit | Nome schermata risolto | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, metadati del trigger; su iOS include anche tap_count e scroll_count |
page_view | page_view | Web | url, path, title, referrer |
tap | Etichetta dell’elemento | 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; contesto del ciclo di vita specifico della piattaforma |
session_end | session_end | Web, iOS, Android | session_id; sul Web include duration_ms quando è possibile osservare la fine |
scroll_depth | scroll_25 … scroll_100 | Web | profondità (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 o unhandled_rejection | Web | messaggio, stack, tipo |
crash | Tipo di crash | iOS, Android | messaggio, stack, contesto di eccezione o segnale |
network | network_request (Web); etichetta di aggregazione o route (iOS) | Opt-in Web, opt-in iOS | Percorso sanitizzato, famiglia di metodo/stato, durata ed esito |
performance | Nome metrica (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 push | iOS; Android/Web se integrati | push_id, kixo_campaign_id, app_state, content_hash |
push_open | ID push | Tutti (su Android/Web è richiesta l’integrazione host) | push_id, kixo_campaign_id, time_to_open_ms, interaction_type |
push_silent | ID push | iOS, Android | push_id, kixo_campaign_id, content_hash |
push_dismissed | ID push | iOS; Android/Web con integrazione nell'host | push_id, kixo_campaign_id, interaction_type |
push_action | ID push | iOS; Android con integrazione host | push_id, kixo_campaign_id, action_id |
custom | Nome del tuo evento | Tutti | Qualsiasi coppia chiave-valore fornita |
Eventi standard (riconosciuti dal nome)
Kixo riconosce undici nomi evento canonici. Se ne tracci uno tramite Kixo.track("purchase", {amount: 49.99, currency: "USD"}), Kixo aggiunge all'evento un standard_kind in fase di ingestione. Così query in chat, segmenti e campagne possono usare standard_kind = 'purchase' e includere tutti gli alias (purchase / purchased / purchase_completed / order_completed / checkout_completed) senza doverli elencare a mano.
Questi nomi alimentano anche le euristiche di monetizzazione, conversione e attivazione dell'AI: Kixo.track("purchase") viene interpretato come ricavo senza configurazione; la proprietà facoltativa amount_cents (oppure amount / value) viene sommata negli obiettivi di ricavo. Se nel tuo sistema gli importi sono salvati in unità minime, viene accettato anche amount_cents.
| Tipo canonico | Alias | Proprietà consigliate | Supporta |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Funnel di acquisizione |
activation | activated, user_activated, aha_moment | — | Funnel di attivazione, momento chiave |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Ricavi / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, retention per coorte |
subscribe_renewed | subscription_renewed | plan, amount | Ricavi ricorrenti |
trial_start | trial_started, free_trial_started | plan, days | Funnel di conversione da prova ad abbonamento |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Ciclo di vita dell'abbonamento, churn |
upgrade | plan_upgraded | from_plan, to_plan | Ricavi da espansione |
downgrade | plan_downgraded | from_plan, to_plan | Compressione dei ricavi |
share | shared, content_shared | channel | Coefficiente di viralità |
invite | invited, invite_sent, referral_sent | — | K-factor |
I nomi vengono confrontati senza distinzione tra maiuscole e minuscole. Gli alias NON presenti nell'elenco (per esempio bought, customer_paid) vengono rifiutati di proposito: convergi su una forma canonica, così la tassonomia resta stabile tra i team.
Applicare tag agli utenti invece che agli eventi. Se vuoi un flag persistente "has purchased" associato all’utente, e non solo un segnale sul singolo evento, chiama Kixo.setUserProperty("subscribe", true); vedi la sezione "Taggare un utente per la segmentazione" di ciascun SDK (Web / iOS / Android).
Struttura dell’evento
Ogni evento inviato a Kixo segue questa struttura:
- event_type — famiglia dell’evento, ad esempio uno dei tipi mostrati sopra
- event_name — nome descrittivo dell’evento
- device_id — identificatore univoco del dispositivo
- session_id — raggruppa gli eventi all’interno della sessione
- timestamp — timestamp in formato ISO 8601
- proprietà — oggetto JSON con dati aggiuntivi