Afárá GTM àti GA4 - MousePlayer

1. Àkótán ìṣètò & agbára

Ìtúpalẹ̀ wẹ́ẹ̀bù òde òní sábà ń ní ìṣòro ìyapa dátà pàtàkì: pẹpẹ nọ́ńbà (bí Google Analytics 4) ń ròyìn ohun tó ṣẹlẹ̀ lórí ojúlé wẹ́ẹ̀bù, nígbà tí irinṣẹ́ ìtúnṣeré ìgbà ìlò àwòrán ń ṣàlàyé ìdí tí ó fi ṣẹlẹ̀. Afárá MousePlayer GTM & GA4 ń mú àlàfo yìí kúrò nípa dídá ikanni mímú dọ́gba ọ̀nà méjì sílẹ̀ nínú àyíká ìṣiṣẹ́ JavaScript aṣàwákiri.

Nígbà tí a mú ṣiṣẹ́, síkírípù ìtọ́pa ń bẹ̀rẹ̀ module ìpìlẹ̀ méjì tí a yà sọ́tọ̀:

Olùgbéjáde ìtúnṣeré ìgbà ìlò (initGa4SessionBridge): Ó ń fi identifier ìgbàsílẹ̀ ìgbà ìlò tó ń ṣiṣẹ́ (mp_session_id) àti URL ìṣeré tààrà (mp_session_url) sínú data layer ojúlé wẹ́ẹ̀bù fúnra rẹ̀ ní kété tí a dá ìgbà ìlò sílẹ̀.
Olùgbà ìṣẹ̀lẹ̀ GA4 (initDataLayerBridge): Ó so olùgbọ́ tí kò ń ba ohun jẹ́ mọ́ array data layer. Gbogbo ìṣẹ̀lẹ̀ ìṣòwò ayélujára tàbí ìhùwàsí tiyín tí a fi sí GA4 ni a ń ṣe ẹ̀dà rẹ̀ lẹ́sẹ̀kẹsẹ̀ sínú ibi ìpamọ́ dátà ìtúpalẹ̀ MousePlayer gẹ́gẹ́ bí ìṣẹ̀lẹ̀ tiyín (ce), pẹ̀lú gbogbo parameter nọ́ńbà àti ọ̀rọ̀.

Ìrànlọ́wọ́ ohun dataLayer tiyín: Bí ètò wẹ́ẹ̀bù bá ń lo orúkọ array JavaScript tí a ṣàtúnṣe dípò èyí déédéé dataLayer (bí xyzDataLayer), ẹ̀rọ ń bá parameter gtm_datalayer_name tí a ṣètò mu fúnra rẹ̀ láìní àtúnṣe kóòdù fúnra yín.

2. Iye òwò tó ní ète

Sísopọ̀ ìjápọ̀ ìtúnṣeré ìgbà ìlò tààrà sínú ọ̀nà ìtúpalẹ̀ enterprise ń pèsè àǹfààní iṣẹ́ tó ní ipa gíga díẹ̀:

Agbára òwò	Ipa lórí iṣẹ́
Ìmúdára ìwọ̀n ìmúṣẹ àfojúsùn (CRO)	Ó ń jẹ́ kí olùtúpalẹ̀ ẹ̀rọ mọ ibi ìdènà nínú funnel ìmúṣẹ àfojúsùn GA4, kí ó sì ṣí ìgbàsílẹ̀ olùlò tó fi kẹ̀kẹ́ ọjà sílẹ̀ ní ìgbésẹ̀ checkout pàtó lẹ́sẹ̀kẹsẹ̀.
Ìpín owó tí a rí & àyẹ̀wò	A lè ṣàyẹ̀wò ìṣòwò ayélujára tó níyelórí gíga nípa wíwo ọ̀nà atọ́ka, ìtẹ̀ àti ipò agbègbè àwòrán gangan tó yọrí sí rírà.
Àtúnṣe àṣìṣe ẹ̀rọ tó yára sí i	Ẹgbẹ́ onímọ̀ QA lè so ìṣẹ̀lẹ̀ àṣìṣe JavaScript GA4 tàbí àkọsílẹ̀ àṣìṣe API tààrà mọ́ ìgbàsílẹ̀ ojú ìbòjú àwòrán, tó ń mú àìní láti tún àṣìṣe ṣe fúnra wọn kúrò.
Ìyanjú ìrànlọ́wọ́ oníbàárà	Ticket ìrànlọ́wọ́ tó ní ID ìgbà ìlò olùlò ń jẹ́ kí aṣojú ìrànlọ́wọ́ wo ìtúnṣeré ìgbà ìlò oníbàárà gangan, tó ń dín àkókò ìyanjú kù gidigidi.

