Most za PostHog, Mixpanel & Amplitude

Vaš alat za analitiku proizvoda govori vam što se dogodilo. MousePlayer pokazuje zašto. Ovaj most povezuje ta dva sustava u oba smjera pa je odustajanje u lijevku samo jedan klik udaljeno od snimke koja ga objašnjava.

1. Problem: brojke bez lica

Analitika proizvoda daje vam lijevak: 1000 korisnika došlo je do dovršavanja kupnje, a 620 je odustalo. To je precizno mjerenje problema koji još ne vidite. Gledanje nekoliko od tih 620 snimki obično odgovara na pitanje za nekoliko minuta — ali samo ako iz grafikona možete doći do pravih sesija bez izvoza ID-jeva i ručnog pretraživanja.

Most za analitiku proizvoda uklanja taj jaz. Radi unutar mp.js i automatski povezuje dva sustava:

  • Izlazno: svaki događaj koji vaš analitički alat zabilježi ima svojstvo mouseplayer_session_url. Otvorite bilo koji događaj, kliknite poveznicu i pogledajte sesiju.
  • Ulazno: posjetiteljev distinct_id čita se natrag i pohranjuje u sesiju MousePlayera pa snimke možete pretraživati prema istom identitetu koji već koristite u PostHogu, Mixpanelu ili Amplitudeu.

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

2. Aktivacija

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

  1. Otvorite projekt i prijeđite na karticu Integracije.
  2. Postavite Most za PostHog, Mixpanel & Amplitude na ON.
  3. Odaberite platformu koju koristite. Promjene se spremaju automatski.

Postavka počinje djelovati pri sljedećem učitavanju stranice vašeg web-mjesta. Ne utječe retroaktivno na postojeće sesije.

Način B: ručna konfiguracija skripte

Ako postavke želite unijeti u kod, postavite 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. Što se događa na svakoj platformi

Svaka platforma izlaže drukčiji API pa most koristi odgovarajući poziv za svaku. To ne morate postavljati — ovisi o odabranom pružatelju.

PlatformaIzlazno (URL reprodukcije)Ulazno (identitet)
PostHog posthog.register() — registrirano kao nadređeno svojstvo pa se pridružuje svakom sljedećem događaju posthog.get_distinct_id()
Mixpanel mixpanel.register() — isto ponašanje nadređenog svojstva mixpanel.get_distinct_id()
Amplitude setUserProperties() — postavljeno kao korisničko svojstvo getDeviceId(), uz pričuvnu upotrebu getInstance().options.deviceId u starijem SDK-u

Nadređeno i korisničko svojstvo: u PostHogu i Mixpanelu URL reprodukcije pridružuje se budućim događajima pa ćete ga pronaći na svakom događaju poslanom nakon inicijalizacije mosta — ne na događajima već poslanima ranije tijekom učitavanja stranice.

4. Identitet: od distinct_id do imenovane sesije

Ulazni smjer dio je koji većina timova podcjenjuje. Bez njega su sesije MousePlayera anonimne: možete ih gledati, ali ne možete odgovoriti na zahtjev „prikažite snimke računa koji je prošlog tjedna trajno otišao.“

Kad je most aktivan, distinct_id iz vašeg analitičkog alata zapisuje se u polje sesije custom_user_id — isto polje u koje zapisuje 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 s time. Identitet koji izričito navedete pouzdaniji je jer je to vaš primarni ključ, a ne analitički identifikator pojedinog preglednika.

Napomena o privatnosti: prenosi se samo identifikator koji je vaš analitički alat već dodijelio. Iz SDK-a se ne čita adresa e-pošte, ime ni drugo osobno polje. Provjerite obuhvaćaju li vaša pravila privatnosti tu obradu i blokirajte skriptu za praćenje alatom za privolu ako se oslanjate na privolu kao pravnu osnovu.

5. Tehničko ponašanje

Analitički SDK-ovi obično se učitavaju asinkrono, često nakon što mp.js već radi. Zato jedan pokušaj pri pokretanju ne bi uspio na većini stvarnih web-mjesta.

  • Most ponavlja pokušaj svakih 1,5 sekundi, najviše deset puta, i staje čim su oba smjera dovršena.
  • Svaki se smjer završava neovisno pa se URL reprodukcije nikad ne šalje dvaput dok se čeka identitet.
  • Ako se SDK nikad ne pojavi, most neprimjetno odustaje nakon otprilike 15 sekundi. Ništa se ne zapisuje u konzolu, a snimanje sesije nastavlja se bez promjene.
  • Identifikatori dulji od 128 znakova zanemaruju se umjesto skraćivanja kako se ne bi pohranila polovica identifikatora koja se nikad ni s čim ne bi podudarala.

6. Provjera rada

  1. Otvorite web-mjesto 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. Otvaranje bi vas trebalo odvesti izravno na snimku.
  3. U MousePlayeru otvorite Pregled korisnika. Sesije s identitetom prikazuju ga umjesto generiranog nadimka posjetitelja.

Ako se ništa ne pojavljuje

  • Svojstvo nedostaje na 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 na kasnijim događajima: to je očekivano, pogledajte napomenu u odjeljku 3.
  • URL postoji, ali identitet ne: vaš SDK još nije dodijelio distinct_id, što je normalno prije identifikacije korisnika. Preuzet će se pri kasnijem učitavanju stranice.
  • Testirate kao prijavljeni administrator: neke postave isključuju interni promet. Pokušajte u privatnom prozoru.

Svi ovdje navedeni žigovi pripadaju svojim vlasnicima. MousePlayer nema poslovni odnos s tim pružateljima.