GTM- és GA4-eseményhíd

1. Architektúra & képességek áttekintése

A modern webanalitikában gyakori az alapvető adatelkülönülés: a mennyiségi platformok (például a Google Analytics 4) megmutatják, mi történt a webhelyen, a minőségi munkamenet-visszajátszó eszközök pedig elmagyarázzák, miért történt. A MousePlayer GTM- & GA4-híd ezt a rést a böngésző JavaScript-futtatókörnyezetén belüli kétirányú szinkronizációs csatornával szünteti meg.

Aktiváláskor a követőszkript két külön alapmodult indít el:

Munkamenet-visszajátszási exportáló (initGa4SessionBridge): A munkamenet létrejöttekor automatikusan a webhely adatrétegébe küldi az aktív felvétel munkamenet-azonosítóját (mp_session_id) és a közvetlen lejátszási URL-t (mp_session_url).
GA4-eseményfogadó (initDataLayerBridge): Az adatréteg tömbjéhez a meglévő működést nem módosító figyelőt kapcsol. A GA4-nek küldött minden egyedi e-kereskedelmi vagy viselkedési esemény azonnal egyedi eseményként (ce) tükröződik a MousePlayer analitikai adatbázisában, minden numerikus és szöveges paraméterével együtt.

Egyedi dataLayer objektum támogatása: Ha a webalkalmazás a szokásos dataLayer helyett egyedi JavaScript-tömbnevet használ (például xyzDataLayer), a motor kézi kódmódosítás nélkül igazodik a beállított gtm_datalayer_name paraméterhez.

2. Stratégiai üzleti érték

A munkamenet-visszajátszási linkek közvetlen beépítése a vállalati analitikai adatfolyamokba számos jelentős működési előnyt ad:

Üzleti képesség	Működési hatás
Konverziós arány optimalizálása (CRO)	A digitális elemzők azonosíthatják a GA4 konverziós tölcséreinek súrlódási pontjait, és azonnal elindíthatják az adott pénztári lépésnél kosarukat elhagyó felhasználók felvételeit.
Bevétel forrásának azonosítása & ellenőrzés	A nagy értékű e-kereskedelmi tranzakciók a vásárláshoz vezető pontos kurzorpályák, kattintások és láthatóterület-állapotok áttekintésével ellenőrizhetők.
Gyorsabb műszaki hibakeresés	A minőségbiztosítási mérnökök közvetlenül összekapcsolhatják a GA4 JavaScript-kivételeseményeit vagy az API-hibanaplókat a vizuális képernyőfelvételekkel, így nem kell kézzel reprodukálniuk a hibákat.
Ügyfélszolgálati problémamegoldás	A felhasználói munkamenet-azonosítókat tartalmazó támogatási jegyek alapján az ügyintézők megtekinthetik az ügyfél pontos munkamenet-visszajátszását, jelentősen csökkentve a megoldási időt.

3. Google Tag Manager beállítási útmutató

A visszajátszási URL Google Tag Managerben történő fogadásához és Google Analytics 4-be továbbításához három külön GTM-elemet kell beállítani:

1. lépés: adatréteg-változók létrehozása

A GTM munkaterületén lépjen ide: Változók → Felhasználó által definiált változók, és hozzon létre két ilyen típusú változót: Adatréteg-változó:

Változó neve: dlv - mp_session_id • Adatréteg-változó neve: mp_session_id
Változó neve: dlv - mp_session_url • Adatréteg-változó neve: mp_session_url

2. lépés: aktiválási feltétel létrehozása

Lépjen ide: Aktiválási feltételek → Új, és válassza ezt az aktiválásifeltétel-típust: Egyedi esemény. Állítsa be az alábbi paramétereket:

Esemény neve: mp_session_ready
Ez az aktiválási feltétel itt lép működésbe: Minden egyedi esemény

3. lépés: GA4-eseménycímke beállítása

Hozzon létre egy ilyen típusú új címkét: Google Analytics: GA4-esemény, amely a GA4-tulajdonnak továbbítja a munkamenet linkjét:

# GA4 Event Tag Configuration Tag Type: Google Analytics: GA4 Event Configuration Tag: [Select standard GA4 Configuration Tag] Event Name: mp_recording_ready # Event Parameters: | Parameter Name | Value | |-----------------|---------------------------| | mp_session_id | {{dlv - mp_session_id}} | | mp_session_url | {{dlv - mp_session_url}} | Triggering: Fire on Custom Event -> mp_session_ready

4. Felfedezések (egyedi jelentések) beállítása a GA4-ben

A GTM-címke közzététele után a GA4 eseményparaméterként kapja meg a lejátszási URL-t. Az adatok egyedi felfedezési jelentésekben történő elemzéséhez a paramétert előbb egyedi dimenzióként kell regisztrálni.

Egyedi dimenziók regisztrálása a GA4 Adminisztrálás részében

