د GTM پُل & د GA4 د پېښو پُل

د دواړو لورو د dataLayer همغږۍ او له GA4 سره برابرو API له لارې د Google Analytics 4 عددي ټېلېمېټري د MousePlayer د ناستو له لیدیزو بیا غږونو سره یوځای کول.

1. د جوړښت عمومي کتنه & وړتیاوې

عصري وېب شننه ډېر ځله د معلوماتو له بنسټیز جلاوالي سره مخ ده: عددي پلیټفارمونه (لکه Google Analytics 4) راپوروي چې څه په وېبپاڼه کې پېښ شول، خو د ناستو د لیدیزې بیا غږونې وسیلې تشریح کوي چې ولې پېښ شول. دا د MousePlayer د GTM & GA4 پُل د براوزر د JavaScript د اجرا چاپېریال دننه د دوه لوري همغږۍ چینل په جوړولو دا تشه لرې کوي.

چې فعال شي، تعقیبي سکریپټ دوه ځانګړې اساسي برخې چمتو کوي:

  • د ناستې د بیا غږونې صادرونکی (initGa4SessionBridge): د فعالې ثبتېدونکې ناستې پېژند په خپله لېږي (mp_session_id) او د بیا غږونې مستقیم URL (mp_session_url) د وېبپاڼې د معلوماتو پوړ ته، چې ناسته جوړه شي.
  • د GA4 پېښو اخیستونکی (initDataLayerBridge): د معلوماتو د پوړ له ارې سره بې زیانه اورېدونکی نښلوي. د برېښنايي سوداګرۍ یا چلند هره خپله پېښه چې د GA4 لپاره لېږل کېږي، سمدستي د MousePlayer تحلیلي معلوماتي زېرمتون ته د خپلې پېښې په توګه کاپي کېږي (ce)، له ټولو عددي او متني پارامترونو سره.

د خپل dataLayer څیز ملاتړ: که وېب اېپ د معیاري نوم پر ځای د JavaScript د ارې خپل نوم کاروي، یعنې د دې پر ځای: dataLayer (د بېلګې په توګه، xyzDataLayer)، انجن د تنظیم شوي دې سره په خوځنده ډول برابرېږي: gtm_datalayer_name پارامتر، د کوډ د لاسي بدلون اړتیا نه لري.

2. ستراتیژیک سوداګریز ارزښت

د ناستې د بیا غږونې لینکونه د لویو سوداګریو د شننې په بهیرونو کې مستقیم یوځای کول څو لویې کاري ګټې لري:

سوداګریزه وړتیا کاري اغېز
د بدلون د کچې ښه کول (CRO) ډیجیټلي شنونکو ته اجازه ورکوي چې د GA4 د بدلون فنلونو کې د خنډ ځایونه ومومي او سمدستي د هغو کارنانو ثبتونه پرانیزي چې د پېر بشپړولو په ځانګړو پړاوونو کې یې ټوکرۍ پرېښې ده.
د عاید تړنه & پلټنه د برېښنايي سوداګرۍ لوړ ارزښت لرونکې معاملې د نښې د عین لارو، کلیکونو او د لید ساحې د هغو حالتونو په کتلو پلټل کېدای شي چې پېر ته یې لاره هواره کړې.
د تخنیکي تېروتنو چټکه موندنه د کیفیت د انجینرۍ ډلې د GA4 د JavaScript استثناوو پېښې یا د API د تېروتنو ثبتونه مستقیم له لیدیزو پرده‌ییزو ثبتونو سره تړلی شي، د تېروتنو د لاسي بیا جوړولو اړتیا له منځه وړي.
د پېرودونکو د ملاتړ حل د کارن د ناستې ID لرونکې د مرستې غوښتنې د ملاتړ کارکوونکو ته اجازه ورکوي چې د پېرودونکي د ناستې عین بیا غږونه وګوري او د حل وختونه خورا راکم کړي.

3. د Google Tag Manager د تنظیم لارښود

په Google Tag Manager کې د بیا غږونې د URL د اخیستلو او Google Analytics 4 ته د لېږلو لپاره، د GTM درې بېل توکي باید تنظیم شي:

ګام 1: د معلوماتو د پوړ متغیرونه جوړ کړئ

د GTM په کاري چاپېریال کې دې ته لاړ شئ: Variables → User-Defined Variables او دوه متغیرونه د دې ډول جوړ کړئ: 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

ګام 2: د فعالولو محرک جوړ کړئ

دې ته لاړ شئ: Triggers → New او دا محرک ډول وټاکئ: Custom Event. لاندې پارامترونه تنظیم کړئ:

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

ګام 3: د GA4 د پېښې نښه تنظیم کړئ

د دې ډول نوې نښه جوړه کړئ: Google Analytics: GA4 Event څو د ناستې لینک د 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. په GA4 کې د سپړنو تنظیم (خپل راپورونه)

