Brygga för PostHog, Mixpanel & Amplitude

Ditt produktanalysverktyg visar vad som hände. MousePlayer visar varför. Bryggan kopplar ihop dem i båda riktningarna, så att ett bortfall i en tratt bara är ett klick från inspelningen som förklarar det.

1. Problemet: siffror utan ansikten

Produktanalys ger dig en tratt: 1 000 användare nådde kassan och 620 övergav den. Det är en exakt mätning av ett problem du fortfarande inte kan se. Några av dessa 620 inspelningar brukar besvara frågan på några minuter — men bara om du kan gå från diagrammet till rätt sessioner utan att exportera ID:n och söka manuellt.

Vår brygga för produktanalys överbryggar glappet. Den körs i mp.js och kopplar automatiskt ihop systemen:

  • Utgående: varje händelse som ditt analysverktyg registrerar får egenskapen mouseplayer_session_url. Öppna valfri händelse, klicka på länken och se sessionen.
  • Inkommande: besökarens distinct_id läses tillbaka och sparas i MousePlayer-sessionen, så att inspelningar blir sökbara med samma identitet som du redan använder i PostHog, Mixpanel eller Amplitude.

Ingen kod behövs. Bryggan upptäcker analysverktygets SDK automatiskt. Du behöver varken anropa någon MousePlayer-funktion eller ändra hur du spårar händelser.

2. Aktivering

Metod A: dashboarden (utan kod)

  1. Öppna projektet och gå till fliken Integrationer.
  2. Ställ Brygga för PostHog, Mixpanel & Amplitude på ON.
  3. Välj plattformen du använder. Ändringarna sparas automatiskt.

Inställningen gäller från nästa sidladdning på din webbplats. Befintliga sessioner påverkas inte retroaktivt.

Metod B: manuell skriptkonfiguration

Om du föredrar att hårdkoda det anger du de två värdena i 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. Vad som händer per plattform

Varje plattform har ett eget API, så bryggan använder det anrop som passar respektive plattform. Detta kräver ingen konfiguration — det följer ditt val av leverantör.

PlattformUtgående (uppspelnings-URL)Inkommande (identitet)
PostHog posthog.register() — registreras som en super property och bifogas därför varje efterföljande händelse posthog.get_distinct_id()
Mixpanel mixpanel.register() — samma beteende för super property mixpanel.get_distinct_id()
Amplitude setUserProperties() — anges som en användaregenskap getDeviceId(), med getInstance().options.deviceId som reserv i äldre SDK-versioner

Super property kontra användaregenskap: i PostHog och Mixpanel bifogas uppspelningslänken till kommande händelser. Du hittar den därför i varje händelse som skickas efter att bryggan initierats — inte i händelser som redan skickats tidigare under sidladdningen.

4. Identitet: från distinct_id till en namngiven session

Den inkommande delen underskattas av de flesta team. Utan den är MousePlayer-sessioner anonyma. Du kan se dem men inte svara på frågan ”visa inspelningarna för kontot som slutade använda tjänsten förra veckan.”

När bryggan är aktiv skrivs distinct_id från ditt analysverktyg till fältet custom_user_id i sessionen — samma fält som det manuella SDK-anropet skriver till:

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

Om du redan anropar mp('set') själv ska du fortsätta med det. En identitet som du uttryckligen anger är mer tillförlitlig, eftersom den är din egen primärnyckel i stället för en analysidentifierare per webbläsare.

Integritetsinformation: bara identifieraren som analysverktyget redan har tilldelat överförs. Ingen e-postadress, inget namn och inga andra personfält läses från SDK:t. Se till att din integritetspolicy omfattar behandlingen och låt samtyckesverktyget blockera spårningsskriptet om du använder samtycke som rättslig grund.

5. Tekniskt beteende

Analys-SDK:er laddas oftast asynkront, ofta efter att mp.js redan körs. Ett enda försök vid start skulle därför misslyckas på de flesta verkliga webbplatser.

  • Bryggan försöker igen var 1,5 sekund, högst tio gånger, och slutar så snart båda riktningarna är klara.
  • Varje riktning avslutas separat, så uppspelningslänken skickas aldrig två gånger i väntan på en identitet.
  • Om SDK:t aldrig dyker upp slutar bryggan tyst efter cirka 15 sekunder. Inget skrivs i konsolen och sessionsinspelningen fortsätter opåverkad.
  • Identifierare längre än 128 tecken ignoreras i stället för att kortas. Då undviker vi att lagra en halv identifierare som aldrig skulle matcha något.

6. Kontrollera att det fungerar

  1. Öppna din webbplats i en vanlig webbläsarflik och interagera med den en kort stund.
  2. Öppna den senaste händelsen i ditt analysverktyg och leta efter egenskapen mouseplayer_session_url. Länken ska ta dig direkt till inspelningen.
  3. Öppna användarutforskaren i MousePlayer. Sessioner med en identitet visar den i stället för det genererade besökarnamnet.

Om inget visas

  • Egenskapen saknas i alla händelser: kontrollera att analys-SDK:t faktiskt laddas på sidan och att rätt plattform är vald. Valet PostHog läser inte Mixpanel.
  • Egenskapen visas bara i senare händelser: det är väntat, se anmärkningen i avsnitt 3.
  • URL:en finns men identiteten saknas: ditt SDK har ännu inte tilldelat något distinct_id, vilket är normalt innan en användare har identifierats. Det hämtas vid en senare sidladdning.
  • Du testar som inloggad administratör: vissa installationer utesluter intern trafik. Prova ett privat fönster.

Alla nämnda varumärken tillhör respektive ägare. MousePlayer har ingen affärsrelation med leverantörerna.