Koppeling met PostHog, Mixpanel & Amplitude

1. Het probleem: cijfers zonder gezicht

Productanalyse geeft u een trechter: 1.000 gebruikers bereikten het afrekenen, 620 haakten af. Dat is een precieze meting van een probleem dat u nog steeds niet ziet. Een handvol van die 620 opnames bekijken beantwoordt de vraag meestal binnen enkele minuten — maar alleen als u van de grafiek bij de juiste sessies komt zonder ID’s te exporteren en met de hand te zoeken.

De koppeling met productanalyse dicht dat gat. Ze draait binnen mp.js en verbindt de twee systemen automatisch:

Uitgaand: elke gebeurtenis die uw analysetool vastlegt, krijgt een eigenschap mouseplayer_session_url. Open een willekeurige gebeurtenis, klik op de link en bekijk de sessie.
Inkomend: de distinct_id van de bezoeker wordt teruggelezen en bij de MousePlayer-sessie opgeslagen, zodat opnames doorzoekbaar worden op dezelfde identiteit die u al in PostHog, Mixpanel of Amplitude gebruikt.

Geen code nodig. De koppeling herkent de analytics-SDK zelf. U roept geen enkele MousePlayer-functie aan en hoeft niets te veranderen aan hoe u gebeurtenissen bijhoudt.

2. Activering

Methode A: dashboard (zonder code)

Open uw project en ga naar het tabblad Integraties.
Zet Koppeling met PostHog, Mixpanel & Amplitude op ON.
Kies het platform dat u gebruikt. Wijzigingen worden automatisch opgeslagen.

De instelling werkt vanaf de volgende keer dat een pagina van uw website wordt geladen. Bestaande sessies worden niet met terugwerkende kracht aangepast.

Methode B: handmatige scriptconfiguratie

Wilt u het liever vast in de code zetten, stel dan de twee waarden in binnen window.mp_config:

<script> window.mp_config = { channel: 'YOUR_CHANNEL_ID', analytics_bridge_active: true, analytics_provider: 'posthog' // 'posthog', 'mixpanel' or 'amplitude' }; </script>

3. Wat er per platform gebeurt

Elk platform biedt een andere API, dus de koppeling gebruikt voor elk de gebruikelijke aanroep. U hoeft dit niet te configureren — het volgt uit uw keuze van de aanbieder.

Platform	Uitgaand (URL van de weergave)	Inkomend (identiteit)
PostHog	`posthog.register()` — geregistreerd als super property, zodat het aan elke volgende gebeurtenis wordt gekoppeld	`posthog.get_distinct_id()`
Mixpanel	`mixpanel.register()` — hetzelfde gedrag als super property	`mixpanel.get_distinct_id()`
Amplitude	`setUserProperties()` — ingesteld als user property	`getDeviceId()`, met terugval op `getInstance().options.deviceId` bij de oudere SDK

Super property tegenover user property: in PostHog en Mixpanel wordt de URL van de weergave vanaf dat moment aan gebeurtenissen gekoppeld; u vindt hem dus bij elke gebeurtenis die wordt verstuurd nadat de koppeling is geïnitialiseerd — niet bij gebeurtenissen die al eerder tijdens het laden van de pagina zijn verstuurd.

4. Identiteit: van distinct_id naar een sessie met een naam

De inkomende helft is het deel dat de meeste teams onderschatten. Zonder die helft zijn MousePlayer-sessies anoniem: u kunt ze bekijken, maar u kunt niet antwoorden op “laat me de opnames zien van het account dat vorige week is opgezegd.”

Zodra de koppeling actief is, wordt de distinct_id uit uw analysetool in het veld custom_user_id van de sessie geschreven — hetzelfde veld waarin ook de handmatige SDK-aanroep schrijft:

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

Roept u mp('set') al zelf aan, blijf dat dan doen. Een identiteit die u expliciet aanlevert, is betrouwbaarder, omdat het uw eigen primaire sleutel is in plaats van een analytics-ID per browser.

Privacyopmerking: alleen de ID die uw analysetool al heeft toegekend, wordt overgedragen. Er wordt geen e-mailadres, naam of ander persoonlijk veld uit de SDK gelezen. Zorg dat uw eigen privacyverklaring deze verwerking dekt, en laat het trackingscript pas via uw toestemmingstool laden als u toestemming als rechtsgrond gebruikt.

5. Technisch gedrag

Analytics-SDK’s worden meestal asynchroon geladen, vaak pas nadat mp.js al draait. Eén enkele poging bij het starten zou daarom op de meeste echte websites mislukken.

De koppeling probeert het elke 1,5 seconde opnieuw, tot tien keer toe, en stopt zodra beide richtingen zijn afgerond.
Elke richting wordt los van de andere afgerond, zodat de URL van de weergave nooit twee keer wordt verstuurd terwijl er op een identiteit wordt gewacht.
Verschijnt de SDK nooit, dan geeft de koppeling het na ongeveer 15 seconden stilzwijgend op. Er wordt niets naar de console geschreven en de sessie-opname gaat ongehinderd door.
ID’s van meer dan 128 tekens worden genegeerd in plaats van ingekort, om te voorkomen dat een halve ID wordt opgeslagen die nergens mee zou overeenkomen.

6. Controleren of het werkt

Open uw website in een normaal browsertabblad en gebruik haar even.
Open in uw analysetool de nieuwste gebeurtenis en zoek de eigenschap mouseplayer_session_url. Als u die opent, komt u direct bij de opname.
Open in MousePlayer de Gebruikersverkenner. Sessies met een identiteit tonen die in plaats van de gegenereerde bijnaam van de bezoeker.

Als er niets verschijnt

De eigenschap ontbreekt bij alle gebeurtenissen: controleer of de analytics-SDK echt op de pagina laadt en of u het bijbehorende platform hebt gekozen. Met PostHog als keuze wordt Mixpanel niet gelezen.
De eigenschap verschijnt alleen bij latere gebeurtenissen: dat is te verwachten, zie de opmerking in sectie 3.
De URL is er, maar de identiteit niet: uw SDK heeft nog geen distinct_id toegekend, wat normaal is voordat een gebruiker is geïdentificeerd. Die wordt bij een later laden van een pagina opgepikt.
U test als ingelogde beheerder: sommige configuraties sluiten intern verkeer uit. Probeer een privévenster.

Waarmee kunnen we helpen?