Pira bûyerên GTM û GA4

1. Dîtina giştî ya mîmarî & şiyan

Analîza webê ya nûjen gelek caran ji cudahiya bingehîn a daneyan dikişîne: platformên hejmarî (wek Google Analytics 4) dibêjin çi li malperekê qewimî, lê amûrên ji nû ve lîstina danişînan ên kalîteyî dibêjin çima qewimî. Ev Pira MousePlayer GTM & GA4 vê valahiyê bi avakirina kanala hevdemkirina dualî di hawîrdora xebitandina JavaScriptê ya gerokê de ji holê radike.

Dema çalak be, skrîpta şopandinê du modulên bingehîn ên taybet dest pê dike:

Derxistina ji nû ve lîstina danişînê (initGa4SessionBridge): Xweber nasnameya danişîna tomarkirinê ya çalak (mp_session_id) û URLya rasterast a lîstinê (mp_session_url) di data layer a malperê de datîne tavilê dema danişîn tê avakirin.
Wergira bûyerên GA4 (initDataLayerBridge): Guhdarekî nexerabker li rêzika data layer zêde dike. Her bûyera taybet a bazirganiya elektronîk an tevgerê ya ji bo GA4 tê şandin tavilê wek bûyereke taybet di danegeha analîzê ya MousePlayer de tê dubarekirin (ce), tevî hemû parametreyên hejmarî û nivîskî.

Piştgiriya objeya dataLayer ya taybet: Heke sepaneke webê li şûna ya standard navekî rêzika JavaScriptê ya taybet bi kar bîne: dataLayer (mînak xyzDataLayer), motor bi parametreya mîhengkirî ya gtm_datalayer_name xwe dînamîk diguncîne, bê pêwîstiya guherandina kodê bi destan.

2. Nirxa stratejîk a karsaziyê

Girêdana URLyên ji nû ve lîstina danişînan rasterast bi rêyên analîzê yên pargîdaniyan ve çend feydeyên xebitandinê yên bi bandora bilind dide:

Şiyana karsaziyê	Bandora xebitandinê
Baştirkirina rêjeya veguherînê (CRO)	Destûrê dide analîstên dîjîtal ku xalên astengiyê di funelên veguherînê yên GA4 de nas bikin û tavilê tomarên bikarhênerên ku di gavên diyarkirî yên dayînê de selik terikandine vekin.
Danîna dahatê & kontrol	Danûstandinên bazirganiya elektronîk ên bi nirxê bilind bi nêrîna li rêyên tam ên nîşankerê, klîk û rewşên qada dîtinê yên ku bûn sedema kirînê tên kontrolkirin.
Sererastkirina teknîkî ya bileztir	Tîmên endezyariya QA dikarin bûyerên îstîsnayên JavaScriptê yên GA4 an qeyda çewtiyên API rasterast bi tomarên dîtbar ên ekranê re girê bidin û pêwîstiya dubarekirina çewtiyan bi destan ji holê rakin.
Çareserkirina alîkariya mişteriyan	Daxwazên alîkariyê yên bi IDyên danişînê destûrê didin ajanan ku li ji nû ve lîstina tam a danişîna mişterî binêrin û dema çareserkirinê gelek kêm bikin.

3. Rêbera mîhengkirina Google Tag Manager

Ji bo girtina URLya ji nû ve lîstinê di Google Tag Manager de û şandina wê bo Google Analytics 4, divê sê hêmanên GTM yên cuda bên sazkirin:

Gava 1: Guherokên Data Layer biafirînin

Di qada xebatê ya GTM de herin Variables → User-Defined Variables û du guherokên bi vî cureyî biafirînin: Data Layer Variable:

Variable Name: dlv - mp_session_id • Data Layer Variable Name: mp_session_id
Variable Name: dlv - mp_session_url • Data Layer Variable Name: mp_session_url

Gava 2: Destpêkera çalakkirinê biafirînin

Herin Triggers → New û vî cureyê destpêkerê hilbijêrin: Custom Event. Parametreyên jêr saz bikin:

Event Name: mp_session_ready
This trigger fires on: All Custom Events

Gava 3: Nîşana bûyera GA4 saz bikin

