Αναφορά συμβάντων
Το Kixo συλλέγει αυτόματα τα συνήθη συμβάντα που ακολουθούν· το ακριβές σύνολο και η μορφή μεταφοράς διαφέρουν ανά πλατφόρμα. Όλα τα συμβάντα περιλαμβάνουν τα βασικά πεδία: device_id, session_id, timestamp και properties.
Αυτόματα συλλεγμένα events
| Τύπος event | Όνομα event | Πλατφόρμα | Ιδιότητες |
|---|---|---|---|
screen_view | Όνομα οθόνης | iOS, Android | screen_name, screen_class |
screen_visit | Τελικό όνομα οθόνης | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, μεταδεδομένα ενεργοποίησης· το iOS περιλαμβάνει επίσης tap_count και scroll_count |
page_view | page_view | Web | url, path, title, referrer |
tap | Ετικέτα στοιχείου | 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· συμφραζόμενα κύκλου ζωής ανά πλατφόρμα |
session_end | session_end | Web, iOS, Android | session_id· το Web περιλαμβάνει duration_ms όταν το τέλος είναι παρατηρήσιμο |
scroll_depth | scroll_25 … scroll_100 | Web | depth (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 ή unhandled_rejection | Web | μήνυμα, στοίβα κλήσεων, τύπος |
crash | Τύπος crash | iOS, Android | μήνυμα, στοίβα κλήσεων, εξαίρεση ή συμφραζόμενα σήματος |
network | network_request (Web)· ετικέτα συνόλου ή διαδρομής (iOS) | Συναίνεση Web, συναίνεση iOS | Καθαρισμένη διαδρομή, οικογένεια μεθόδου/κατάστασης, διάρκεια και αποτέλεσμα |
performance | Όνομα μετρικής (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 | iOS· Android/Web όταν έχει γίνει ενσωμάτωση | push_id, kixo_campaign_id, app_state, content_hash |
push_open | Αναγνωριστικό push | Όλα (απαιτείται ενσωμάτωση στην host εφαρμογή σε Android/Web) | push_id, kixo_campaign_id, time_to_open_ms, interaction_type |
push_silent | Αναγνωριστικό push | iOS, Android | push_id, kixo_campaign_id, content_hash |
push_dismissed | Αναγνωριστικό push | iOS· Android/Web με ενσωμάτωση στην εφαρμογή host | push_id, kixo_campaign_id, interaction_type |
push_action | Αναγνωριστικό push | iOS· Android με ενσωμάτωση στην host εφαρμογή | push_id, kixo_campaign_id, action_id |
custom | Το όνομα του συμβάντος σας | Όλα | Οποιαδήποτε ζεύγη κλειδιού/τιμής παρέχετε |
Τυπικά συμβάντα (αναγνωρίζονται από το όνομα)
Το Kixo αναγνωρίζει έντεκα κανονικά ονόματα συμβάντων. Αν καταγράψετε οποιοδήποτε από αυτά μέσω του Kixo.track("purchase", {amount: 49.99, currency: "USD"}), το Kixo προσθέτει στο συμβάν το standard_kind κατά την εισαγωγή. Έπειτα, ερωτήματα στο Chat, τμήματα και καμπάνιες μπορούν να χρησιμοποιούν το standard_kind = 'purchase' και να καλύπτουν όλα τα ψευδώνυμα (purchase / purchased / purchase_completed / order_completed / checkout_completed) χωρίς να τα γράφετε ένα προς ένα.
Αυτά τα ονόματα τροφοδοτούν επίσης τις ευρετικές monetization / conversion / activation του AI — το Kixo.track("purchase") αναγνωρίζεται ως έσοδο χωρίς καμία ρύθμιση· η προαιρετική ιδιότητα amount_cents (ή amount / value) αθροίζεται για στόχους εσόδων. Αν το σύστημά σας αποθηκεύει χρηματικά ποσά σε μικρές μονάδες, γίνεται δεκτό και το amount_cents.
| Κανονικό kind | Εναλλακτικά ονόματα | Προτεινόμενες ιδιότητες | Τροφοδοτεί |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Χωνί απόκτησης |
activation | activated, user_activated, aha_moment | — | Χωνί ενεργοποίησης, στιγμή aha |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Έσοδα / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, διατήρηση cohort |
subscribe_renewed | subscription_renewed | plan, amount | Επαναλαμβανόμενα έσοδα |
trial_start | trial_started, free_trial_started | plan, days | Χωνί μετατροπής από trial |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Κύκλος ζωής συνδρομής, churn |
upgrade | plan_upgraded | from_plan, to_plan | Έσοδα επέκτασης |
downgrade | plan_downgraded | from_plan, to_plan | Συμπίεση εσόδων |
share | shared, content_shared | channel | Συντελεστής διάδοσης |
invite | invited, invite_sent, referral_sent | — | Συντελεστής K |
Τα ονόματα αντιστοιχίζονται χωρίς διάκριση πεζών-κεφαλαίων. Ψευδώνυμα που ΔΕΝ βρίσκονται στη λίστα (π.χ. bought, customer_paid) απορρίπτονται σκόπιμα — καταλήξτε σε μία κανονική μορφή ώστε η ταξινομία να παραμένει σταθερή σε όλες τις ομάδες.
Βάζετε ετικέτες στους χρήστες αντί στα συμβάντα. Αν θέλετε μια μόνιμη ένδειξη «has purchased» στον χρήστη (όχι μόνο σήμα ανά event), καλέστε το Kixo.setUserProperty("subscribe", true) — δείτε την ενότητα «Tag a user for segmentation» σε κάθε SDK (Web / iOS / Android).
Δομή event
Κάθε event που αποστέλλεται στο Kixo ακολουθεί αυτή τη δομή:
- event_type — η οικογένεια του event, όπως οι τύποι που φαίνονται παραπάνω
- event_name — περιγραφικό όνομα του event
- device_id — μοναδικό αναγνωριστικό συσκευής
- session_id — ομαδοποιεί events μέσα σε μια συνεδρία
- χρονική σήμανση — χρονική σήμανση ISO 8601
- ιδιότητες — αντικείμενο JSON με πρόσθετα δεδομένα