Bro til PostHog, Mixpanel & Amplitude

Dit produktanalyseværktøj fortæller dig hvad der skete. MousePlayer viser dig hvorfor. Denne bro forbinder de to i begge retninger, så der kun er ét klik fra frafald i en tragt til den optagelse, der forklarer det.

1. Problemet: Tal uden ansigter

Produktanalyse giver dig en tragt: 1.000 brugere nåede kassen, 620 forlod den. Det er en præcis måling af et problem, du stadig ikke kan se. Et kig på en håndfuld af de 620 optagelser besvarer normalt spørgsmålet på få minutter — men kun hvis du kan komme fra diagrammet til de rigtige sessioner uden at eksportere ID'er og søge manuelt.

Denne produktanalysebro fjerner hullet. Den kører inde i mp.js og forbinder automatisk de to systemer:

  • Udgående: hver hændelse, dit analyseværktøj optager, får en mouseplayer_session_url-egenskab. Åbn en hændelse, klik på linket, og se sessionen.
  • Indgående: den besøgendes distinct_id læses tilbage og gemmes i MousePlayer-sessionen, så optagelser kan søges frem med samme identitet, som du allerede bruger i PostHog, Mixpanel eller Amplitude.

Ingen kode nødvendig. Broen registrerer selv analyse-SDK'et. Du kalder ingen MousePlayer-funktion og behøver ikke ændre din hændelsessporing.

2. Aktivering

Metode A: Dashboard (uden kode)

  1. Åbn dit projekt, og gå til fanen Integrationer.
  2. Sæt Bro til PostHog, Mixpanel & Amplitude til ON.
  3. Vælg den platform, du bruger. Ændringer gemmes automatisk.

Indstillingen træder i kraft, næste gang dit websted indlæses. Eksisterende sessioner påvirkes ikke med tilbagevirkende kraft.

Metode B: Manuel scriptkonfiguration

Hvis du foretrækker at angive det direkte i koden, skal du sætte de to værdier 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. Hvad sker der på hver platform

Hver platform stiller sit eget API til rådighed, så broen bruger det passende kald for hver. Du behøver ikke konfigurere dette — det følger dit valg af udbyder.

PlatformUdgående (afspilnings-URL)Indgående (identitet)
PostHog posthog.register() — registreret som en super property, så den føjes til hver efterfølgende hændelse posthog.get_distinct_id()
Mixpanel mixpanel.register() — samme adfærd for super property mixpanel.get_distinct_id()
Amplitude setUserProperties() — angivet som en brugeregenskab getDeviceId(), med getInstance().options.deviceId som reserve på det ældre SDK

Super property kontra brugeregenskab: i PostHog og Mixpanel føjes afspilnings-URL'en til fremtidige hændelser, så du finder den på hver hændelse, der udløses efter broens initialisering — ikke på hændelser, som allerede er sendt tidligere under sidens indlæsning.

4. Identitet: Fra distinct_id til en navngivet session

Den indgående del er den, de fleste teams undervurderer. Uden den er MousePlayer-sessioner anonyme: du kan se dem, men du kan ikke besvare »vis mig optagelserne fra den konto, der faldt fra i sidste uge.«

Når broen er aktiv, skrives distinct_id fra dit analyseværktøj til sessionens custom_user_id-felt — samme felt, som det manuelle SDK-kald 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 kalder mp('set'), så fortsæt med det. En identitet, du angiver udtrykkeligt, er mere pålidelig, fordi den er din egen primærnøgle frem for en analyseidentifikator pr. browser.

Bemærkning om privatliv: kun den identifikator, dit analyseværktøj allerede har tildelt, overføres. Ingen e-mailadresse, navn eller andre personoplysninger læses fra SDK'et. Sørg for, at din egen privatlivspolitik omfatter denne behandling, og lad dit samtykkeværktøj blokere sporingsscriptet indtil samtykke, hvis samtykke er dit retsgrundlag.

5. Teknisk adfærd

Analyse-SDK'er indlæses normalt asynkront, ofte efter at mp.js allerede kører. Et enkelt forsøg ved opstart ville derfor mislykkes på de fleste rigtige websteder.

  • Broen forsøger igen hvert 1,5 sekund, op til ti gange, og stopper, så snart begge retninger er gennemført.
  • Hver retning afsluttes uafhængigt, så afspilnings-URL'en aldrig sendes to gange, mens der ventes på en identitet.
  • Hvis SDK'et aldrig dukker op, opgiver broen lydløst efter cirka 15 sekunder. Intet skrives i konsollen, og sessionsoptagelsen fortsætter upåvirket.
  • Identifikatorer over 128 tegn ignoreres i stedet for at blive afkortet, så der ikke gemmes en halv identifikator, som aldrig ville matche noget.

6. Kontrollér, at det virker

  1. Åbn dit websted i en almindelig browserfane, og brug det kort.
  2. Åbn den nyeste hændelse i dit analyseværktøj, og find mouseplayer_session_url-egenskaben. Når du åbner den, bør du komme direkte til optagelsen.
  3. Åbn brugeroversigten i MousePlayer. Sessioner med en identitet viser den i stedet for det genererede kaldenavn.

Hvis intet vises

  • Egenskaben mangler på alle hændelser: kontrollér, at analyse-SDK'et faktisk indlæses på siden, og at du har valgt den rigtige platform. Et valg af PostHog læser ikke Mixpanel.
  • Egenskaben vises kun på senere hændelser: det er forventet; se bemærkningen i afsnit 3.
  • URL'en findes, men identiteten mangler: dit SDK har endnu ikke tildelt et distinct_id, hvilket er normalt, før en bruger er identificeret. Det opfanges ved en senere sideindlæsning.
  • Du tester som indlogget administrator: nogle opsætninger udelukker intern trafik. Prøv et privat vindue.

Alle nævnte varemærker tilhører deres respektive ejere. MousePlayer har ingen forretningsforbindelse med disse udbydere.