Bro til PostHog, Mixpanel & Amplitude

Produktanalyseverktøyet forteller deg hva som skjedde. MousePlayer viser deg hvorfor. Denne broen kobler de to i begge retninger, slik at det bare er ett klikk fra frafall i en trakt til opptaket som forklarer det.

1. Problemet: Tall uten ansikter

Produktanalyse gir deg en trakt: 1 000 brukere kom til kassen, 620 forlot den. Det er en nøyaktig måling av et problem du fortsatt ikke kan se. Noen få av de 620 opptakene besvarer vanligvis spørsmålet på minutter — men bare hvis du kan gå fra diagrammet til riktige økter uten å eksportere ID-er og søke manuelt.

Denne produktanalysebroen fjerner gapet. Den kjører i mp.js og kobler automatisk de to systemene:

  • Utgående: hver hendelse analyseverktøyet registrerer, får en mouseplayer_session_url-egenskap. Åpne en hendelse, klikk på lenken og se økten.
  • Inngående: den besøkendes distinct_id leses tilbake og lagres på MousePlayer-økten, så opptak kan søkes opp med samme identitet som du allerede bruker i PostHog, Mixpanel eller Amplitude.

Ingen kode kreves. Broen oppdager analyse-SDK-et selv. Du kaller ingen MousePlayer-funksjon og trenger ikke endre hendelsessporingen.

2. Aktivering

Metode A: Dashbord (uten kode)

  1. Åpne prosjektet og gå til fanen Integrasjoner.
  2. Sett Bro til PostHog, Mixpanel & Amplitude til ON.
  3. Velg plattformen du bruker. Endringer lagres automatisk.

Innstillingen gjelder fra neste innlasting av nettstedet. Eksisterende økter påvirkes ikke tilbakevirkende.

Metode B: Manuell skriptkonfigurasjon

Foretrekker du å skrive det direkte i koden, angir du de to verdiene 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. Hva skjer på hver plattform

Hver plattform har sitt eget API, så broen bruker riktig kall for hver. Dette trenger du ikke konfigurere — det følger leverandørvalget.

PlattformUtgående (avspillings-URL)Inngående (identitet)
PostHog posthog.register() — registrert som en super property, slik at den legges til hver senere hendelse posthog.get_distinct_id()
Mixpanel mixpanel.register() — samme virkemåte for super property mixpanel.get_distinct_id()
Amplitude setUserProperties() — angitt som en brukeregenskap getDeviceId(), med getInstance().options.deviceId som reserve på eldre SDK

Super property og brukeregenskap: i PostHog og Mixpanel legges avspillings-URL-en til fremtidige hendelser, så den finnes på hver hendelse utløst etter at broen er initialisert — ikke på hendelser som allerede ble sendt tidligere under sideinnlastingen.

4. Identitet: Fra distinct_id til en navngitt økt

Den inngående delen undervurderes av de fleste team. Uten den er MousePlayer-økter anonyme: du kan se dem, men ikke besvare «vis meg opptakene fra kontoen som falt fra forrige uke.»

Når broen er aktiv, skrives distinct_id fra analyseverktøyet til øktens custom_user_id-felt — samme felt som det manuelle SDK-kallet skriver til:

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

Hvis du allerede selv kaller mp('set'), fortsett med det. En uttrykkelig angitt identitet er mer pålitelig, fordi den er din egen primærnøkkel fremfor en analyseidentifikator per nettleser.

Personvernmerknad: bare identifikatoren analyseverktøyet allerede har tildelt, overføres. Ingen e-postadresse, navn eller andre personfelt leses fra SDK-et. Sørg for at personvernerklæringen dekker behandlingen, og la samtykkeverktøyet blokkere sporingsskriptet til samtykke er gitt hvis samtykke er rettsgrunnlaget.

5. Teknisk virkemåte

Analyse-SDK-er lastes vanligvis asynkront, ofte etter at mp.js allerede kjører. Ett enkelt forsøk ved oppstart ville derfor mislyktes på de fleste virkelige nettsteder.

  • Broen prøver igjen hvert 1,5 sekund, opptil ti ganger, og stopper når begge retninger er fullført.
  • Hver retning avsluttes uavhengig, så avspillings-URL-en sendes aldri to ganger mens den venter på en identitet.
  • Hvis SDK-et aldri dukker opp, gir broen opp uten varsel etter omtrent 15 sekunder. Ingenting skrives i konsollen, og øktopptaket fortsetter upåvirket.
  • Identifikatorer over 128 tegn ignoreres fremfor å avkortes, så ingen halv identifikator som aldri matcher noe, lagres.

6. Kontroller at det virker

  1. Åpne nettstedet i en vanlig nettleserfane og bruk det kort.
  2. Åpne nyeste hendelse i analyseverktøyet og finn mouseplayer_session_url-egenskapen. Å åpne den skal ta deg direkte til opptaket.
  3. Åpne brukeroversikten i MousePlayer. Økter med identitet viser den i stedet for det genererte kallenavnet.

Hvis ingenting vises

  • Egenskapen mangler på alle hendelser: kontroller at analyse-SDK-et faktisk lastes på siden og at du har valgt riktig plattform. Valg av PostHog leser ikke Mixpanel.
  • Egenskapen vises bare på senere hendelser: det er forventet; se merknaden i avsnitt 3.
  • URL-en finnes, men identiteten mangler: SDK-et har ennå ikke tildelt en distinct_id, noe som er normalt før en bruker identifiseres. Den fanges opp ved en senere sideinnlasting.
  • Du tester som innlogget administrator: noen oppsett utelater intern trafikk. Prøv et privat vindu.

Alle nevnte varemerker tilhører sine respektive eiere. MousePlayer har ingen forretningsforbindelse med disse leverandørene.