Γέφυρα PostHog, Mixpanel και Amplitude

1. Το πρόβλημα: αριθμοί χωρίς πρόσωπα

Η ανάλυση προϊόντος σάς δίνει μια χοάνη: 1.000 χρήστες έφτασαν στην ολοκλήρωση αγοράς, 620 την εγκατέλειψαν. Είναι μια ακριβής μέτρηση ενός προβλήματος που ακόμη δεν μπορείτε να δείτε. Η παρακολούθηση λίγων από αυτές τις 620 καταγραφές συνήθως απαντά στο ερώτημα μέσα σε λίγα λεπτά — αλλά μόνο αν μπορείτε να μεταβείτε από το διάγραμμα στις σωστές συνεδρίες χωρίς εξαγωγή ID και χειροκίνητη αναζήτηση.

Η γέφυρα ανάλυσης προϊόντος καλύπτει αυτό το κενό. Λειτουργεί μέσα στο mp.js και συνδέει αυτόματα τα δύο συστήματα:

Εξερχόμενα: κάθε συμβάν που καταγράφει το εργαλείο ανάλυσής σας φέρει την ιδιότητα mouseplayer_session_url. Ανοίξτε οποιοδήποτε συμβάν, κάντε κλικ στον σύνδεσμο, δείτε τη συνεδρία.
Εισερχόμενα: το distinct_id του επισκέπτη διαβάζεται και αποθηκεύεται στη συνεδρία MousePlayer, ώστε οι καταγραφές να μπορούν να αναζητηθούν με την ίδια ταυτότητα που ήδη χρησιμοποιείτε στο PostHog, το Mixpanel ή το Amplitude.

Δεν απαιτείται κώδικας. Η γέφυρα εντοπίζει μόνη της το SDK ανάλυσης. Δεν καλείτε καμία συνάρτηση του MousePlayer και δεν χρειάζεται να αλλάξετε τον τρόπο παρακολούθησης συμβάντων.

2. Ενεργοποίηση

Μέθοδος Α: πίνακας ελέγχου (χωρίς κώδικα)

Ανοίξτε το έργο σας και μεταβείτε στην καρτέλα Ενσωματώσεις.
Θέστε τη Γέφυρα PostHog, Mixpanel & Amplitude σε ON.
Επιλέξτε την πλατφόρμα που χρησιμοποιείτε. Οι αλλαγές αποθηκεύονται αυτόματα.

Η ρύθμιση τίθεται σε ισχύ στην επόμενη φόρτωση σελίδας του ιστοτόπου σας. Οι υπάρχουσες συνεδρίες δεν επηρεάζονται αναδρομικά.

Μέθοδος Β: χειροκίνητη διαμόρφωση script

Αν προτιμάτε να το ορίσετε απευθείας στον κώδικα, ορίστε τις δύο τιμές μέσα στο window.mp_config:

