PostHog-, Mixpanel- & Amplitude-Bréck

Äert Instrument fir d'Produitanalys seet Iech, wat geschitt ass. MousePlayer weist Iech, firwat. Dës Bréck verbënnt déi zwee a béid Richtungen, soudatt d'Opnam, déi en Ofbroch an engem Trichter erkläert, nëmmen ee Klick ewech ass.

1. De Problem: Zuelen ouni Gesiichter

D'Produitanalys gëtt Iech en Trichter: 1,000 Benotzer hunn d'Keess erreecht, 620 hunn ofgebrach. Dat ass eng genee Miessung vun engem Problem, deen Dir nach ëmmer net gesitt. E puer vun deenen 620 Opnamen ze kucken, beäntwert d'Fro meeschtens a Minutten — mee nëmmen, wann Dir vum Diagramm bei déi richteg Sessioune kënnt, ouni IDen ze exportéieren a manuell ze sichen.

D' Bréck fir d'Produitanalys schléisst dës Lück. Si leeft bannent mp.js a verbënnt déi zwee Systemer automatesch:

  • Eraus: All Event, deen Äert Analysinstrument späichert, dréit eng mouseplayer_session_url -Eegenschaft. Maacht e belibegen Event op, klickt de Link a kuckt d'Sessioun.
  • Eran: Dem Visiteur seng distinct_id gëtt zeréckgelies an an der MousePlayer-Sessioun gespäichert, soudatt Opnamen iwwer déiselwecht Identitéit sichbar ginn, déi Dir schonn a PostHog, Mixpanel oder Amplitude benotzt.

Kee Code erfuerderlech. D'Bréck erkennt den Analys-SDK selwer. Dir rufft keng MousePlayer-Funktioun op a musst net änneren, wéi Dir Eventer verfollegt.

2. Aktivéierung

Method A: Dashboard (ouni Code)

  1. Maacht Äre Projet op a gitt op de Reider Integratiounen .
  2. Setzt PostHog-, Mixpanel- & Amplitude-Bréck op ON.
  3. Wielt d'Plattform, déi Dir benotzt. Ännerunge ginn automatesch gespäichert.

D'Astellung wierkt beim nächste Luede vun Ärer Websäit. Bestoend Sessioune ginn net réckwierkend beaflosst.

Method B: Manuell Skriptkonfiguratioun

Wann Dir et léiwer fest am Code setzt, leet déi zwee Wäerter an window.mp_configfest:

<!-- 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 pro Plattform geschitt

All Plattform stellt eng aner API zur Verfügung; d'Bréck benotzt dofir fir all Plattform de passenden typeschen Opruff. Dir musst dat net konfiguréieren — et riicht sech no Ärer Wiel vum Ubidder.

PlattformEraus (Ofspill-URL)Eran (Identitéit)
PostHog posthog.register() — als Super Property registréiert, soudatt se un all spéideren Event ugehaange gëtt posthog.get_distinct_id()
Mixpanel mixpanel.register() — datselwecht Verhale mat enger Super Property mixpanel.get_distinct_id()
Amplitude setUserProperties() — als Benotzereegenschaft gesat getDeviceId(), mat Réckgrëff op getInstance().options.deviceId beim ale SDK

Super Property géint Benotzereegenschaft: A PostHog a Mixpanel gëtt d'Ofspill-URL un zukünfteg Eventer ugehaangen. Dir fannt se also op all Event, deen no der Initialiséierung vun der Bréck ausgeléist gëtt — net op Eventer, déi scho virdrun beim Luede vun der Säit verschéckt goufen.

4. Identitéit: Vun distinct_id zu enger benannter Sessioun

Deen Deel, deen Donnéeën erakritt, gëtt vun de meeschten Ekippen ënnerschat. Ouni e sinn d'MousePlayer-Sessiounen anonym: Dir kënnt se kucken, mee kënnt dës Ufro net beäntwerten: „Weis mir d'Opname vum Kont, deen d'lescht Woch ofgesprongen ass.“

Soubal d'Bréck aktiv ass, gëtt d' distinct_id aus Ärem Analysinstrument an d'Sessioun hire Feld custom_user_id geschriwwen — datselwecht Feld, an dat de manuelle SDK-Opruff schreift:

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

Wann Dir schonn mp('set') selwer oprufft, fuert domat virun. Eng Identitéit, déi Dir ausdrécklech ugitt, ass méi zouverlässeg, well et Ären eegene Primärschlëssel ass an net eng Analyskennung pro Browser.

Dateschutzhinweis: Nëmmen d'Kennung, déi Äert Analysinstrument scho verginn huet, gëtt iwwerdroen. Keng E-Mail-Adress, keen Numm a keen anert perséinlecht Feld gëtt aus dem SDK gelies. Suergt dofir, datt Är eege Dateschutzerklärung dës Veraarbechtung ofdeckt, a loosst de Verfollegungsskript duerch Äert Zoustëmmungsinstrument blockéieren, wann Dir Zoustëmmung als Rechtsgrondlag benotzt.

5. Technescht Verhalen

Analys-SDKe ginn normalerweis asynchron gelueden, dacks nodeems mp.js scho leeft. Een eenzege Versuch beim Start géif dofir op de meeschte richtege Websäite feel schloen.

  • D'Bréck probéiert et all 1.5 Sekonnen, bis zu zéng Mol, an hält op, soubal béid Richtungen ofgeschloss sinn.
  • All Richtung gëtt onofhängeg ofgeschloss, soudatt d'Ofspill-URL ni zweemol verschéckt gëtt, wärend op eng Identitéit gewaart gëtt.
  • Wann de SDK ni opdaucht, hält d'Bréck no ongeféier 15 Sekonnen ouni Meldung op. Et gëtt näischt an d'Konsole geschriwwen, an d'Sessiounsopnam leeft onbeaflosst weider.
  • Kennunge mat méi ewéi 128 Zeeche ginn ignoréiert amplaz gekierzt, fir net eng hallef Kennung ze späicheren, déi ni mat eppes iwwereneestëmme géif.

6. D'Funktioun iwwerpréiwen

  1. Maacht Är Websäit an engem normale Browserreider op an interagéiert kuerz domat.
  2. Maacht an Ärem Analysinstrument dee neisten Event op a sicht no der Eegenschaft mouseplayer_session_url . Wann Dir se opmaacht, sollt Dir direkt bei d'Opnam kommen.
  3. Maacht a MousePlayer den User Explorerop. Sessioune mat enger Identitéit weisen déi amplaz vum generéierte Spëtznumm vum Visiteur.

Wann näischt opdaucht

  • D'Eegenschaft feelt op allen Eventer: Kontrolléiert, ob den Analys-SDK tatsächlech op der Säit lued an ob Dir déi passend Plattform gewielt hutt. Wann PostHog gewielt ass, gëtt Mixpanel net gelies.
  • D'Eegenschaft erschéngt nëmmen op spéideren Eventer: Dat ass erwaart; kuckt den Hiweis an Abschnitt 3.
  • D'URL ass do, mee d'Identitéit feelt: Äre SDK huet nach keng distinct_id verginn, wat normal ass, éier e Benotzer identifizéiert gëtt. Si gëtt beim spéidere Luede vun enger Säit iwwerholl.
  • Dir test als ugemellten Administrateur: Verschidden Ariichtunge schléissen internen Trafic aus. Probéiert eng privat Fënster.

All hei genannt Marke gehéieren hire jeeweilege Besëtzer. MousePlayer huet keng Geschäftsbezéiung mat dësen Ubidder.