GTM- ja GA4-tapahtumasilta

1. Arkkitehtuurin yleiskuva & mahdollisuudet

Moderni verkkoanalytiikka kärsii usein perustavanlaatuisesta tietosiilosta: määrälliset alustat (kuten Google Analytics 4) kertovat, mitä sivustolla tapahtui, kun taas laadulliset istuntotoistotyökalut selittävät, miksi se tapahtui. MousePlayerin GTM- & GA4-silta poistaa aukon muodostamalla kaksisuuntaisen synkronointikanavan selaimen JavaScript-suoritusympäristöön.

Käyttöönotossa seurantaskripti alustaa kaksi erillistä ydinmoduulia:

Istuntotoiston viejä (initGa4SessionBridge): Lähettää aktiivisen tallennusistunnon tunnuksen (mp_session_id) ja suoran toisto-URL:n (mp_session_url) sivuston datakerrokseen heti istunnon muodostuttua.
GA4-tapahtumien vastaanottaja (initDataLayerBridge): Liittää datakerroksen taulukkoon sen toimintaa muuttamattoman kuuntelijan. Jokainen GA4-palvelulle lähetetty mukautettu verkkokauppa- tai käyttäytymistapahtuma kopioidaan heti MousePlayerin analyysitietokantaan mukautettuna tapahtumana (ce), kaikki numero- ja tekstiparametrit mukana.

Mukautetun dataLayer-objektin tuki: Jos verkkosovellus käyttää mukautettua JavaScript-taulukon nimeä vakionimen dataLayer sijaan (esimerkiksi xyzDataLayer), moottori mukautuu dynaamisesti määritettyyn gtm_datalayer_name-parametriin ilman käsin tehtäviä koodimuutoksia.

2. Strateginen liiketoiminta-arvo

Istuntotoistolinkkien liittäminen suoraan yrityksen analyysiputkiin tuo useita merkittäviä käytännön etuja:

Liiketoimintamahdollisuus	Vaikutus toimintaan
Konversioasteen optimointi (CRO)	Analyytikot voivat tunnistaa GA4-konversiosuppilon kitkakohdat ja avata heti tallenteet käyttäjistä, jotka hylkäsivät ostoskorin tietyssä kassavaiheessa.
Liikevaihdon kohdistaminen & tarkastus	Arvokkaat verkkokauppatapahtumat voidaan tarkastaa katsomalla ostoon johtaneet tarkat osoitinpolut, klikkaukset ja näkyvän alueen tilat.
Nopeampi tekninen virheenkorjaus	Laadunvarmistustiimit voivat yhdistää GA4:n JavaScript-poikkeukset tai API-virhelokit suoraan visuaalisiin näyttötallenteisiin ilman virheen toistamista käsin.
Asiakastuen ratkaisut	Käyttäjän istuntotunnuksen sisältävä tukipyyntö antaa asiakaspalvelijan katsoa tarkan istuntotoiston ja lyhentää ratkaisuaikaa huomattavasti.

3. Google Tag Managerin määritysohje

Toisto-URL:n kerääminen Google Tag Managerissa ja reititys Google Analytics 4:ään vaatii kolme erillistä GTM-määritystä:

Vaihe 1: luo datakerrosmuuttujat

Siirry GTM-työtilassa kohtaan Muuttujat → Käyttäjän määrittämät muuttujat ja luo kaksi muuttujaa, joiden tyyppi on Datakerrosmuuttuja:

Muuttujan nimi: dlv - mp_session_id • Datakerrosmuuttujan nimi: mp_session_id
Muuttujan nimi: dlv - mp_session_url • Datakerrosmuuttujan nimi: mp_session_url

Vaihe 2: luo aktivointilaukaisin

Siirry kohtaan Laukaisimet → Uusi ja valitse laukaisintyypiksi Mukautettu tapahtuma. Määritä seuraavat parametrit:

Tapahtuman nimi: mp_session_ready
Tämä laukaisin käynnistyy: Kaikista mukautetuista tapahtumista

Vaihe 3: määritä GA4-tapahtumatunniste

Luo uusi tunniste tyyppiä Google Analytics: GA4-tapahtuma istuntolinkin lähettämiseksi GA4-omaisuuteen:

