Connettore PostHog, Mixpanel & Amplitude

1. Il problema: numeri senza volti

La product analytics le fornisce un funnel: 1.000 utenti sono arrivati al checkout, 620 l’hanno abbandonato. È la misura precisa di un problema che però non riesce ancora a vedere. Guardare una manciata di quelle 620 registrazioni di solito risponde alla domanda in pochi minuti — ma solo se dal grafico può arrivare alle sessioni giuste senza esportare ID e cercarle a mano.

Il connettore di product analytics elimina questo divario. Funziona all’interno di mp.js e collega automaticamente i due sistemi:

In uscita: ogni evento registrato dal suo strumento di analisi porta con sé una proprietà mouseplayer_session_url. Apra un evento qualsiasi, clicchi il link e guardi la sessione.
In entrata: il distinct_id del visitatore viene riletto e salvato nella sessione di MousePlayer, così le registrazioni diventano ricercabili con la stessa identità che usa già in PostHog, Mixpanel o Amplitude.

Nessun codice necessario. Il connettore rileva da solo l’SDK di analisi. Non deve chiamare alcuna funzione di MousePlayer né cambiare il modo in cui traccia gli eventi.

2. Attivazione

Metodo A: dashboard (senza codice)

Apra il suo progetto e vada alla scheda Integrazioni.
Imposti Connettore PostHog, Mixpanel & Amplitude su ON.
Selezioni la piattaforma che usa. Le modifiche vengono salvate automaticamente.

L’impostazione ha effetto al successivo caricamento di pagina del suo sito web. Le sessioni esistenti non vengono modificate retroattivamente.

Metodo B: configurazione manuale dello script

Se preferisce impostarlo direttamente nel codice, inserisca i due valori in window.mp_config:

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

3. Che cosa succede su ogni piattaforma

Ogni piattaforma espone un’API diversa, quindi il connettore usa per ciascuna la chiamata più appropriata. Non deve configurare nulla — segue la piattaforma che ha selezionato.

Piattaforma	In uscita (URL della riproduzione)	In entrata (identità)
PostHog	`posthog.register()` — registrata come super property, quindi viene allegata a ogni evento successivo	`posthog.get_distinct_id()`
Mixpanel	`mixpanel.register()` — stesso comportamento della super property	`mixpanel.get_distinct_id()`
Amplitude	`setUserProperties()` — impostata come user property	`getDeviceId()`, con ripiego su `getInstance().options.deviceId` con l’SDK legacy

Super property e user property: in PostHog e Mixpanel l’URL della riproduzione viene allegato agli eventi da quel momento in poi, quindi lo troverà su ogni evento inviato dopo l’inizializzazione del connettore — non sugli eventi già inviati prima durante il caricamento della pagina.

4. Identità: da distinct_id a una sessione con un nome

La metà in entrata è la parte che la maggior parte dei team sottovaluta. Senza di essa le sessioni di MousePlayer sono anonime: può guardarle, ma non può rispondere a «mostrami le registrazioni dell’account che ci ha lasciato la settimana scorsa».

Una volta attivo il connettore, il distinct_id del suo strumento di analisi viene scritto nel campo custom_user_id della sessione — lo stesso campo in cui scrive la chiamata manuale dell’SDK:

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

Se chiama già mp('set') lei stesso, continui a farlo. Un’identità fornita esplicitamente è la più affidabile, perché è la sua chiave primaria e non un identificativo di analisi legato al singolo browser.

Nota sulla privacy: viene trasferito solo l’identificativo già assegnato dal suo strumento di analisi. Dall’SDK non vengono letti indirizzi e-mail, nomi o altri campi personali. Si assicuri che la sua informativa sulla privacy copra questo trattamento e subordini lo script di tracciamento al suo strumento di gestione del consenso, se il consenso è la sua base giuridica.

5. Comportamento tecnico

Gli SDK di analisi vengono di solito caricati in modo asincrono, spesso quando mp.js è già in esecuzione. Un solo tentativo all’avvio fallirebbe quindi sulla maggior parte dei siti reali.

Il connettore riprova ogni 1,5 secondi, fino a dieci volte, e si ferma non appena entrambe le direzioni sono completate.
Ogni direzione si conclude in modo indipendente, quindi l’URL della riproduzione non viene mai inviato due volte mentre si attende che compaia un’identità.
Se l’SDK non compare mai, il connettore rinuncia in silenzio dopo circa 15 secondi. Nella console non viene scritto nulla e la registrazione della sessione prosegue senza conseguenze.
Gli identificativi più lunghi di 128 caratteri vengono ignorati anziché troncati, per non salvare mezzo identificativo che non corrisponderebbe mai a nulla.

6. Verificare che funzioni

Apra il suo sito web in una normale scheda del browser e interagisca brevemente.
Nel suo strumento di analisi apra l’evento più recente e cerchi la proprietà mouseplayer_session_url. Aprendola dovrebbe arrivare direttamente alla registrazione.
In MousePlayer apra l’Esploratore utenti. Le sessioni che hanno un’identità la mostrano al posto del soprannome generato per il visitatore.

Se non compare nulla

La proprietà manca in tutti gli eventi: verifichi che l’SDK di analisi venga davvero caricato nella pagina e di aver selezionato la piattaforma corrispondente. Con PostHog selezionato non viene letto Mixpanel.
La proprietà compare solo negli eventi successivi: è previsto, veda la nota nella sezione 3.
L’URL c’è ma l’identità no: il suo SDK non ha ancora assegnato un distinct_id, cosa normale prima che un utente venga identificato. Verrà rilevato a un caricamento di pagina successivo.
Sta facendo il test come amministratore connesso: alcune configurazioni escludono il traffico interno. Provi con una finestra privata.

Come possiamo aiutarla?