Μετάβαση στην τεκμηρίωση

Αναφορά συμβάντων

Το Kixo συλλέγει αυτόματα τα συνήθη συμβάντα που ακολουθούν· το ακριβές σύνολο και η μορφή μεταφοράς διαφέρουν ανά πλατφόρμα. Όλα τα συμβάντα περιλαμβάνουν τα βασικά πεδία: device_id, session_id, timestamp και properties.

Αυτόματα συλλεγμένα events

Τύπος eventΌνομα eventΠλατφόρμαΙδιότητες
screen_viewΌνομα οθόνηςiOS, Androidscreen_name, screen_class
screen_visitΤελικό όνομα οθόνηςiOS, Androidscreen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, μεταδεδομένα ενεργοποίησης· το iOS περιλαμβάνει επίσης tap_count και scroll_count
page_viewpage_viewWeburl, path, title, referrer
tapΕτικέτα στοιχείουiOS, Androidtarget_class, target_text, screen_name
clickclickWebtag, path, text, href, x, y
session_startsession_startWeb, iOS, Androidsession_id· συμφραζόμενα κύκλου ζωής ανά πλατφόρμα
session_endsession_endWeb, iOS, Androidsession_id· το Web περιλαμβάνει duration_ms όταν το τέλος είναι παρατηρήσιμο
scroll_depthscroll_25scroll_100Webdepth (25, 50, 75, 100), url, path
interactionrage_clickWebtag, path, text, click_count, x, y
interactiondead_clickWebtag, path, text, x, y
errorjs_error ή unhandled_rejectionWebμήνυμα, στοίβα κλήσεων, τύπος
crashΤύπος crashiOS, Androidμήνυμα, στοίβα κλήσεων, εξαίρεση ή συμφραζόμενα σήματος
networknetwork_request (Web)· ετικέτα συνόλου ή διαδρομής (iOS)Συναίνεση Web, συναίνεση iOSΚαθαρισμένη διαδρομή, οικογένεια μεθόδου/κατάστασης, διάρκεια και αποτέλεσμα
performanceΌνομα μετρικής (LCP, FCP, CLS, INP, TTFB)Webvalue, rating, id, delta
heatmap_clickheatmap_clickWebx, y, viewport_width, viewport_height, page_url, element_selector
push_receivedΑναγνωριστικό pushiOS· 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Αναγνωριστικό pushiOS, Androidpush_id, kixo_campaign_id, content_hash
push_dismissedΑναγνωριστικό pushiOS· Android/Web με ενσωμάτωση στην εφαρμογή hostpush_id, kixo_campaign_id, interaction_type
push_actionΑναγνωριστικό pushiOS· 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_centsamount / value) αθροίζεται για στόχους εσόδων. Αν το σύστημά σας αποθηκεύει χρηματικά ποσά σε μικρές μονάδες, γίνεται δεκτό και το amount_cents.

Κανονικό kindΕναλλακτικά ονόματαΠροτεινόμενες ιδιότητεςΤροφοδοτεί
signupsign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registeredΧωνί απόκτησης
activationactivated, user_activated, aha_momentΧωνί ενεργοποίησης, στιγμή aha
purchasepurchased, purchase_completed, order_completed, order_placed, checkout_completedamount, currencyΈσοδα / ARPU
subscribe_startsubscribe_started, subscription_startedplan, amount, currency, intervalMRR, διατήρηση cohort
subscribe_renewedsubscription_renewedplan, amountΕπαναλαμβανόμενα έσοδα
trial_starttrial_started, free_trial_startedplan, daysΧωνί μετατροπής από trial
cancelcancelled, subscription_cancelled, subscription_canceledplanΚύκλος ζωής συνδρομής, churn
upgradeplan_upgradedfrom_plan, to_planΈσοδα επέκτασης
downgradeplan_downgradedfrom_plan, to_planΣυμπίεση εσόδων
shareshared, content_sharedchannelΣυντελεστής διάδοσης
inviteinvited, 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 με πρόσθετα δεδομένα