Punte GTM & punte de evenimente GA4

Unificarea telemetriei cantitative Google Analytics 4 cu redările calitative MousePlayer prin sincronizare bidirecțională dataLayer și API-uri compatibile GA4.

1. Arhitectură & capacități

Analiza web modernă suferă adesea de izolarea datelor: platformele cantitative (precum Google Analytics 4) raportează ce s-a întâmplat pe site, iar instrumentele calitative de redare explică de ce s-a întâmplat. Puntea GTM & GA4 MousePlayer elimină golul printr-un canal bidirecțional de sincronizare în mediul JavaScript al browserului.

La activare, scriptul inițializează două module principale dedicate:

  • Exportatorul redării sesiunii (initGa4SessionBridge): Trimite automat identificatorul sesiunii active de înregistrare (mp_session_id) și URL-ul direct de redare (mp_session_url) în stratul de date al site-ului imediat ce sesiunea este stabilită.
  • Colectorul de evenimente GA4 (initDataLayerBridge): Atașează un ascultător nedistructiv tabloului stratului de date. Orice eveniment comercial sau comportamental personalizat trimis pentru GA4 este copiat imediat în baza de analiză MousePlayer ca eveniment personalizat (ce), cu toți parametrii numerici și textuali.

Suport pentru obiect dataLayer personalizat: Dacă aplicația folosește un nume personalizat pentru tabloul JavaScript în loc de cel standard dataLayer (de exemplu, xyzDataLayer), motorul se adaptează dinamic la parametrul configurat gtm_datalayer_name fără modificări manuale ale codului.

2. Valoare strategică pentru afacere

Integrarea directă a linkurilor de redare în fluxurile analitice ale companiei aduce avantaje operaționale importante:

Capacitate de afaceri Impact operațional
Optimizarea ratei de conversie (CRO) Analiștii identifică punctele de fricțiune în pâlniile GA4 și deschid imediat înregistrările celor care au abandonat coșul la pași concreți ai comenzii.
Atribuirea veniturilor & audit Tranzacțiile comerciale valoroase pot fi auditate analizând traseele exacte ale cursorului, clicurile și stările zonei vizibile care au condus la achiziție.
Depanare tehnică accelerată Echipele QA pot corela excepțiile JavaScript GA4 sau jurnalele erorilor API direct cu înregistrările vizuale, fără reproducerea manuală a erorilor.
Rezolvarea solicitărilor de asistență Solicitările care includ ID-ul sesiunii permit agenților să vadă redarea exactă a clientului, reducând semnificativ timpul de rezolvare.

3. Ghid de configurare Google Tag Manager

Pentru a colecta URL-ul redării în Google Tag Manager și a-l trimite în Google Analytics 4, configurați trei componente GTM:

Pasul 1: creați variabilele stratului de date

În spațiul de lucru GTM, mergeți la Variabile → Variabile definite de utilizator și creați două variabile de tip Variabilă de strat de date:

  • Numele variabilei: dlv - mp_session_id • Numele variabilei stratului de date: mp_session_id
  • Numele variabilei: dlv - mp_session_url • Numele variabilei stratului de date: mp_session_url

Pasul 2: creați declanșatorul de activare

Mergeți la Declanșatoare → Nou și selectați tipul Eveniment personalizat. Configurați parametrii:

  • Numele evenimentului: mp_session_ready
  • Acest declanșator se activează la: Toate evenimentele personalizate

Pasul 3: configurați eticheta evenimentului GA4

Creați o etichetă nouă de tip Google Analytics: Eveniment GA4 pentru a transmite linkul sesiunii către proprietatea GA4:

# 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. Configurarea explorărilor (rapoarte personalizate) în GA4

După publicarea etichetei GTM, GA4 primește URL-ul redării ca parametru de eveniment. Pentru analiza în explorări personalizate, parametrul trebuie mai întâi înregistrat ca dimensiune personalizată.

Înregistrarea dimensiunilor personalizate în administrarea GA4

În Google Analytics 4, mergeți la Administrare → Afișarea datelor → Definiții personalizate și apăsați Creați dimensiune personalizată:

  • Numele dimensiunii: MousePlayer Session URL
  • Domeniu: Eveniment (sau Sesiune dacă se atașează parametrilor la nivel de sesiune)
  • Parametru de eveniment: mp_session_url

Creați o explorare pentru inspectarea sesiunii

În secțiunea Explorare din GA4, creați o explorare nouă Formă liberă pentru inspectarea parcursurilor individuale:

  • Rânduri: Adăugați Event name, Transaction ID (pentru comerț electronic) sau Landing page.
  • Coloane / Dimensiuni: Includeți dimensiunea personalizată nouă MousePlayer Session URL.
  • Valori: Adăugați Event count sau Total users.

Tabelul generat afișează URL-uri direct accesibile lângă indicatorii GA4, pentru trecerea imediată de la abateri statistice la redări vizuale.

5. URL-uri de redare în rapoartele GA4 implicite

Pe lângă explorări, dimensiunile personalizate pot fi incluse în rapoarte GA4 standard (precum Achiziție de trafic, Pagini și ecrane sau Achiziții de comerț electronic) folosind biblioteca de rapoarte GA4.

Modificarea tabelelor standard

  1. În GA4, deschideți orice raport detaliat implicit (de ex. Rapoarte → Implicare → Pagini și ecrane).
  2. Apăsați pictograma creion Personalizați raportul din dreapta sus (necesită acces administrativ).
  3. În panoul din dreapta, la Datele raportului, apăsați Dimensiuni.
  4. Adăugați MousePlayer Session URL în lista dimensiunilor principale sau secundare și setați ca vizibilă.
  5. Apăsați Salvați → Salvați modificările raportului curent.

După salvare, analiștii rapoartelor standard de achiziție sau conversie pot adăuga MousePlayer Session URL ca dimensiune secundară, inspectând imediat vizual comportamentul vizitatorilor în segmentele standard de trafic.

6. API JavaScript & compatibilitate GA4 / GTM

MousePlayer oferă un API JavaScript intuitiv, compatibil GA4 (cu comenzi standard de tip gtag()) și un obiect global public (window.MousePlayer). Dezvoltatorii pot cere URL-uri de sesiune în consolă, atașa ID-uri de clienți B2B și insera linkuri de redare în sisteme de asistență sau de erori ale terților.

1. Inserarea directă a URL-ului redării (Intercom / Zendesk / punți proprii)

Preluați URL-ul complet al redării sesiunii active direct din consola browserului sau dintr-un script propriu prin 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. Setarea ID-urilor proprii de clienți B2B (user_id)

Pentru clienții SaaS sau B2B autentificați, transmiteți un identificator propriu user_id (precum ID din baza de date, e-mail sau UUID), la configurarea inițială sau dinamic, folosind sintaxa GA4:

// 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. Metode asincrone de preluare a datelor

Folosiți sintaxa standard GA4 pentru callback pentru a prelua asincron metadatele sesiunii în scripturi proprii de gestionare a etichetelor:

// 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); });

Toate mărcile menționate aici aparțin proprietarilor lor. MousePlayer nu are relații comerciale cu acești furnizori.