A Google Analytics 4 felületén lépjen ide: Adminisztrálás → Adatmegjelenítés → Egyedi definíciók, majd kattintson erre: Egyedi dimenzió létrehozása:

Dimenzió neve: MousePlayer Session URL
Hatókör: Esemény (vagy Munkamenet, ha munkamenetszintű paraméterekhez kapcsolódik)
Eseményparaméter: mp_session_url

Munkamenet-ellenőrzési felfedezés készítése

A GA4 Felfedezés részében hozzon létre új Szabad formátumú felfedezést az egyes felhasználói útvonalak vizsgálatához:

Sorok: Adja hozzá: Event name, Transaction ID (e-kereskedelem esetén), vagy Landing page.
Oszlopok / dimenziók: Vegye fel az újonnan létrehozott egyedi dimenziót: MousePlayer Session URL.
Értékek: Adja hozzá: Event count vagy Total users.

A létrejött jelentéstáblában a GA4 mutatói mellett közvetlenül kattintható URL-ek jelennek meg, így a statisztikai kiugrásokról azonnal a vizuális visszajátszásra léphet.

5. Visszajátszási URL-ek beépítése a GA4 alapértelmezett jelentéseibe

A Felfedezések mellett az egyedi dimenziók a GA4 szokásos alapértelmezett jelentéseibe (például Forgalomszerzés, Oldalak és képernyők vagy E-kereskedelmi vásárlások) is beépíthetők a GA4 jelentéskönyvtárával.

Szokásos jelentéstáblák módosítása

A GA4-ben nyisson meg egy alapértelmezett részletes jelentést (például Jelentések → Aktivitás → Oldalak és képernyők).
Kattintson a jobb felső sarokban lévő Jelentés személyre szabása ceruzaikonra (adminisztrátori hozzáférés szükséges).
A jobb oldali panelen a Jelentésadatok részben kattintson erre: Dimenziók.
Adja hozzá a MousePlayer Session URL elemet az elsődleges vagy másodlagos dimenziók listájához, és állítsa láthatóra.
Kattintson erre: Mentés → Módosítások mentése a jelenlegi jelentésbe.

Mentés után a szokásos forgalomszerzési vagy konverziós táblákat áttekintő elemzők a MousePlayer Session URL elemet másodlagos dimenzióként felvehetik, így a szokásos forgalmi szegmensekben azonnal vizuálisan vizsgálhatják a látogatói viselkedést.

6. JavaScript API & GA4-/GTM-kompatibilitási referencia

A MousePlayer könnyen használható, GA4-kompatibilis JavaScript API-t kínál (szokásos gtag() jellegű parancsokkal) és nyilvános globális objektumot (window.MousePlayer). A fejlesztők így a konzolban lekérdezhetik a munkamenetek URL-jét, B2B-ügyfélazonosítókat rendelhetnek hozzá, és visszajátszási linkeket illeszthetnek külső ügyfélszolgálati vagy hibakövető rendszerekbe.

1. Visszajátszási URL közvetlen beillesztése (Intercom / Zendesk / egyedi hidak)

Az aktív látogatói munkamenet teljes lejátszási URL-jét közvetlenül a böngészőkonzolból vagy bármely egyedi szkriptből lekérheti ezzel window.MousePlayer.getSessionUrl():

// Example: Retrieve the active session URL and attach it to Intercom chat metadata if (window.MousePlayer && window.MousePlayer.getSessionUrl) { var replayUrl = window.MousePlayer.getSessionUrl(); console.log('Active Replay:', replayUrl); // Attach to Intercom Messenger metadata if (window.Intercom) { Intercom('update', { 'mouseplayer_replay_url': replayUrl }); } }

2. Egyedi B2B-ügyfélazonosítók beállítása (user_id)

A bejelentkezett SaaS- vagy B2B-ügyfelek azonosításához egyedi user_id értéket (például adatbázis-azonosítót, e-mail-címet vagy UUID-t) adhat át a szkript kezdeti beállításakor vagy dinamikusan, futás közben GA4-szintaxissal:

// Method A: Set user_id dynamically at login (GA4 / gtag style) mp('set', 'user_id', 'USR-987654'); // Method B: Set via config object mp('config', 'YOUR_CHANNEL_ID', { user_id: 'USR-987654' }); // Method C: Direct SDK invocation window.MousePlayer.setUserId('USR-987654');

3. Aszinkron adatlekérési módszerek

A munkamenetek metaadatait szokásos GA4-visszahívási szintaxissal, aszinkron kérheti le egyedi címkekezelő szkriptekben:

// Retrieve active session URL mp('get', 'session_url', function(url) { console.log('Session URL:', url); }); // Retrieve visitor ID (Client ID equivalent) mp('get', 'client_id', function(clientId) { console.log('Visitor ID:', clientId); });

Miben segíthetünk?