Most za PostHog, Mixpanel & Amplitude

Vaš alat za analitiku proizvoda govori šta se desilo. MousePlayer pokazuje zašto. Ovaj most povezuje oba smjera, pa je odustajanje u lijevku udaljeno jedan klik od snimka koji ga objašnjava.

1. Problem: brojke bez lica

Analitika proizvoda daje lijevak: 1.000 korisnika stiglo je do plaćanja, 620 ga je napustilo. To je precizno mjerenje problema koji i dalje ne vidite. Gledanje nekoliko od tih 620 snimaka obično daje odgovor za nekoliko minuta — ali samo ako od grafikona možete doći do pravih sesija bez izvoza ID-jeva i ručne pretrage.

Most za analitiku proizvoda uklanja tu prazninu. Radi unutar mp.js i automatski povezuje oba sistema:

  • Izlazno: svaki događaj koji analitički alat zabilježi sadrži svojstvo mouseplayer_session_url koje možete otvoriti. Otvorite događaj, kliknite link i gledajte sesiju.
  • Ulazno: identifikator distinct_id posjetioca čita se nazad i čuva u MousePlayer sesiji, pa snimke možete pretraživati po istom identitetu koji već koristite u PostHogu, Mixpanelu ili Amplitudeu.

Kod nije potreban. Most sam otkriva analitički SDK. Ne pozivate nijednu MousePlayer funkciju i ne morate mijenjati način praćenja događaja.

2. Aktivacija

Način A: kontrolna ploča (bez koda)

  1. Otvorite projekt i idite na karticu Integracije u projektu.
  2. Postavite Most za PostHog, Mixpanel & Amplitude na ON.
  3. Odaberite platformu koju koristite. Promjene se automatski čuvaju.

Postavka djeluje pri sljedećem učitavanju stranice sajta. Ne utječe retroaktivno na postojeće sesije.

Način B: ručna konfiguracija skripte

Ako želite postaviti direktno u kodu, unesite dvije vrijednosti 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 dešava po platformi

Svaka platforma izlaže drugačiji API, pa most za svaku koristi odgovarajući poziv. Ne trebate to postavljati — prati vaš odabir pružaoca usluge.

PlatformaIzlazno (URL reprodukcije)Ulazno (identitet)
PostHog posthog.register() — registrirano kao super svojstvo, pa se dodaje svakom sljedećem 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 rezervni poziv getInstance().options.deviceId na starom SDK-u

Super svojstvo i svojstvo korisnika: u PostHogu i Mixpanelu URL reprodukcije dodaje se budućim događajima, pa ga nalazite na svakom događaju nakon pokretanja mosta — ne na ranije poslanim događajima tokom učitavanja stranice.

4. Identitet: od distinct_id do imenovane sesije

Ulazni dio većina timova potcjenjuje. Bez njega su MousePlayer sesije anonimne: možete ih gledati, ali ne možete odgovoriti na zahtjev „pokaži snimke računa koji je prošle sedmice otišao“.

Kad je most aktivan, identifikator distinct_id iz analitičkog alata upisuje se u polje sesije custom_user_id koje koristi i ručni SDK poziv — isto polje kao u ovom primjeru:

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

Nastavite sami pozivati mp('set') ako to već radite. Identitet koji izričito navedete pouzdaniji je jer je to vaš vlastiti primarni ključ, a ne analitički identifikator po pregledniku.

Napomena o privatnosti: prenosi se samo identifikator koji je vaš analitički alat već dodijelio. Iz SDK-a se ne čitaju e-mail, ime ni druga lična polja. Osigurajte da politika privatnosti pokriva ovu obradu i blokirajte skriptu alatom za saglasnost 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. Jedan pokušaj pri pokretanju zato ne bi uspio na većini stvarnih sajtova.

  • Most pokušava ponovo svakih 1,5 sekundi, do deset puta i staje čim su oba smjera završena.
  • Svaki smjer završava nezavisno, pa se URL reprodukcije nikad ne šalje dvaput dok se čeka identitet.
  • Ako se SDK nikad ne pojavi, most tiho odustaje nakon otprilike 15 sekundi. Ništa se ne upisuje u konzolu i snimanje sesije nastavlja se neometano.
  • Identifikatori duži od 128 znakova zanemaruju se umjesto skraćivanja, da se ne sačuva pola identifikatora koji nikad ne bi odgovarao ničemu.

6. Provjera rada

  1. Otvorite sajt u običnoj kartici preglednika i kratko ga koristite.
  2. U analitičkom alatu otvorite najnoviji događaj i potražite svojstvo mouseplayer_session_url tog događaja. Njegovo otvaranje treba vas odvesti direktno na snimak.
  3. U MousePlayeru otvorite Istraživač korisnika. Sesije s identitetom prikazuju njega umjesto generiranog nadimka posjetioca.

Ako se ništa ne pojavljuje

  • Svojstvo nedostaje u svim događajima: provjerite učitava li se analitički SDK na stranici i jeste li odabrali odgovarajuću platformu. Odabir PostHoga neće čitati Mixpanel.
  • Svojstvo se pojavljuje samo u kasnijim događajima: to je očekivano; pogledajte napomenu u odjeljku 3.
  • URL postoji, ali identitet ne: vaš SDK još nije dodijelio identifikator distinct_id posjetiocu, što je normalno prije identifikacije korisnika. Preuzet će se pri kasnijem učitavanju stranice.
  • Testirate kao prijavljeni administrator: neke konfiguracije isključuju interni saobraćaj. Probajte privatni prozor.

Svi ovdje navedeni zaštitni znakovi pripadaju njihovim vlasnicima. MousePlayer nema poslovni odnos s ovim pružaocima usluga.