Referência de eventos
A Kixo recolhe automaticamente os eventos comuns abaixo; o conjunto exato e o formato enviado variam consoante a plataforma. Todos os eventos incluem os campos padrão: device_id, session_id, timestamp e properties.
Eventos recolhidos automaticamente
| Tipo de evento | Nome do evento | Plataforma | Propriedades |
|---|---|---|---|
screen_view | Nome do ecrã | iOS, Android | screen_name, screen_class |
screen_visit | Nome do ecrã resolvido | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, metadados do acionador; iOS também inclui tap_count e scroll_count |
page_view | page_view | Web | url, path, title, referrer |
tap | Etiqueta do 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 do ciclo de vida específico da plataforma |
session_end | session_end | Web, iOS, Android | session_id; a Web inclui duration_ms quando o fim é observável |
scroll_depth | scroll_25 … scroll_100 | Web | profundidade (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 ou unhandled_rejection | Web | message, stack, type |
crash | Tipo de falha | iOS, Android | message, stack, exception ou contexto do sinal |
network | network_request (Web); etiqueta agregada ou de encaminhamento (iOS) | Consentimento na Web, consentimento no iOS | Rota sanitizada, família de método/código de estado, duração e resultado |
performance | Nome da 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 da notificação push | iOS; Android/Web quando integrados | push_id, kixo_campaign_id, app_state, content_hash |
push_open | ID da notificação push | Todos (integração na app anfitriã necessária em Android/Web) | push_id, kixo_campaign_id, time_to_open_ms, interaction_type |
push_silent | ID da notificação push | iOS, Android | push_id, kixo_campaign_id, content_hash |
push_dismissed | ID da notificação push | iOS; Android/Web com integração na aplicação anfitriã | push_id, kixo_campaign_id, interaction_type |
push_action | ID da notificação push | iOS; Android com integração na app anfitriã | push_id, kixo_campaign_id, action_id |
custom | O nome do seu evento | Todos | Quaisquer pares chave-valor que fornecer |
Eventos padrão (reconhecidos pelo nome)
A Kixo reconhece onze nomes canónicos de eventos. Se registar qualquer um deles através de Kixo.track("purchase", {amount: 49.99, currency: "USD"}), a Kixo atribui standard_kind ao evento no momento da ingestão. Depois, as consultas no Chat, os segmentos e as campanhas podem usar standard_kind = 'purchase' e abranger todos os aliases (purchase / purchased / purchase_completed / order_completed / checkout_completed) sem ter de os listar manualmente.
Estes nomes também alimentam as heurísticas de monetização / conversão / ativação da AI — Kixo.track("purchase") é interpretado como receita sem qualquer configuração; a propriedade opcional amount_cents (ou amount / value) é somada nos objetivos de receita. Se o seu sistema guardar valores monetários em unidades mínimas, amount_cents também é aceite.
| Tipo canónico | Pseudónimos | Propriedades recomendadas | Capacidades |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Funil de aquisição |
activation | activated, user_activated, aha_moment | — | Funil de ativação, momento aha |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Receita / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, retenção por coorte |
subscribe_renewed | subscription_renewed | plan, amount | Receita recorrente |
trial_start | trial_started, free_trial_started | plan, days | Funil de conversão de trial |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Ciclo de vida da subscrição, churn |
upgrade | plan_upgraded | from_plan, to_plan | Receita de expansão |
downgrade | plan_downgraded | from_plan, to_plan | Compressão de receita |
share | shared, content_shared | channel | Coeficiente de viralidade |
invite | invited, invite_sent, referral_sent | — | Fator K |
Os nomes são comparados sem distinguir maiúsculas de minúsculas. Os aliases que NÃO constam da lista (por exemplo, bought, customer_paid) são rejeitados de propósito — use uma forma canónica para manter a taxonomia estável entre equipas.
Marcar utilizadores em vez de eventos. Se quiser um sinalizador persistente de «has purchased» no utilizador (e não apenas um sinal por evento), chame Kixo.setUserProperty("subscribe", true) — veja a secção «Marcar um utilizador para segmentação» de cada SDK (Web / iOS / Android).
Estrutura do evento
Todos os eventos enviados para a Kixo seguem esta estrutura:
- event_type — a família do evento, como os tipos mostrados acima
- event_name — nome descritivo do evento
- device_id — identificador único do dispositivo
- session_id — agrupa eventos dentro de uma sessão
- timestamp — carimbo temporal ISO 8601
- propriedades — objeto JSON com dados adicionais