<script> window.mp_config = { channel: 'YOUR_CHANNEL_ID', analytics_bridge_active: true, analytics_provider: 'posthog' // 'posthog', 'mixpanel' or 'amplitude' }; </script>

3. Τι συμβαίνει ανά πλατφόρμα

Κάθε πλατφόρμα εκθέτει διαφορετικό API, οπότε η γέφυρα αντιστοιχίζει τη συνήθη κλήση για καθεμία. Δεν χρειάζεται να το ρυθμίσετε — ακολουθεί την επιλογή παρόχου σας.

Πλατφόρμα	Εξερχόμενα (URL αναπαραγωγής)	Εισερχόμενα (ταυτότητα)
PostHog	`posthog.register()` — καταχωρίζεται ως κοινή ιδιότητα, ώστε να επισυνάπτεται σε κάθε επόμενο συμβάν	`posthog.get_distinct_id()`
Mixpanel	`mixpanel.register()` — ίδια συμπεριφορά κοινής ιδιότητας	`mixpanel.get_distinct_id()`
Amplitude	`setUserProperties()` — ορίζεται ως ιδιότητα χρήστη	`getDeviceId()`, με εφεδρική χρήση του `getInstance().options.deviceId` στο παλαιότερο SDK

Κοινή ιδιότητα έναντι ιδιότητας χρήστη: στο PostHog και στο Mixpanel το URL αναπαραγωγής επισυνάπτεται στα επόμενα συμβάντα, οπότε θα το βρίσκετε σε κάθε συμβάν που ενεργοποιείται μετά την αρχικοποίηση της γέφυρας — όχι σε συμβάντα που είχαν ήδη αποσταλεί νωρίτερα κατά τη φόρτωση της σελίδας.

4. Ταυτότητα: από το distinct_id σε μια ταυτοποιημένη συνεδρία

Το εισερχόμενο σκέλος είναι εκείνο που οι περισσότερες ομάδες υποτιμούν. Χωρίς αυτό, οι συνεδρίες MousePlayer είναι ανώνυμες: μπορείτε να τις δείτε, αλλά δεν μπορείτε να απαντήσετε στο αίτημα «δείξε μου τις καταγραφές του λογαριασμού που αποχώρησε οριστικά την περασμένη εβδομάδα».

Μόλις ενεργοποιηθεί η γέφυρα, το distinct_id από το εργαλείο ανάλυσής σας γράφεται στο πεδίο custom_user_id της συνεδρίας — το ίδιο πεδίο στο οποίο γράφει η χειροκίνητη κλήση SDK:

// The manual equivalent - you do NOT need this when the bridge is active mp('set', { user_id: 'your-internal-id' });

Αν ήδη καλείτε το mp('set') μόνοι σας, συνεχίστε. Μια ταυτότητα που παρέχετε ρητά είναι πιο αξιόπιστη, επειδή είναι το δικό σας πρωτεύον κλειδί και όχι ένα αναγνωριστικό ανάλυσης ανά πρόγραμμα περιήγησης.

Σημείωση απορρήτου: μεταφέρεται μόνο το αναγνωριστικό που έχει ήδη αποδώσει το εργαλείο ανάλυσής σας. Δεν διαβάζεται από το SDK καμία διεύθυνση email, όνομα ή άλλο προσωπικό πεδίο. Βεβαιωθείτε ότι η δήλωση απορρήτου σας καλύπτει αυτή την επεξεργασία και επιτρέψτε τη φόρτωση του script παρακολούθησης μέσω του εργαλείου συγκατάθεσής σας αν βασίζεστε στη συγκατάθεση ως νομική βάση.

5. Τεχνική συμπεριφορά

Τα SDK ανάλυσης συνήθως φορτώνονται ασύγχρονα, συχνά αφού το mp.js έχει ήδη ξεκινήσει. Μία μόνο προσπάθεια κατά την εκκίνηση επομένως θα αποτύγχανε στους περισσότερους πραγματικούς ιστοτόπους.

Η γέφυρα επαναλαμβάνει την προσπάθεια κάθε 1,5 δευτερόλεπτο, έως δέκα φορές, και σταματά μόλις ολοκληρωθούν και οι δύο κατευθύνσεις.
Κάθε κατεύθυνση ολοκληρώνεται ανεξάρτητα, οπότε το URL αναπαραγωγής δεν αποστέλλεται ποτέ δύο φορές κατά την αναμονή εμφάνισης μιας ταυτότητας.
Αν το SDK δεν εμφανιστεί ποτέ, η γέφυρα σταματά σιωπηλά μετά από περίπου 15 δευτερόλεπτα. Δεν γράφεται τίποτα στην κονσόλα και η καταγραφή συνεδρίας συνεχίζεται ανεπηρέαστη.
Αναγνωριστικά μεγαλύτερα από 128 χαρακτήρες αγνοούνται αντί να περικόπτονται, ώστε να μη φυλάσσεται μισό αναγνωριστικό που δεν θα μπορούσε ποτέ να αντιστοιχιστεί.

6. Επαλήθευση λειτουργίας

Ανοίξτε τον ιστότοπό σας σε μια κανονική καρτέλα προγράμματος περιήγησης και αλληλεπιδράστε για λίγο.
Στο εργαλείο ανάλυσής σας, ανοίξτε το πιο πρόσφατο συμβάν και αναζητήστε την ιδιότητα mouseplayer_session_url. Ανοίγοντάς την θα πρέπει να μεταβείτε απευθείας στην καταγραφή.
Στο MousePlayer, ανοίξτε τον Εξερευνητή χρηστών. Οι συνεδρίες που φέρουν ταυτότητα την εμφανίζουν αντί για το παραγόμενο ψευδώνυμο επισκέπτη.

Αν δεν εμφανίζεται τίποτα

Η ιδιότητα λείπει από όλα τα συμβάντα: ελέγξτε ότι το SDK ανάλυσης φορτώνεται πράγματι στη σελίδα και ότι επιλέξατε την αντίστοιχη πλατφόρμα. Η επιλογή PostHog δεν θα διαβάσει το Mixpanel.
Η ιδιότητα εμφανίζεται μόνο σε μεταγενέστερα συμβάντα: είναι αναμενόμενο, δείτε τη σημείωση στην ενότητα 3.
Το URL υπάρχει, αλλά η ταυτότητα όχι: το SDK σας δεν έχει αποδώσει ακόμη distinct_id, κάτι φυσιολογικό πριν από την ταυτοποίηση ενός χρήστη. Θα αναγνωριστεί σε επόμενη φόρτωση σελίδας.
Κάνετε δοκιμή ως συνδεδεμένος διαχειριστής: ορισμένες διαμορφώσεις εξαιρούν την εσωτερική επισκεψιμότητα. Δοκιμάστε ένα ιδιωτικό παράθυρο.

Όλα τα εμπορικά σήματα που αναφέρονται εδώ ανήκουν στους αντίστοιχους κατόχους τους. Το MousePlayer δεν έχει επιχειρηματική σχέση με αυτούς τους παρόχους.

Πώς μπορούμε να βοηθήσουμε;