3. Ìtọ́sọ́nà ìṣètò Google Tag Manager

Láti gba URL ìtúnṣeré nínú Google Tag Manager, kí ẹ sì darí rẹ̀ sí Google Analytics 4, a gbọ́dọ̀ ṣètò ohun GTM mẹ́ta ọ̀tọ̀:

Ìgbésẹ̀ 1: ṣẹ̀dá variable Data Layer

Nínú àgbègbè iṣẹ́ GTM, ẹ lọ sí Variable → Variable tí olùlò ṣàlàyé kí ẹ sì ṣẹ̀dá variable méjì irú Data Layer Variable:

Orúkọ variable: dlv - mp_session_id • Orúkọ Data Layer Variable: mp_session_id
Orúkọ variable: dlv - mp_session_url • Orúkọ Data Layer Variable: mp_session_url

Ìgbésẹ̀ 2: ṣẹ̀dá ohun ìmúṣiṣẹ́

Ẹ lọ sí Ohun ìmúṣiṣẹ́ → Tuntun kí ẹ sì yan irú ohun ìmúṣiṣẹ́ Ìṣẹ̀lẹ̀ tiyín. Ẹ ṣètò parameter wọ̀nyí:

Orúkọ ìṣẹ̀lẹ̀: mp_session_ready
Ohun ìmúṣiṣẹ́ yìí ń ṣiṣẹ́ lórí: Gbogbo ìṣẹ̀lẹ̀ tiyín

Ìgbésẹ̀ 3: ṣètò tag ìṣẹ̀lẹ̀ GA4

Ẹ ṣẹ̀dá tag tuntun irú Google Analytics: Ìṣẹ̀lẹ̀ GA4 láti fi ìjápọ̀ ìgbà ìlò ránṣẹ́ sí ojúlé 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. Ṣíṣètò ìṣàwárí (ìròyìn tiyín) nínú GA4

Ní kété tí a bá fi tag GTM sílẹ̀, GA4 bẹ̀rẹ̀ sí í gba URL ìṣeré gẹ́gẹ́ bí parameter ìṣẹ̀lẹ̀. Láti túpalẹ̀ dátà yìí nínú ìròyìn ìṣàwárí tiyín, a gbọ́dọ̀ kọ́kọ́ forúkọ parameter sílẹ̀ gẹ́gẹ́ bí Custom Dimension.

Fíforúkọ ìwọ̀n tiyín sílẹ̀ nínú Alábòójútó GA4

Nínú ojú ìṣàkóso Google Analytics 4, ẹ lọ sí Alábòójútó → Fífi dátà hàn → Ìtumọ̀ tiyín kí ẹ sì tẹ Ṣẹ̀dá ìwọ̀n tiyín:

Orúkọ ìwọ̀n: MousePlayer Session URL
Àgbègbè ipa: Ìṣẹ̀lẹ̀ (tàbí Ìgbà ìlò bí a bá so mọ́ parameter tó ní àgbègbè ipa ìgbà ìlò)
Parameter ìṣẹ̀lẹ̀: mp_session_url

Kíkọ́ ìṣàwárí àyẹ̀wò ìgbà ìlò

Nínú ẹ̀ka Ṣàwárí GA4, ẹ ṣẹ̀dá ìṣàwárí tuntun irú Ọ̀nà òmìnira láti ṣàyẹ̀wò ìrìnàjò olùlò kọ̀ọ̀kan:

Ìlà: Fi Event name, Transaction ID (fún ìṣòwò ayélujára), tàbí Landing page kún un.
Kọ́lọ́ọ̀mù / Ìwọ̀n: Fi ìwọ̀n tiyín tí a ṣẹ̀ṣẹ̀ ṣẹ̀dá MousePlayer Session URL kún un.
Iye: Fi Event count tàbí Total users kún un.