Nîşaneke nû bi vî cureyî biafirînin: Google Analytics: GA4 Event da ku girêdana danişînê bo malpera GA4 bişînin:

# 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. Mîhengkirina keşifan (Raporên taybet) di GA4 de

Piştî sazkirina nîşana GTM, GA4 URLya lîstinê wek parametreya bûyerê distîne. Ji bo analîza van daneyan di raporên keşifê yên taybet de, divê parametre pêşî wek pîvaneke taybet bê tomarkirin.

Tomarkirina pîvanên taybet di rêveberiya GA4 de

Di rûkara Google Analytics 4 de herin Admin → Data display → Custom definitions û li Create custom dimension bikirtînin:

Dimension name: MousePlayer Session URL
Scope: Event (an Session heke bi parametreyên asta danişînê ve girêdayî be)
Event parameter: mp_session_url

Avakirina keşifa kontrolkirina danişînê

Di beşa Explore ya GA4 de keşifeke nû ya Free form biafirînin da ku rêwîtiyên bikarhênerên yekane kontrol bikin:

Rows: Zêde bikin: Event name, Transaction ID (ji bo bazirganiya elektronîk) an Landing page.
Columns / Dimensions: Pîvana taybet a nû afirandî zêde bikin: MousePlayer Session URL.
Values: Zêde bikin: Event count an Total users.

Tabloya rapora çêkirî URLyên rasterast ên klîkbar li kêleka pîvanên GA4 nîşan dide û derbasbûna tavilê ji rewşên neasayî yên statîstîkî bo ji nû ve lîstinên dîtbar dide.

5. Girêdana URLyên ji nû ve lîstinê di raporên standard ên GA4 de

Ji bilî keşifan, pîvanên taybet dikarin di raporên standard ên GA4 (wek Traffic acquisition, Pages and screens an E-commerce purchases) de bi GA4 Report Library bên girêdan.

Guherandina tabloyên raporên standard

Di GA4 de raporeke standard a hûrgilî vekin (mînak Reports → Engagement → Pages and screens).
Li îkona pênûsê ya Customize report di goşeya jor a rastê de bikirtînin (destûra rêveberiyê pêwîst e).
Di panela rastê de di bin Report Data de li Dimensions bikirtînin.
Vê zêde bikin: MousePlayer Session URL di lîsteya pîvanên sereke an duyemîn de û wek xuya diyar bikin.
Li Save → Save changes to current report bikirtînin.

Piştî tomarkirinê, her analîstê ku tabloyên standard ên bidestxistin an veguherînê dinirxîne dikare MousePlayer Session URL wek pîvana duyemîn zêde bike û tavilê tevgerên serdankeran di segmentên trafîkê yên standard de bi dîtinê kontrol bike.

6. Rêbera lihevhatina JavaScript API & GA4 / GTM

MousePlayer JavaScript APIyeke hêsanfêm û lihevhatî bi GA4 dide (bi fermanên bi şêwaza standard a gtag()) û objeyeke giştî ya global (window.MousePlayer). Ev destûrê dide pêşdebiran ku di konsolê de URLyên danişînê bipirsin, IDyên mişteriyên B2B girê bidin û girêdanên ji nû ve lîstinê di navendên alîkariyê an şopanderên çewtiyê yên aliyê sêyem de deynin.

1. Danîna rasterast a URLya ji nû ve lîstinê (Intercom / Zendesk / Pirên taybet)

Hûn dikarin URLya tam a lîstinê ya danişîna serdankerê ya çalak rasterast ji konsola gerokê an her skrîpteke taybet bi vê bistînin: 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. Danîna IDyên mişteriyên B2B yên taybet (user_id)

Ji bo naskirina mişteriyên SaaS an B2B yên têketî, hûn dikarin nirxeke taybet a user_id (wek IDya danegehê, e-name an UUID) an di mîhengkirina destpêkê ya skrîptê de an dînamîk di dema xebitandinê de bi hevoksaziya GA4 bişînin:

// 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. Rêbazên wergirtina daneyan ên nehevdem

Hûn dikarin hevoksaziya callback a standard a GA4 bi kar bînin da ku metadaneyên danişînê nehevdem di skrîptên taybet ên birêvebirina nîşanan de bistînin:

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

Em çawa dikarin alîkariyê bikin?