# 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. Tutkimusten (mukautettujen raporttien) määritys GA4-palvelussa

GTM-tunnisteen julkaisun jälkeen GA4 alkaa vastaanottaa toisto-URL:n tapahtumaparametrina. Mukautettuja tutkimusraportteja varten parametri täytyy ensin rekisteröidä mukautetuksi ulottuvuudeksi.

Mukautettujen ulottuvuuksien rekisteröinti GA4-hallinnassa

Siirry Google Analytics 4:ssä kohtaan Järjestelmänvalvoja → Tietojen näyttö → Mukautetut määritykset ja napsauta Luo mukautettu ulottuvuus:

Ulottuvuuden nimi: MousePlayer Session URL
Laajuus: Tapahtuma (tai Istunto jos liitetään istuntolaajuisiin parametreihin)
Tapahtumaparametri: mp_session_url

Luo tutkimus istunnon tarkasteluun

GA4:n osiossa Tutki luo uusi Vapaa muoto -tutkimus yksittäisten kävijäpolkujen tarkasteluun:

Rivit: Lisää Event name, Transaction ID (verkkokauppaan) tai Landing page.
Sarakkeet / ulottuvuudet: Lisää juuri luotu mukautettu ulottuvuus MousePlayer Session URL.
Arvot: Lisää Event count tai Total users.

Raporttitaulukko näyttää suoraan klikattavat URL-osoitteet GA4-mittareiden vieressä, joten tilastopoikkeamasta pääsee heti visuaaliseen toistoon.

5. Toisto-URL:t GA4:n vakioraporteissa

Tutkimusten lisäksi mukautetut ulottuvuudet voidaan liittää GA4:n tavallisiin vakioraportteihin (kuten Liikenteen hankinta, Sivut ja näkymät tai Verkkokauppaostot) GA4-raporttikirjaston avulla.

Vakioraporttitaulukoiden muuttaminen

Avaa GA4:ssä mikä tahansa yksityiskohtainen vakioraportti (esim. Raportit → Sitoutuminen → Sivut ja näkymät).
Napsauta oikean yläkulman kynäkuvaketta Mukauta raporttia (vaatii ylläpitäjän oikeudet).
Oikean paneelin kohdassa Raporttitiedot, napsauta Ulottuvuudet.
Lisää MousePlayer Session URL ensisijaisten tai toissijaisten ulottuvuuksien luetteloon ja määritä näkyväksi.
Napsauta Tallenna → Tallenna nykyisen raportin muutokset.

Tallennuksen jälkeen tavallisia hankinta- tai konversiotaulukoita katsova analyytikko voi lisätä ulottuvuuden MousePlayer Session URL toissijaiseksi ulottuvuudeksi ja tarkastella kävijäkäyttäytymistä heti visuaalisesti vakioliikennesegmenteissä.

6. JavaScript API & GA4-/GTM-yhteensopivuus

MousePlayer tarjoaa helppokäyttöisen GA4-yhteensopivan JavaScript API:n (käyttäen tavallisia gtag()-tyylisiä komentoja) ja julkisen globaalin objektin (window.MousePlayer). Kehittäjät voivat hakea istunto-URL:t konsolista, liittää B2B-asiakastunnukset ja lisätä toistolinkit kolmansien osapuolten tuki- tai virheseurantatyökaluihin.

1. Toisto-URL:n suora lisäys (Intercom / Zendesk / omat sillat)

Aktiivisen kävijäistunnon koko toisto-URL:n voi hakea suoraan selainkonsolista tai omasta skriptistä kutsulla 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. Omien B2B-asiakastunnusten asettaminen (user_id)

Kirjautuneiden SaaS- tai B2B-asiakkaiden tunnistamiseen voi antaa oman tunnuksen user_id (kuten tietokantatunnus, sähköposti tai UUID) joko skriptin alkumäärityksessä tai dynaamisesti ajon aikana GA4-syntaksilla:

// 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. Asynkroniset tiedonhakumenetelmät

Istuntometatiedot voi hakea asynkronisesti omissa tunnistehallintaskripteissä tavallisella GA4-takaisinkutsusyntaksilla:

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

Miten voimme auttaa?