Tábìlì ìròyìn tí a ṣẹ̀dá ń fi URL tààrà tó ṣeé tẹ̀ hàn lẹ́gbẹ̀ẹ́ ìwọ̀n GA4, tó ń gba ìrìnàjò lẹ́sẹ̀kẹsẹ̀ láti ohun tó yàtọ̀ nínú nọ́ńbà sí ìtúnṣeré àwòrán láyè.

5. Fífi URL ìtúnṣeré sínú ìròyìn àkọ́kọ́ GA4

Ní àfikún sí Ìṣàwárí, a lè so ìwọ̀n tiyín sínú ìròyìn àkọ́kọ́ GA4 déédéé (bí Gbígba ìrìnnà, Ojú ìwé àti ojú ìbòjú, tàbí Rírà ìṣòwò ayélujára) nípasẹ̀ Ibi ìkójọ Ìròyìn GA4.

Ṣíṣàtúnṣe tábìlì ìròyìn déédéé

Nínú GA4, ẹ ṣí ìròyìn àkọ́kọ́ kíkún èyíkéyìí (bí Ìròyìn → Ìkópa → Ojú ìwé àti ojú ìbòjú).
Ẹ tẹ aami kọ̀wé Ṣàtúnṣe ìròyìn ní igun òkè ọ̀tún (àṣẹ alábòójútó jẹ́ dandan).
Nínú pánẹ́ẹ̀lì ọ̀tún lábẹ́ Dátà ìròyìn, ẹ tẹ Ìwọ̀n.
Fi MousePlayer Session URL kún àtòjọ ìwọ̀n àkọ́kọ́ tàbí èkejì, kí ẹ sì jẹ́ kí ó hàn.
Ẹ tẹ Fi pamọ́ → Fi àyípadà sí ìròyìn lọ́wọ́lọ́wọ́ pamọ́.

Ní kété tí a bá fi pamọ́, olùtúpalẹ̀ èyíkéyìí tó ń wo tábìlì gbígba àlejò tàbí ìmúṣẹ àfojúsùn déédéé lè fi MousePlayer Session URL kún un gẹ́gẹ́ bí ìwọ̀n èkejì, kí a lè ṣe àyẹ̀wò àwòrán lẹ́sẹ̀kẹsẹ̀ ti ìhùwàsí àlejò káàkiri ẹ̀ka ìrìnnà déédéé.

6. JavaScript API & ìtọ́kasí ìbámu GA4 / GTM

MousePlayer ń pèsè JavaScript API tó rọrùn tó bá GA4 mu (pẹ̀lú àṣẹ déédéé ní ìrísí gtag()) àti ohun gbòòrò gbangba (window.MousePlayer). Èyí ń jẹ́ kí olùgbékalẹ̀ béèrè URL ìgbà ìlò nínú console, so ID oníbàárà B2B pọ̀, kí ó sì fi ìjápọ̀ ìtúnṣeré sínú helpdesk tàbí irinṣẹ́ ìtọ́pa àṣìṣe ẹni kẹta.

1. Fífi URL ìtúnṣeré sínú tààrà (Intercom / Zendesk / afárá tiyín)

Ẹ lè gba gbogbo URL ìṣeré ìgbà ìlò àlejò tó ń ṣiṣẹ́ tààrà láti console aṣàwákiri tàbí síkírípù tiyín èyíkéyìí pẹ̀lú 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. Ṣíṣètò ID oníbàárà B2B tiyín (user_id)

Láti mọ oníbàárà SaaS tàbí B2B tó wọlé, ẹ lè fi user_id tiyín (bí ID ibi ìpamọ́ dátà, ímeèlì tàbí UUID) ránṣẹ́ ní ìṣètò síkírípù àkọ́kọ́ tàbí láìdádúró ní àkókò ìṣiṣẹ́ pẹ̀lú syntax 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. Ọ̀nà gbígba dátà lọ́tọ̀

Ẹ lè lo syntax callback GA4 déédéé láti gba metadata ìgbà ìlò lọ́tọ̀ nínú síkírípù ìṣàkóso tag tiyín:

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

Báwo ni a ṣe lè ràn yín lọ́wọ́?