پل GTM & پل رویداد GA4

پیوند داده‌سنجی کمی Google Analytics 4 با بازپخش کیفی نشست MousePlayer از طریق همگام‌سازی دوطرفهٔ dataLayer و API سازگار با GA4.

1. نمای معماری & قابلیت‌ها

تحلیل وب امروزی اغلب از جدایی بنیادی داده رنج می‌برد: پلتفرم کمی (مانند Google Analytics 4) گزارش می‌دهد چه اتفاقی در سایت افتاده، اما ابزار کیفی بازپخش نشست توضیح می‌دهد چرا اتفاق افتاده است. این پل MousePlayer GTM & GA4 با ایجاد کانال همگام‌سازی دوطرفه در محیط اجرای JavaScript مرورگر فاصله را برمی‌دارد.

هنگام فعال شدن، اسکریپت ردیابی دو ماژول اصلی اختصاصی را راه‌اندازی می‌کند:

  • صادرکنندهٔ بازپخش نشست (initGa4SessionBridge): به‌محض ایجاد نشست، شناسهٔ نشست ضبط فعال (mp_session_id) و نشانی مستقیم بازپخش (mp_session_url) را خودکار به لایهٔ دادهٔ سایت می‌فرستد.
  • دریافت‌کنندهٔ رویداد GA4 (initDataLayerBridge): شنوندهٔ غیرمخرب به آرایهٔ لایهٔ داده می‌افزاید. هر رویداد اختصاصی تجارت الکترونیک یا رفتاری فرستاده‌شده برای GA4 فوراً به‌صورت رویداد اختصاصی (ce) با همهٔ پارامترهای عددی و متنی در پایگاه تحلیل MousePlayer منعکس می‌شود.

پشتیبانی از شیء اختصاصی dataLayer: اگر برنامهٔ وب به‌جای نام استاندارد آرایهٔ JavaScript از نام اختصاصی استفاده کند، یعنی به‌جای dataLayer (مثلاً xyzDataLayer)، موتور خودکار با پارامتر تنظیم‌شدهٔ gtm_datalayer_name سازگار می‌شود و تغییر دستی کد لازم نیست.

2. ارزش راهبردی کسب‌وکار

افزودن مستقیم پیوند بازپخش به مسیر تحلیل سازمانی چند مزیت عملیاتی مؤثر دارد:

قابلیت کسب‌وکار اثر عملیاتی
بهینه‌سازی نرخ تبدیل (CRO) تحلیلگر دیجیتال می‌تواند نقطهٔ اصطکاک قیف GA4 را بیابد و فوراً ضبط کاربری را باز کند که سبد را در مرحلهٔ مشخص پرداخت ترک کرده است.
انتساب درآمد & حسابرسی تراکنش تجارت الکترونیک با ارزش بالا با بازبینی مسیر دقیق نشانگر، کلیک و وضعیت نمای مرورگر منجر به خرید قابل حسابرسی است.
اشکال‌زدایی فنی سریع‌تر تیم مهندسی QA می‌تواند استثنای JavaScript در GA4 یا گزارش خطای API را مستقیم به ضبط دیداری صفحه پیوند دهد و از بازتولید دستی اشکال بی‌نیاز شود.
حل مسئله در پشتیبانی مشتری تیکت دارای شناسهٔ نشست کاربر به کارشناس امکان بازبینی دقیق بازپخش نشست مشتری و کاهش شدید زمان حل را می‌دهد.

3. راهنمای پیکربندی Google Tag Manager

برای گرفتن نشانی بازپخش در Google Tag Manager و فرستادنش به Google Analytics 4 باید سه مورد جداگانه در GTM تنظیم کنید:

گام 1: ایجاد متغیر لایهٔ داده

در فضای کاری GTM به این بخش بروید: متغیرها → متغیرهای تعریف‌شدهٔ کاربر و دو متغیر از این نوع بسازید: متغیر لایهٔ داده:

  • نام متغیر: dlv - mp_session_id • نام متغیر لایهٔ داده: mp_session_id
  • نام متغیر: dlv - mp_session_url • نام متغیر لایهٔ داده: mp_session_url

گام 2: ایجاد راه‌انداز فعال‌سازی

به این بخش بروید: راه‌اندازها → جدید و نوع راه‌انداز را انتخاب کنید: رویداد اختصاصی. پارامترهای زیر را تنظیم کنید:

  • نام رویداد: mp_session_ready
  • این راه‌انداز در این موارد اجرا می‌شود: همهٔ رویدادهای اختصاصی

