Most za PostHog, Mixpanel & Amplitude

Vaše orodje za analitiko izdelka pove, kaj se je zgodilo. MousePlayer pokaže, zakaj. Ta most ju poveže v obe smeri, zato je odhod v lijaku le en klik oddaljen od posnetka, ki ga pojasni.

1. Težava: številke brez obrazov

Analitika izdelka poda lijak: 1000 uporabnikov je doseglo zaključek nakupa, 620 jih je odnehalo. To je natančna meritev težave, ki je še vedno ne vidite. Ogled nekaj od teh 620 posnetkov običajno odgovori v nekaj minutah — vendar samo, če lahko z grafikona pridete do pravih sej brez izvažanja ID-jev in ročnega iskanja.

Most za analitiko izdelka odpravi to vrzel. Deluje znotraj mp.js in samodejno poveže sistema:

  • Odhodno: vsak dogodek, ki ga zabeleži vaše analitično orodje, vsebuje lastnost mouseplayer_session_url. Odprite kateri koli dogodek, kliknite povezavo in si oglejte sejo.
  • Dohodno: obiskovalčev distinct_id se prebere nazaj in shrani v sejo MousePlayer, zato je mogoče posnetke iskati po isti identiteti, ki jo že uporabljate v PostHog, Mixpanel ali Amplitude.

Koda ni potrebna. Most sam zazna analitični SDK. Ne kličete funkcij MousePlayer in ni treba spreminjati načina sledenja dogodkom.

2. Aktivacija

Način A: nadzorna plošča (brez kode)

  1. Odprite projekt in pojdite na zavihek Integracije.
  2. Preklopite Most za PostHog, Mixpanel & Amplitude na ON.
  3. Izberite svojo platformo. Spremembe se shranijo samodejno.

Nastavitev začne veljati ob naslednjem nalaganju vašega spletnega mesta. Na obstoječe seje ne vpliva za nazaj.

Način B: ročna nastavitev skripta

Če želite vrednosti zapisati v kodo, ju nastavite znotraj 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. Kaj se zgodi na posamezni platformi

Vsaka platforma ponuja drugačen API, zato most uporabi ustrezen običajni klic. Tega vam ni treba nastavljati — sledi izbranemu ponudniku.

PlatformaOdhodno (URL posnetka)Dohodno (identiteta)
PostHog posthog.register() — registrirano kot nadlastnost, zato se pripne vsakemu naslednjemu dogodku posthog.get_distinct_id()
Mixpanel mixpanel.register() — enako delovanje nadlastnosti mixpanel.get_distinct_id()
Amplitude setUserProperties() — nastavljeno kot lastnost uporabnika getDeviceId(), z rezervno uporabo getInstance().options.deviceId v starejšem SDK-ju

Nadlastnost in lastnost uporabnika: v PostHog in Mixpanel je URL posnetka pripet prihodnjim dogodkom, zato ga najdete pri vsakem dogodku, sproženem po vzpostavitvi mostu — ne pri dogodkih, ki so bili poslani prej med nalaganjem strani.

4. Identiteta: od distinct_id do poimenovane seje

Dohodni del večina ekip podcenjuje. Brez njega so seje MousePlayer anonimne: gledate jih lahko, ne morete pa zahtevati „pokaži posnetke računa, ki je prejšnji teden odšel.“

Ko je most dejaven, se distinct_id iz vašega analitičnega orodja zapiše v polje seje custom_user_id — isto polje, v katero zapisuje ročni klic SDK-ja:

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

Če že sami kličete mp('set'), to počnite še naprej. Izrecno posredovana identiteta je zanesljivejša, ker je vaš lastni primarni ključ, ne analitični identifikator posameznega brskalnika.

Opomba o zasebnosti: prenese se samo identifikator, ki ga je vaše analitično orodje že dodelilo. Iz SDK-ja se ne bere e-poštnega naslova, imena ali drugih osebnih polj. Poskrbite, da vaša politika zasebnosti zajema to obdelavo, in skript za sledenje blokirajte z orodjem za privolitev, če je privolitev vaša pravna podlaga.

5. Tehnično delovanje

Analitični SDK-ji se običajno nalagajo asinhrono, pogosto po tem, ko mp.js že deluje. En sam poskus ob zagonu bi zato na večini pravih spletnih mest spodletel.

  • Most poskusi znova vsakih 1,5 sekunde, največ desetkrat, in se ustavi, ko sta končani obe smeri.
  • Vsaka smer se zaključi neodvisno, zato se URL posnetka med čakanjem na identiteto nikoli ne pošlje dvakrat.
  • Če se SDK nikoli ne pojavi, most po približno 15 sekundah tiho odneha. V konzolo ne zapiše ničesar, snemanje sej pa se nadaljuje nespremenjeno.
  • Identifikatorji z več kot 128 znaki se prezrejo namesto krajšanja, da se ne shrani polovica identifikatorja, ki se nikoli ne bi ujemala.

6. Preverjanje delovanja

  1. Odprite spletno mesto v običajnem zavihku in ga na kratko uporabite.
  2. V analitičnem orodju odprite najnovejši dogodek in poiščite lastnost mouseplayer_session_url. Ko jo odprete, bi morali priti neposredno do posnetka.
  3. V MousePlayer odprite Raziskovalec uporabnikov. Seje z identiteto jo pokažejo namesto ustvarjenega vzdevka obiskovalca.

Če se nič ne prikaže

  • Lastnost manjka pri vseh dogodkih: preverite, ali se analitični SDK res naloži na strani in ali ste izbrali ustrezno platformo. Izbira PostHog ne bere Mixpanel.
  • Lastnost se pojavi samo pri poznejših dogodkih: to je pričakovano, glejte opombo v 3. razdelku.
  • URL je prisoten, identiteta pa ne: vaš SDK še ni dodelil distinct_id, kar je normalno pred prepoznavo uporabnika. Prebere se ob poznejšem nalaganju strani.
  • Preizkušate kot prijavljeni administrator: nekatere nastavitve izključujejo interni promet. Poskusite v zasebnem oknu.

Vse navedene blagovne znamke pripadajo svojim lastnikom. MousePlayer s temi ponudniki nima poslovnega odnosa.