Most za PostHog, Mixpanel & Amplitude

Vaš alat za analitiku proizvoda govori šta se dogodilo. MousePlayer pokazuje zašto. Ovaj most ih povezuje u oba smera, tako da je odustajanje u levku udaljeno jedan klik od snimka koji ga objašnjava.

1. Problem: brojke bez lica

Analitika proizvoda daje levak: 1.000 korisnika stiglo je do naplate, 620 ju je napustilo. To je precizno merenje problema koji i dalje ne vidite. Gledanje nekoliko od tih 620 snimaka obično odgovara na pitanje za nekoliko minuta — ali samo ako sa grafikona možete da dođete do pravih sesija bez izvoza ID-jeva i ručne pretrage.

Ovaj most za analitiku proizvoda uklanja taj jaz. Radi unutar mp.js i automatski povezuje dva sistema:

  • Odlazno: svaki događaj koji vaš analitički alat beleži sadrži svojstvo mouseplayer_session_url. Otvorite bilo koji događaj, kliknite na link, pogledajte sesiju.
  • Dolazno: identifikator posetioca distinct_id čita se nazad i čuva u MousePlayer sesiji, tako da snimci mogu da se pretražuju po istom identitetu koji već koristite u PostHog-u, Mixpanel-u ili Amplitude-u.

Nije potreban kôd. Most sam otkriva analitički SDK. Ne pozivate nijednu MousePlayer funkciju i ne morate da menjate način praćenja događaja.

2. Aktivacija

Način A: kontrolna tabla (bez koda)

  1. Otvorite projekat i idite na karticu Integracije.
  2. Prebacite Most za PostHog, Mixpanel & Amplitude na ON.
  3. Izaberite platformu koju koristite. Izmene se automatski čuvaju.

Podešavanje stupa na snagu pri sledećem učitavanju stranice vašeg sajta. Ne utiče retroaktivno na postojeće sesije.

Način B: ručna konfiguracija skripte

Ako radije unosite direktno u kôd, postavite dve vrednosti unutar 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. Šta se događa po platformi

Svaka platforma pruža drugačiji API, pa most koristi odgovarajući uobičajeni poziv za svaku. Ovo ne morate da podešavate — prati vaš izbor pružaoca usluge.

PlatformaOdlazno (URL snimka)Dolazno (identitet)
PostHog posthog.register() — registrovano kao super svojstvo, pa se dodaje svakom narednom događaju posthog.get_distinct_id()
Mixpanel mixpanel.register() — isto ponašanje super svojstva mixpanel.get_distinct_id()
Amplitude setUserProperties() — postavljeno kao svojstvo korisnika getDeviceId(), uz prelazak na getInstance().options.deviceId u starom SDK-u

Super svojstvo naspram svojstva korisnika: u PostHog-u i Mixpanel-u URL snimka dodaje se budućim događajima, pa ćete ga naći na svakom događaju pokrenutom nakon inicijalizacije mosta — ne na događajima već poslatim ranije tokom učitavanja stranice.

4. Identitet: od distinct_id do imenovane sesije

Dolaznu polovinu većina timova potcenjuje. Bez nje su MousePlayer sesije anonimne: možete da ih gledate, ali ne možete da odgovorite na zahtev „pokaži mi snimke naloga koji je trajno otišao prošle nedelje“.

Kada je most aktivan, identifikator distinct_id iz vašeg analitičkog alata upisuje se u polje sesije custom_user_id — isto polje u koje piše ručni SDK poziv:

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

Ako već sami pozivate mp('set'), nastavite. Identitet koji izričito dostavite pouzdaniji je jer je vaš primarni ključ, a ne analitički identifikator pojedinačnog pregledača.

Napomena o privatnosti: prenosi se samo identifikator koji je vaš analitički alat već dodelio. Iz SDK-a se ne čitaju imejl adresa, ime niti druga lična polja. Obezbedite da vaša politika privatnosti pokriva ovu obradu i da alat za saglasnost blokira skriptu za praćenje ako se oslanjate na saglasnost kao pravni osnov.

5. Tehničko ponašanje

Analitički SDK-ovi obično se učitavaju asinhrono, često nakon što mp.js već radi. Zato bi jedan pokušaj pri pokretanju propao na većini stvarnih veb-sajtova.

  • Most pokušava ponovo svakih 1,5 sekundi, do deset puta, i zaustavlja se čim se oba smera završe.
  • Svaki smer završava nezavisno, pa se URL snimka nikada ne šalje dvaput dok se čeka identitet.
  • Ako se SDK nikada ne pojavi, most neprimetno odustaje posle otprilike 15 sekundi. Ništa se ne upisuje u konzolu i snimanje sesije nastavlja se bez smetnji.
  • Identifikatori duži od 128 znakova se zanemaruju umesto da budu skraćeni, da se ne sačuva polovina identifikatora koja se nikada ni sa čim ne bi poklopila.

6. Provera rada

  1. Otvorite svoj veb-sajt u običnoj kartici pregledača i nakratko ga koristite.
  2. U analitičkom alatu otvorite najnoviji događaj i potražite svojstvo mouseplayer_session_url. Njegovo otvaranje treba da vas odvede direktno na snimak.
  3. U MousePlayer-u otvorite Istraživač korisnika. Sesije sa identitetom prikazuju njega umesto generisanog nadimka posetioca.

Ako se ništa ne pojavljuje

  • Svojstvo nedostaje na svim događajima: proverite da se analitički SDK zaista učitava na stranici i da ste izabrali odgovarajuću platformu. Izbor PostHog-a neće čitati Mixpanel.
  • Svojstvo se pojavljuje samo na kasnijim događajima: to je očekivano, pogledajte napomenu u odeljku 3.
  • URL postoji, ali identitet ne: vaš SDK još nije dodelio distinct_id, što je normalno pre identifikacije korisnika. Biće preuzet pri kasnijem učitavanju stranice.
  • Testirate kao prijavljeni administrator: neka podešavanja isključuju interni saobraćaj. Probajte privatni prozor.

Svi ovde navedeni žigovi pripadaju svojim vlasnicima. MousePlayer nema poslovni odnos sa ovim pružaocima usluga.