چې د GTM نښه خپره شي، GA4 د بیا غږونې URL د پېښې د پارامتر په توګه ترلاسه کول پیلوي. په خپلو سپړنیزو راپورونو کې د دې معلوماتو د شنلو لپاره، پارامتر لومړی باید د خپل بُعد په توګه ثبت شي.

د GA4 په مدیر کې د خپلو بُعدونو ثبتول

د Google Analytics 4 په مخ کې دې ته لاړ شئ: Admin → Data display → Custom definitions او کلیک وکړئ پر Create custom dimension:

  • Dimension name: MousePlayer Session URL
  • Scope: Event (یا Session که د ناستې د ساحې له پارامترونو سره تړلی وي)
  • Event parameter: mp_session_url

د ناستې د کتنې سپړنه جوړول

په Explore برخه کې د GA4، نوې جوړه کړئ: Free form سپړنه، څو د انفرادي کارنانو سفرونه وګورئ:

  • Rows: ورزیات کړئ Event name، Transaction ID (د برېښنايي سوداګرۍ لپاره)، یا Landing page.
  • Columns / Dimensions: نوی جوړ شوی خپل بُعد ورشامل کړئ: MousePlayer Session URL.
  • Values: ورزیات کړئ Event count یا Total users.

د جوړ شوي راپور جدول د GA4 د اندازو تر څنګ مستقیم کلیک کېدونکي URL ښيي، څو له احصایوي غیرعادي پایلو څخه لیدیزو بیا غږونو ته سمدستي تګ ممکن شي.

5. د GA4 په اصلي راپورونو کې د بیا غږونې URL یوځای کول

له سپړنو سربېره، خپل بُعدونه د GA4 په معیاري اصلي راپورونو کې یوځای کېدای شي (لکه Traffic acquisition، Pages and screens، یا E-commerce purchases) د GA4 Report Library په وسیله.

د معیاري راپورونو جدولونه بدلول

  1. په GA4 کې هر اصلي مفصل راپور پرانیزئ (لکه، Reports → Engagement → Pages and screens).
  2. کلیک وکړئ پر Customize report د پنسل نښه، په پورتنۍ ښۍ څنډه کې (د مدیر لاسرسی اړین دی).
  3. په ښي پینل کې د دې لاندې: Report Data، کلیک وکړئ پر Dimensions.
  4. ورزیات کړئ MousePlayer Session URL د لومړنیو یا دویمنیو بُعدونو لېست ته او د لیدلو وړ یې وټاکئ.
  5. کلیک وکړئ پر Save → Save changes to current report.

چې خوندي شي، هر شنونکی چې د معیاري جذب یا بدلون جدولونه ګوري، دا ورزیاتولی شي: MousePlayer Session URL د دویمني بُعد په توګه، څو د تګ راتګ په معیاري ډلو کې د لیدونکو چلند سمدستي په لیدیز ډول وکتل شي.

6. د JavaScript API & د GA4 / GTM د برابرۍ لارښود

MousePlayer ساده، له GA4 سره برابر JavaScript API وړاندې کوي (د معیاري دې په بڼه: gtag()امرونه) او عام عمومي څیز (window.MousePlayer). دا پراختیاکوونکو ته اجازه ورکوي چې په کنسول کې د ناستو URL وغواړي، د B2B پېرودونکو ID ونښلوي او د بیا غږونې لینکونه د درېیمو خواوو د مرستې څانګو یا د تېروتنو تعقیبوونکو ته ورزیات کړي.

1. د بیا غږونې د URL مستقیم ورزیاتول (Intercom / Zendesk / خپل پُلونه)

د فعال لیدونکي د ناستې د بیا غږونې بشپړ URL د براوزر له کنسول یا هر خپل سکریپټ څخه مستقیم د دې په وسیله ترلاسه کولی شئ: 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. د خپلو B2B پېرودونکو ID ټاکل (user_id)

د ننوتلو SaaS یا B2B پېرودونکو د پېژندلو لپاره، خپل دا لېږلی شئ: user_id (لکه د معلوماتي زېرمتون ID، برېښنالیک یا UUID)، یا د سکریپټ د لومړني تنظیم پر مهال، یا د اجرا پر مهال په خوځنده توګه د 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. د معلوماتو د ناهممهاله ترلاسه کولو لارې

د خپلو نښو د مدیریت سکریپټونو دننه د ناستې مېټاډاټا په ناهممهاله ډول ترلاسه کولو لپاره د GA4 د بېرته بلنې معیاري نحوه کارولی شئ:

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

دلته یادې شوې ټولې سوداګریزې نښې د خپلو مالکانو دي. MousePlayer له دې برابرونکو سره سوداګریزه اړیکه نه لري.