PostHog, Mixpanel & Amplitude-brug

U produkontledingshulpmiddel vertel u wat gebeur het. MousePlayer wys u waarom. Hierdie brug verbind die twee in albei rigtings, sodat die opname wat 'n tregteruitval verduidelik net een klik weg is.

1. Die probleem: syfers sonder gesigte

Produkontleding gee u 'n tregter: 1,000 gebruikers het betaling bereik, 620 het dit verlaat. Dit is 'n presiese meting van 'n probleem wat u steeds nie kan sien nie. 'n Paar van daardie 620 opnames beantwoord gewoonlik die vraag binne minute — maar net as u vanaf die grafiek by die regte sessies kan uitkom sonder om ID's uit te voer en met die hand te soek.

Die produkontledingsbrug verwyder dié gaping. Dit loop binne mp.js en koppel die twee stelsels outomaties:

  • Uitgaande: elke gebeurtenis wat u ontledingshulpmiddel opneem, bevat 'n mouseplayer_session_url eienskap. Maak enige gebeurtenis oop, klik die skakel en kyk die sessie.
  • Inkomende: die besoeker se distinct_id word teruggelees en op die MousePlayer-sessie gestoor, sodat opnames volgens dieselfde identiteit deursoekbaar word wat u reeds in PostHog, Mixpanel of Amplitude gebruik.

Geen kode nodig nie. Die brug bespeur self die ontledings-SDK. U roep geen MousePlayer-funksie aan nie en hoef nie u gebeurtenisnasporing te verander nie.

2. Aktivering

Metode A: kontroleskerm (sonder kode)

  1. Maak u projek oop en gaan na die Integrasies oortjie.
  2. Skakel PostHog, Mixpanel & Amplitude-brug na ON.
  3. Kies die platform wat u gebruik. Veranderinge word outomaties gestoor.

Die instelling geld met die volgende bladsylaai op u webwerf. Bestaande sessies word nie terugwerkend geraak nie.

Metode B: handmatige skripkonfigurasie

As u dit liewer in die kode stel, stel die twee waardes binne 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. Wat per platform gebeur

Elke platform bied 'n ander API, dus gebruik die brug elkeen se gepaste oproep. U hoef dit nie op te stel nie — dit volg u verskafferkeuse.

PlatformUitgaande (herspeel-URL)Inkomende (identiteit)
PostHog posthog.register() — as 'n supereienskap geregistreer, dus by elke daaropvolgende gebeurtenis aangeheg posthog.get_distinct_id()
Mixpanel mixpanel.register() — dieselfde supereienskapgedrag mixpanel.get_distinct_id()
Amplitude setUserProperties() — as 'n gebruikerseienskap ingestel getDeviceId(), met terugval na getInstance().options.deviceId op die ou SDK

Supereienskap teenoor gebruikerseienskap: in PostHog en Mixpanel word die herspeel-URL vorentoe aan gebeure geheg; u vind dit dus op elke gebeurtenis ná die brug se inisialisering — nie op gebeure wat vroeër tydens die bladsylaai gestuur is nie.

4. Identiteit: van distinct_id na 'n benoemde sessie

Die inkomende helfte is wat die meeste spanne onderskat. Sonder dit is MousePlayer-sessies anoniem: u kan hulle kyk, maar nie antwoord op “wys my die opnames van die rekening wat verlede week permanent vertrek het” nie.

Sodra die brug aktief is, word die distinct_id uit u ontledingshulpmiddel geskryf na die sessie se custom_user_id veld — dieselfde veld waarheen die handmatige SDK-oproep skryf:

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

As u reeds mp('set') self aanroep, hou daarmee aan. 'n Identiteit wat u uitdruklik verskaf is betroubaarder, want dit is u eie primêre sleutel eerder as 'n ontledingsidentifiseerder per blaaier.

Privaatheidsnota: net die identifiseerder wat u ontledingshulpmiddel reeds toegeken het, word oorgedra. Geen e-posadres, naam of ander persoonlike veld word uit die SDK gelees nie. Maak seker u privaatheidsbeleid dek hierdie verwerking en plaas die nasporingskrip agter u toestemmingshulpmiddel as toestemming u regsgrond is.

5. Tegniese gedrag

Ontledings-SDK's laai gewoonlik asinchronies, dikwels nadat mp.js reeds loop. 'n Enkele poging by opstart sou dus op die meeste werklike webwerwe misluk.

  • Die brug probeer weer elke 1.5 sekondes, tot tien keer, en stop sodra albei rigtings voltooi is.
  • Elke rigting handel onafhanklik af, sodat die herspeel-URL nooit twee keer gestuur word terwyl 'n identiteit nog moet verskyn nie.
  • As die SDK nooit verskyn nie, gee die brug ná ongeveer 15 sekondes stilweg op. Niks word na die konsole geskryf nie en sessie-opname gaan onversteurd voort.
  • Identifiseerders langer as 128 karakters word geïgnoreer eerder as afgekap, om nie 'n halwe identifiseerder te stoor wat nooit by iets sal pas nie.

6. Kontroleer dat dit werk

  1. Maak u webwerf in 'n gewone blaaieroortjie oop en gebruik dit kortliks.
  2. Maak die jongste gebeurtenis in u ontledingshulpmiddel oop en soek die mouseplayer_session_url eienskap. Dit behoort u direk na die opname te neem.
  3. Maak in MousePlayer die Gebruikersverkenneroop. Sessies met 'n identiteit wys dit in plaas van die gegenereerde besoekerbynaam.

As niks verskyn nie

  • Die eienskap ontbreek op alle gebeure: kontroleer dat die ontledings-SDK werklik op die bladsy laai en dat u die regte platform gekies het. 'n PostHog-keuse sal nie Mixpanel lees nie.
  • Die eienskap verskyn net op latere gebeure: dit word verwag; sien die nota in afdeling 3.
  • Die URL is daar, maar die identiteit nie: u SDK het nog nie 'n distinct_id toegeken nie, wat normaal is voordat 'n gebruiker geïdentifiseer is. Dit sal met 'n latere bladsylaai opgetel word.
  • U toets as aangemelde administrateur: sommige opstellings sluit interne verkeer uit. Probeer 'n private venster.

Alle handelsmerke wat hier genoem word, behoort aan hul onderskeie eienaars. MousePlayer het geen sakeverhouding met hierdie verskaffers nie.