Punte PostHog, Mixpanel & Amplitude

Instrumentul de analiză a produsului spune ce s-a întâmplat. MousePlayer arată de ce. Puntea le conectează în ambele direcții: de la un abandon din pâlnie ajungeți cu un clic la înregistrarea care îl explică.

1. Problema: cifre fără oameni

Analiza produsului oferă o pâlnie: 1.000 de utilizatori au ajuns la finalizarea comenzii, 620 au abandonat. Este măsurarea precisă a unei probleme încă invizibile. Câteva dintre cele 620 de înregistrări răspund de obicei în minute — dar numai dacă ajungeți de la grafic la sesiunile corecte fără export de ID-uri și căutare manuală.

Puntea pentru analiza produsului elimină acest gol. Rulează în mp.js și conectează automat sistemele:

  • Spre exterior: fiecare eveniment înregistrat de instrumentul de analiză conține proprietatea mouseplayer_session_url. Deschideți orice eveniment, apăsați linkul și vizionați sesiunea.
  • Spre interior: identificatorul vizitatorului distinct_id este citit și stocat în sesiunea MousePlayer, astfel încât înregistrările pot fi căutate după aceeași identitate folosită în PostHog, Mixpanel sau Amplitude.

Fără cod suplimentar. Puntea detectează singură SDK-ul analitic. Nu apelați funcții MousePlayer și nu schimbați urmărirea evenimentelor.

2. Activare

Metoda A: tabloul de bord (fără cod)

  1. Deschideți proiectul și mergeți la fila Integrări.
  2. Comutați Punte PostHog, Mixpanel & Amplitude la ON.
  3. Selectați platforma folosită. Modificările se salvează automat.

Setarea se aplică la următoarea încărcare a paginii site-ului. Sesiunile existente nu sunt afectate retroactiv.

Metoda B: configurarea manuală a scriptului

Dacă preferați configurarea în cod, setați cele două valori în window.mp_config:

<!-- MousePlayer SDK with the Product Analytics Bridge enabled --> <script> window.mp_config = { channel: 'YOUR_CHANNEL_ID', analytics_bridge_active: true, analytics_provider: 'posthog' // 'posthog', 'mixpanel' or 'amplitude' }; </script>

3. Ce se întâmplă pe fiecare platformă

Fiecare platformă expune alt API, deci puntea folosește apelul potrivit fiecăreia. Nu trebuie configurat — urmează furnizorul selectat.

PlatformăSpre exterior (URL de redare)Spre interior (identitate)
PostHog posthog.register() — înregistrată ca superproprietate, deci atașată fiecărui eveniment ulterior posthog.get_distinct_id()
Mixpanel mixpanel.register() — același comportament de superproprietate mixpanel.get_distinct_id()
Amplitude setUserProperties() — setată ca proprietate a utilizatorului getDeviceId(), cu revenire la getInstance().options.deviceId în SDK-ul vechi

Superproprietate și proprietate de utilizator: în PostHog și Mixpanel, URL-ul redării se atașează evenimentelor viitoare: îl găsiți pe fiecare eveniment emis după inițializarea punții — nu pe cele trimise anterior în aceeași încărcare a paginii.

4. Identitate: de la distinct_id la o sesiune identificată

Partea de intrare este subestimată de majoritatea echipelor. Fără ea, sesiunile MousePlayer sunt anonime: le vedeți, dar nu puteți răspunde cererii „arată-mi înregistrările contului pierdut săptămâna trecută”.

După activarea punții, identificatorul distinct_id din instrumentul de analiză este scris în câmpul sesiunii custom_user_id — același câmp folosit de apelul SDK manual:

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

Dacă apelați deja mp('set') manual, continuați. Identitatea furnizată explicit este mai fiabilă, fiind cheia primară proprie, nu un identificator analitic per browser.

Notă de confidențialitate: Se transferă doar identificatorul deja atribuit de instrumentul analitic. Nu se citesc e-mailuri, nume sau alte câmpuri personale din SDK. Asigurați-vă că politica proprie acoperă prelucrarea și blocați scriptul prin instrumentul de consimțământ dacă acesta este temeiul juridic.

5. Comportament tehnic

SDK-urile analitice se încarcă de obicei asincron, adesea după ce mp.js rulează deja. O singură încercare la pornire ar eșua pe majoritatea site-urilor reale.

  • Puntea reîncearcă la fiecare 1,5 secunde, de cel mult zece ori, oprindu-se când ambele direcții sunt finalizate.
  • Fiecare direcție se finalizează independent, deci URL-ul redării nu este retrimis în așteptarea identității.
  • Dacă SDK-ul nu apare, puntea renunță fără mesaj după aproximativ 15 secunde. Nu scrie în consolă, iar înregistrarea continuă neafectată.
  • Identificatorii de peste 128 de caractere sunt ignorați, nu trunchiați, pentru a nu stoca jumătăți de identificator care nu vor corespunde niciodată.

6. Verificarea funcționării

  1. Deschideți site-ul într-o filă obișnuită și interacționați puțin.
  2. În instrumentul de analiză, deschideți evenimentul cel mai nou și căutați proprietatea mouseplayer_session_url. Deschiderea sa trebuie să ducă direct la înregistrare.
  3. În MousePlayer, deschideți Explorator de utilizatori. Sesiunile identificate afișează identitatea în locul poreclei generate.

Dacă nu apare nimic

  • Proprietatea lipsește din toate evenimentele: verificați încărcarea efectivă a SDK-ului pe pagină și platforma selectată. Selectarea PostHog nu citește Mixpanel.
  • Proprietatea apare doar la evenimente ulterioare: este normal, consultați nota din secțiunea 3.
  • URL-ul există, dar identitatea nu: SDK-ul nu a atribuit încă identificatorul distinct_id, ceea ce este normal înaintea identificării utilizatorului. Va fi preluat la o încărcare ulterioară.
  • Testați ca administrator autentificat: unele configurații exclud traficul intern. Încercați o fereastră privată.

Toate mărcile menționate aici aparțin proprietarilor lor. MousePlayer nu are relații comerciale cu acești furnizori.