PostHog-, Mixpanel- & Amplitude-híd

A termékanalitikai eszköz megmondja, mi történt. A MousePlayer megmutatja, miért. A híd mindkét irányban összekapcsolja őket, így a tölcsér lemorzsolódását magyarázó felvétel csak egy kattintásra van.

1. A probléma: arcok nélküli számok

A termékanalitika tölcsért ad: 1 000 felhasználó elérte a pénztárt, 620 elhagyta. Pontosan mér egy még láthatatlan problémát. A 620 felvételből néhány megtekintése általában percek alatt választ ad — de csak ha a diagramtól azonosítók exportja és kézi keresés nélkül eljut a megfelelő munkamenetekhez.

A Termékanalitikai híd megszünteti ezt a rést. Az mp.js részeként fut, és automatikusan összekapcsolja a két rendszert:

  • Kifelé: az analitikai eszköz minden rögzített eseményéhez tartozik egy mouseplayer_session_url tulajdonság. Nyisson meg egy eseményt, kattintson a linkre, nézze meg a munkamenetet.
  • Befelé: a látogató distinct_id értékét visszaolvassa és a MousePlayer-munkamenethez tárolja, így a felvételek a PostHogban, Mixpanelben vagy Amplitude-ban már használt azonosítóval kereshetők.

Nem kell kódot írni. A híd maga felismeri az analitikai SDK-t. Nem kell MousePlayer-függvényt hívnia vagy az eseménykövetést módosítania.

2. Aktiválás

A. módszer: irányítópult (kód nélkül)

  1. Nyissa meg a projektet, majd az Integrációk lapot.
  2. Állítsa a PostHog-, Mixpanel- & Amplitude-hidat erre: ON.
  3. Válassza ki a használt platformot. A változások automatikusan mentődnek.

A beállítás webhelye következő oldalbetöltésekor lép életbe. A meglévő munkameneteket nem érinti visszamenőleg.

B. módszer: kézi szkriptbeállítás

Ha közvetlenül a kódban állítaná be, adja meg a két értéket ebben: 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. Mi történik az egyes platformokon

Minden platform API-ja más, ezért a híd a megfelelő saját hívást használja. Ezt nem kell beállítania — a kiválasztott szolgáltatót követi.

PlatformKifelé (visszajátszási URL)Befelé (azonosító)
PostHog posthog.register() — szuper-tulajdonságként regisztrálva, így minden későbbi eseményhez hozzáadódik posthog.get_distinct_id()
Mixpanel mixpanel.register() — ugyanaz a szuper-tulajdonság működés mixpanel.get_distinct_id()
Amplitude setUserProperties() — felhasználói tulajdonságként beállítva getDeviceId(), régi SDK esetén getInstance().options.deviceId hívásra visszaváltva

Szuper-tulajdonság vagy felhasználói tulajdonság: a PostHogban és Mixpanelben a visszajátszás URL-je a későbbi eseményekhez kapcsolódik, így a híd indulása után minden eseményen megtalálható — az oldalbetöltés korábban elküldött eseményein nem.

4. Azonosítás: distinct_id értéktől a névvel ellátott munkamenetig

A bejövő irányt becsüli alá a legtöbb csapat. Nélküle a MousePlayer-munkamenetek névtelenek: megnézhetők, de nem válaszolható meg a kérés: „mutassa az előző héten lemorzsolódott fiók felvételeit.”

A híd aktiválása után az analitikai eszköz distinct_id értéke a munkamenet custom_user_id mezőjébe kerül — ugyanoda, ahová a kézi SDK-hívás ír:

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

Ha már maga hívja a mp('set') függvényt, tegye ezután is. A kifejezetten megadott azonosító megbízhatóbb, mert saját elsődleges kulcsa, nem böngészőnkénti analitikai azonosító.

Adatvédelmi megjegyzés: csak az analitikai eszköz által már kiosztott azonosítót továbbítjuk. Az SDK-ból nem olvasunk e-mail-címet, nevet vagy más személyes mezőt. Adatvédelmi tájékoztatója fedje le ezt a feldolgozást, és hozzájárulás mint jogalap esetén a hozzájáruláskezelővel blokkolja a követőszkriptet a beleegyezésig.

5. Technikai működés

Az analitikai SDK-k általában aszinkron töltődnek, gyakran akkor, amikor a mp.js már fut. Ezért egyetlen induláskori próbálkozás a legtöbb valódi webhelyen sikertelen lenne.

  • A híd 1,5 másodpercenként, legfeljebb tízszer próbálkozik, és amint mindkét irány elkészült, leáll.
  • A két irány egymástól függetlenül lezárul, így az azonosítóra várva a visszajátszási URL-t soha nem küldi kétszer.
  • Ha az SDK nem jelenik meg, a híd körülbelül 15 másodperc után csendben feladja. Nem ír a konzolba, a munkamenet-rögzítés változatlanul folytatódik.
  • A 128 karakternél hosszabb azonosítókat csonkolás helyett figyelmen kívül hagyjuk, hogy ne tároljunk semmivel nem egyező félazonosítót.

6. A működés ellenőrzése

  1. Nyissa meg webhelyét normál böngészőlapon, és röviden használja.
  2. Az analitikai eszközben nyissa meg a legújabb eseményt, és keresse a mouseplayer_session_url tulajdonságot. Megnyitása közvetlenül a felvételre kell vigye.
  3. A MousePlayerben nyissa meg a Felhasználó-böngészőt. Azonosított munkameneteknél a generált becenév helyett az azonosító látható.

Ha semmi nem jelenik meg

  • Minden eseményről hiányzik a tulajdonság: ellenőrizze, hogy az analitikai SDK tényleg betöltődik az oldalon, és a megfelelő platformot választotta-e. A PostHog-beállítás nem olvas Mixpanelt.
  • Csak a későbbi eseményeken jelenik meg a tulajdonság: ez a várt működés, lásd a 3. rész megjegyzését.
  • Az URL megvan, az azonosító nincs: az SDK még nem rendelt distinct_id értéket a felhasználóhoz, ami azonosítás előtt normális. Egy későbbi oldalbetöltéskor kiolvassuk.
  • Bejelentkezett adminisztrátorként tesztel: egyes beállítások kizárják a belső forgalmat. Próbáljon privát ablakot.

Az itt említett védjegyek a tulajdonosaikhoz tartoznak. A MousePlayer nem áll üzleti kapcsolatban ezekkel a szolgáltatókkal.