Referencia de eventos
Kixo recopila automáticamente los eventos comunes que se indican abajo; el conjunto exacto y el formato de envío varían según la plataforma. Todos los eventos incluyen los campos estándar: device_id, session_id, timestamp y properties.
Eventos recopilados automáticamente
| Tipo de evento | Nombre del evento | Plataforma | Propiedades |
|---|---|---|---|
screen_view | Nombre de pantalla | iOS, Android | screen_name, screen_class |
screen_visit | Nombre de pantalla resuelto | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, metadatos del desencadenante; iOS también incluye tap_count y scroll_count |
page_view | page_view | Web | url, path, title, referrer |
tap | Etiqueta del 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; contexto del ciclo de vida específico de la plataforma |
session_end | session_end | Web, iOS, Android | session_id; Web incluye duration_ms cuando se puede observar el final |
scroll_depth | scroll_25 … scroll_100 | Web | profundidad (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 | mensaje, traza, tipo |
crash | Tipo de error | iOS, Android | mensaje, traza o contexto de excepción o señal |
network | network_request (Web); etiqueta agregada o de ruta (iOS) | Inclusión voluntaria en Web, inclusión voluntaria en iOS | Ruta saneada, familia de método/estado, duración y resultado |
performance | Nombre de la métrica (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 de push | iOS; Android/Web si hay integración | push_id, kixo_campaign_id, app_state, content_hash |
push_open | ID de push | Todos (en Android/Web requiere integración en la aplicación anfitriona) | push_id, kixo_campaign_id, time_to_open_ms, interaction_type |
push_silent | ID de push | iOS, Android | push_id, kixo_campaign_id, content_hash |
push_dismissed | ID de push | iOS; Android/Web con integración en el host | push_id, kixo_campaign_id, interaction_type |
push_action | ID de push | iOS; Android con integración en la aplicación anfitriona | push_id, kixo_campaign_id, action_id |
custom | Nombre de tu evento | Todos | Cualquier par clave-valor que envíes |
Eventos estándar (reconocidos por nombre)
Kixo reconoce once nombres de evento canónicos. Si registras cualquiera de ellos mediante Kixo.track("purchase", {amount: 49.99, currency: "USD"}), Kixo añade standard_kind al evento al ingerirlo. Después, las consultas de Chat, los segmentos y las campañas pueden usar standard_kind = 'purchase' y abarcar todos los alias (purchase / purchased / purchase_completed / order_completed / checkout_completed) sin tener que enumerarlos a mano.
Estos nombres también alimentan las heurísticas de monetización, conversión y activación de la AI: Kixo.track("purchase") se interpreta como ingresos sin configuración; la propiedad opcional amount_cents (o amount / value) se suma para los objetivos de ingresos. Si tu sistema guarda importes en unidades menores, amount_cents también se admite.
| Tipo canónico | Alias | Propiedades recomendadas | Impulsa |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Embudo de adquisición |
activation | activated, user_activated, aha_moment | — | Embudo de activación y momento «ajá» |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Ingresos / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, retención por cohortes |
subscribe_renewed | subscription_renewed | plan, amount | Ingresos recurrentes |
trial_start | trial_started, free_trial_started | plan, days | Embudo de conversión de prueba |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Ciclo de vida de la suscripción, abandono |
upgrade | plan_upgraded | from_plan, to_plan | Ingresos por expansión |
downgrade | plan_downgraded | from_plan, to_plan | Compresión de ingresos |
share | shared, content_shared | channel | Coeficiente de viralidad |
invite | invited, invite_sent, referral_sent | — | Factor K |
Los nombres se comparan sin distinguir mayúsculas de minúsculas. Los alias que NO están en la lista (por ejemplo, bought, customer_paid) se rechazan a propósito: converged en una forma canónica para que la taxonomía se mantenga estable entre equipos.
Etiquetar usuarios en vez de eventos. Si quieres una marca persistente de «ha comprado» en el usuario —no solo una señal por evento— llama a Kixo.setUserProperty("subscribe", true). Consulta la sección «Etiquetar a un usuario para segmentación» de cada SDK (Web / iOS / Android).
Estructura del evento
Todos los eventos enviados a Kixo siguen esta estructura:
- event_type: familia del evento, como los tipos mostrados arriba
- event_name: nombre descriptivo del evento
- device_id: identificador único del dispositivo
- session_id: agrupa eventos dentro de una sesión
- marca de tiempo: marca temporal en formato ISO 8601
- propiedades: objeto JSON con datos adicionales