گام 3: پیکربندی برچسب رویداد GA4

برچسب جدیدی از این نوع بسازید: Google Analytics: رویداد GA4 تا پیوند نشست به ملک 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 نشانی بازپخش را به‌صورت پارامتر رویداد می‌گیرد. برای تحلیل در گزارش اکتشافی اختصاصی باید ابتدا پارامتر را به‌عنوان بُعد اختصاصی ثبت کنید.

ثبت بُعد اختصاصی در مدیریت GA4

در رابط Google Analytics 4 به این بخش بروید: مدیریت → نمایش داده → تعریف‌های اختصاصی و کلیک کنید: ایجاد بُعد اختصاصی:

  • نام بُعد: MousePlayer Session URL
  • دامنه: رویداد (یا نشست در صورت اتصال به پارامتر سطح نشست)
  • پارامتر رویداد: mp_session_url

ساخت اکتشاف بررسی نشست

در بخش اکتشاف از GA4، اکتشاف جدیدی از نوع فرم آزاد بسازید تا مسیر تک‌تک کاربران را بررسی کنید:

  • ردیف‌ها: اضافه کنید: Event name، Transaction ID (برای تجارت الکترونیک)، یا Landing page.
  • ستون‌ها / ابعاد: بُعد اختصاصی تازه‌ساخته‌شده را اضافه کنید: MousePlayer Session URL.
  • مقادیر: اضافه کنید: Event count یا Total users.

جدول گزارش تولیدشده نشانی مستقیم قابل کلیک را کنار سنجهٔ GA4 نشان می‌دهد تا بی‌درنگ از مورد آماری غیرعادی به بازپخش دیداری بروید.

5. افزودن نشانی بازپخش به گزارش پیش‌فرض GA4

علاوه بر اکتشاف، بُعد اختصاصی را می‌توان به گزارش استاندارد پیش‌فرض GA4 (مانند جذب ترافیک، صفحه‌ها و نمایشگرها یا خرید تجارت الکترونیک) با کتابخانهٔ گزارش GA4 افزود.

تغییر جدول گزارش استاندارد

  1. در GA4 هر گزارش تفصیلی پیش‌فرض را باز کنید (مثلاً گزارش‌ها → تعامل → صفحه‌ها و نمایشگرها).
  2. روی نماد مداد سفارشی‌سازی گزارش در بالای سمت راست کلیک کنید (دسترسی مدیریت لازم است).
  3. در پنل راست زیر دادهٔ گزارش، روی ابعاد کلیک کنید.
  4. این مورد را اضافه کنید: MousePlayer Session URL به فهرست بُعد اصلی یا فرعی و آن را قابل مشاهده کنید.
  5. کلیک کنید: ذخیره → ذخیرهٔ تغییر در گزارش فعلی.

پس از ذخیره، تحلیلگر جدول استاندارد جذب یا تبدیل می‌تواند این مورد را اضافه کند: MousePlayer Session URL به‌عنوان بُعد فرعی تا رفتار بازدیدکننده را در بخش‌های استاندارد ترافیک فوراً به‌صورت دیداری بررسی کند.

6. مرجع API JavaScript & سازگاری GA4 / GTM

MousePlayer یک API JavaScript روشن و سازگار با GA4 (با دستور استاندارد به‌سبک gtag()) و یک شیء سراسری عمومی (window.MousePlayer) دارد. توسعه‌دهنده می‌تواند در کنسول نشانی نشست بگیرد، شناسهٔ مشتری B2B بیفزاید و پیوند بازپخش را در میز کمک یا ردیاب خطای شخص ثالث درج کند.

1. درج مستقیم نشانی بازپخش (Intercom / Zendesk / پل اختصاصی)

می‌توانید نشانی کامل بازپخش نشست فعال بازدیدکننده را مستقیم از کنسول مرورگر یا اسکریپت اختصاصی با این مورد بگیرید: 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 (user_id)

برای شناسایی مشتری واردشدهٔ SaaS یا B2B می‌توانید شناسهٔ اختصاصی با نام user_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. روش دریافت ناهمگام داده

می‌توانید از نحو استاندارد callback در 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 با این ارائه‌دهندگان رابطهٔ تجاری ندارد.