Event-Referenz
Kixo erfasst die unten aufgeführten Standard-Events automatisch; welche genau und in welchem Format sie übertragen werden, hängt von der Plattform ab. Alle Events enthalten die Standardfelder device_id, session_id, timestamp und properties.
Automatisch erfasste Events
| Event-Typ | Event-Name | Plattform | Eigenschaften |
|---|---|---|---|
screen_view | Bildschirmname | iOS, Android | screen_name, screen_class |
screen_visit | Ermittelter Bildschirmname | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, Trigger-Metadaten; iOS enthält zusätzlich tap_count und scroll_count |
page_view | page_view | Web | url, path, title, referrer |
tap | Elementbezeichnung | 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; plattformspezifischer Lifecycle-Kontext |
session_end | session_end | Web, iOS, Android | session_id; im Web zusätzlich duration_ms, wenn das Sitzungsende beobachtbar ist |
scroll_depth | scroll_25 … scroll_100 | Web | Tiefe (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 oder unhandled_rejection | Web | message, stack, type |
crash | Absturztyp | iOS, Android | message, stack, Ausnahme- oder Signal-Kontext |
network | network_request (Web); Aggregat- oder Routenbezeichnung (iOS) | Web-Opt-in, iOS-Opt-in | Bereinigte Route, Methoden-/Statusklasse, Dauer und Ergebnis |
performance | Metrikname (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 | Push-ID | iOS; Android/Web bei aktiver Integration | push_id, kixo_campaign_id, app_state, content_hash |
push_open | Push-ID | Alle (auf Android/Web nur mit Host-Integration) | 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 mit Host-Integration | push_id, kixo_campaign_id, interaction_type |
push_action | Push-ID | iOS; Android mit Host-Integration | push_id, kixo_campaign_id, action_id |
custom | Ihr Event-Name | Alle | Beliebige Schlüssel-Wert-Paare, die du mitgibst |
Standard-Events (anhand des Namens erkannt)
Kixo erkennt elf kanonische Event-Namen. Wenn Sie einen davon über Kixo.track("purchase", {amount: 49.99, currency: "USD"}) tracken, versieht Kixo das Event bei der Ingestion mit standard_kind. Abfragen in Chat, Segmente und Kampagnen können dann standard_kind = 'purchase' verwenden und erfassen damit alle Aliasse (purchase / purchased / purchase_completed / order_completed / checkout_completed), ohne sie einzeln anzugeben.
Diese Namen fließen auch in die Monetarisierungs-, Conversion- und Aktivierungsheuristiken der AI ein — Kixo.track("purchase") wird ohne Konfiguration als Umsatz verstanden; für Umsatzziele wird die optionale Property amount_cents (oder amount / value) aufsummiert. Wenn Ihr System Geldbeträge in Untereinheiten speichert, wird auch amount_cents akzeptiert.
| Kanonischer Typ | Aliasse | Empfohlene Properties | Grundlage für |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Akquise-Funnel |
activation | activated, user_activated, aha_moment | — | Aktivierungs-Funnel, Aha-Moment |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Umsatz / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, Kohortenbindung |
subscribe_renewed | subscription_renewed | plan, amount | Wiederkehrender Umsatz |
trial_start | trial_started, free_trial_started | plan, days | Trial-Conversion-Funnel |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Abo-Lebenszyklus, Abwanderung |
upgrade | plan_upgraded | from_plan, to_plan | Zusatzumsatz |
downgrade | plan_downgraded | from_plan, to_plan | Umsatzrückgang |
share | shared, content_shared | channel | Viralitätskoeffizient |
invite | invited, invite_sent, referral_sent | — | K-Faktor |
Namen werden ohne Beachtung der Groß- und Kleinschreibung abgeglichen. Aliasse, die NICHT in der Liste stehen (z. B. bought, customer_paid), werden bewusst abgelehnt — einigen Sie sich auf eine kanonische Form, damit die Taxonomie teamübergreifend stabil bleibt.
Nutzer statt Events taggen. Wenn du beim Nutzer ein dauerhaftes „has purchased“-Flag setzen willst — und nicht nur ein Signal pro Event —, rufe Kixo.setUserProperty("subscribe", true) auf. Sieh dazu in den Abschnitten „Nutzer für die Segmentierung taggen“ der jeweiligen SDKs nach (Web / iOS / Android).
Event-Struktur
Jedes an Kixo gesendete Event hat diese Struktur:
- event_type — die Event-Familie, zum Beispiel die oben gezeigten Typen
- event_name — ein aussagekräftiger Name für das Event
- device_id — eindeutige Gerätekennung
- session_id — gruppiert Events innerhalb einer Sitzung
- Zeitstempel — ISO 8601-Zeitstempel
- Eigenschaften — JSON-Objekt mit zusätzlichen Daten