Ura PostHog, Mixpanel & Amplitude

Mjeti juaj i analitikës së produktit ju tregon çfarë ndodhi. MousePlayer ju tregon pse. Kjo urë i lidh të dyja në të dy drejtimet, që një largim nga hinka të jetë një klikim larg regjistrimit që e shpjegon.

1. Problemi: Numra pa fytyra

Analitika e produktit ju jep një hinkë: 1,000 përdorues arritën te përfundimi i blerjes, 620 e braktisën. Kjo është matje e saktë e një problemi që ende nuk mund ta shihni. Shikimi i disa prej atyre 620 regjistrimeve zakonisht i përgjigjet pyetjes brenda minutash — por vetëm nëse mund të kaloni nga grafiku te seancat e duhura pa eksportuar ID dhe pa kërkuar manualisht.

Ura e analitikës së produktit e heq atë boshllëk. Ekzekutohet brenda mp.js dhe i lidh automatikisht të dy sistemet:

  • Drejt daljes: çdo ngjarje që regjistron mjeti juaj analitik mbart një mouseplayer_session_url si veti. Hapni një ngjarje, klikoni lidhjen, shikoni seancën.
  • Drejt hyrjes: identifikuesi i vizitorit distinct_id lexohet dhe ruhet në seancën MousePlayer, që regjistrimet të bëhen të kërkueshme me të njëjtin identitet që përdorni tashmë në PostHog, Mixpanel ose Amplitude.

Nuk kërkohet kod. Ura e zbulon vetë SDK-në analitike. Nuk thërrisni asnjë funksion MousePlayer dhe nuk keni pse të ndryshoni mënyrën e ndjekjes së ngjarjeve.

2. Aktivizimi

Mënyra A: Paneli (pa kod)

  1. Hapni projektin tuaj dhe shkoni te Integrime në skedat e projektit.
  2. Aktivizoni Urën PostHog, Mixpanel & Amplitude duke zgjedhur ON.
  3. Zgjidhni platformën që përdorni. Ndryshimet ruhen automatikisht.

Cilësimi hyn në fuqi në ngarkimin e ardhshëm të faqes së sajtit tuaj. Seancat ekzistuese nuk preken në mënyrë prapavepruese.

Mënyra B: Konfigurim manual i skriptit

Nëse parapëlqeni ta shkruani drejtpërdrejt në kod, vendosni dy vlerat brenda 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. Çfarë ndodh për çdo platformë

Çdo platformë ofron API të ndryshme, ndaj ura përdor thirrjen e përshtatshme për secilën. Nuk keni nevojë ta konfiguroni këtë — ndjek përzgjedhjen tuaj të ofruesit.

PlatformaDrejt daljes (URL-ja e riprodhimit)Drejt hyrjes (identiteti)
PostHog posthog.register() — regjistruar si super property, që t'i bashkëngjitet çdo ngjarjeje pasuese posthog.get_distinct_id()
Mixpanel mixpanel.register() — e njëjta sjellje super property mixpanel.get_distinct_id()
Amplitude setUserProperties() — vendosur si veti përdoruesi getDeviceId(), duke kaluar te getInstance().options.deviceId në SDK-në e vjetër

Super property kundrejt vetisë së përdoruesit: në PostHog dhe Mixpanel URL-ja e riprodhimit u bashkëngjitet ngjarjeve nga ai moment e tutje, ndaj do ta gjeni në çdo ngjarje të aktivizuar pas inicializimit të urës — jo në ngjarjet që janë dërguar më herët gjatë ngarkimit të faqes.

4. Identiteti: Nga distinct_id te një seancë e emërtuar

Gjysma hyrëse është pjesa që shumica e ekipeve e nënvlerësojnë. Pa të, seancat MousePlayer janë anonime: mund t'i shihni, por nuk mund t'i përgjigjeni kërkesës „më trego regjistrimet e llogarisë që u largua përfundimisht javën e kaluar.“

Pasi ura është aktive, identifikuesi distinct_id nga mjeti juaj analitik shkruhet në fushën custom_user_id të seancës — e njëjta fushë ku shkruan thirrja manuale SDK:

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

Nëse tashmë thërrisni mp('set') vetë, vazhdoni ta bëni. Një identitet që e jepni shprehimisht është më i besueshëm, sepse është çelësi juaj kryesor dhe jo një identifikues analitik për çdo shfletues.

Shënim privatësie: transferohet vetëm identifikuesi që mjeti juaj analitik ka caktuar tashmë. Nga SDK-ja nuk lexohet adresë emaili, emër ose fushë tjetër personale. Sigurohuni që politika juaj e privatësisë ta mbulojë këtë përpunim dhe bllokojeni skriptin e ndjekjes me mjetin tuaj të pëlqimit nëse mbështeteni te pëlqimi si bazë ligjore.

5. Sjellja teknike

SDK-të analitike zakonisht ngarkohen në mënyrë asinkrone, shpesh pasi mp.js është tashmë në punë. Prandaj një përpjekje e vetme gjatë nisjes do të dështonte në shumicën e sajteve reale.

  • Ura riprovon çdo 1.5 sekonda, deri në dhjetë herë, dhe ndalon sapo të dy drejtimet të kenë përfunduar.
  • Çdo drejtim përfundon në mënyrë të pavarur, ndaj URL-ja e riprodhimit nuk dërgohet kurrë dy herë ndërsa pritet shfaqja e një identiteti.
  • Nëse SDK-ja nuk shfaqet kurrë, ura heq dorë në heshtje pas rreth 15 sekondash. Nuk shkruhet asgjë në konsolë dhe regjistrimi i seancës vazhdon pa u prekur.
  • Identifikuesit më të gjatë se 128 karaktere shpërfillen në vend që të shkurtohen, për të shmangur ruajtjen e gjysmës së një identifikuesi që nuk do të përputhej kurrë me asgjë.

6. Verifikimi i funksionimit

  1. Hapni sajtin tuaj në një skedë normale shfletuesi dhe ndërveproni shkurt me të.
  2. Në mjetin tuaj analitik, hapni ngjarjen më të re dhe kërkoni vetinë mouseplayer_session_url përkatëse. Hapja e saj duhet t'ju çojë drejtpërdrejt te regjistrimi.
  3. Në MousePlayer, hapni User Explorer. Seancat që mbartin identitet e shfaqin atë në vend të pseudonimit të gjeneruar të vizitorit.

Nëse nuk shfaqet asgjë

  • Vetia mungon në të gjitha ngjarjet: kontrolloni që SDK-ja analitike ngarkohet vërtet në faqe dhe që keni zgjedhur platformën përkatëse. Përzgjedhja PostHog nuk lexon Mixpanel.
  • Vetia shfaqet vetëm në ngjarjet e mëvonshme: kjo pritet, shihni shënimin në seksionin 3.
  • URL-ja është aty, por identiteti jo: SDK-ja juaj ende nuk ka caktuar një distinct_id deri tani; kjo është normale para identifikimit të një përdoruesi. Do të merret në një ngarkim të mëvonshëm të faqes.
  • Po testoni si administrator i identifikuar: disa konfigurime përjashtojnë trafikun e brendshëm. Provoni një dritare private.

Të gjitha markat tregtare të përmendura këtu u përkasin pronarëve përkatës. MousePlayer nuk ka marrëdhënie tregtare me këta ofrues.