جسر GTM & جسر أحداث GA4

توحيد قياسات Google Analytics 4 الكمية مع إعادات تشغيل MousePlayer النوعية، بمزامنة dataLayer ثنائية الاتجاه وواجهات API متوافقة مع GA4.

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 وفتح تسجيلات مستخدمين تركوا السلال عند خطوات إتمام شراء محددة فورًا.
إسناد الإيراد & التدقيق يمكن تدقيق المعاملات عالية القيمة بمراجعة مسارات المؤشر والنقرات وحالات المنطقة المرئية الدقيقة التي أدت للشراء.
تسريع تشخيص الأخطاء التقنية تربط فرق ضمان الجودة أحداث استثناءات JavaScript في GA4 أو سجلات أخطاء API مباشرة بتسجيلات الشاشة، دون الحاجة لإعادة إنتاج الخلل يدويًا.
حل طلبات دعم العملاء تتيح التذاكر التي تحتوي معرّفات جلسات مراجعة إعادة تشغيل جلسة العميل بدقة، فتقل أوقات الحل كثيرًا.

3. دليل إعداد Google Tag Manager

لالتقاط URL إعادة التشغيل في 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 تلقي URL التشغيل كمعلمة حدث. لتحليلها في تقارير استكشاف مخصّصة، سجّل المعلمة كبُعد مخصّص أولًا.

تسجيل الأبعاد المخصّصة في إدارة GA4

في واجهة Google Analytics 4 انتقل إلى الإدارة → عرض البيانات → التعريفات المخصّصة وانقر إنشاء بُعد مخصّص:

  • اسم البُعد: MousePlayer Session URL
  • النطاق: حدث (أو جلسة إن أُرفق بمعلمات على مستوى الجلسة)
  • معلمة الحدث: mp_session_url

بناء استكشاف لفحص الجلسات

في قسم الاستكشاف في GA4، أنشئ استكشافًا جديدًا من نوع نموذج حر لفحص رحلات المستخدم الفردية:

  • الصفوف: أضف Event name، Transaction ID (للتجارة الإلكترونية)، أو Landing page.
  • الأعمدة / الأبعاد: أدرج البُعد المخصّص الجديد MousePlayer Session URL.
  • القيم: أضف Event count أو Total users.

يعرض جدول التقرير روابط URL مباشرة قابلة للنقر بجانب مقاييس GA4، للانتقال فورًا من القيم الإحصائية الشاذة إلى إعادات التشغيل.

5. دمج روابط إعادة التشغيل في تقارير GA4 الافتراضية

إضافة للاستكشافات، يمكن دمج الأبعاد المخصّصة في تقارير GA4 القياسية (مثل اكتساب الزيارات، الصفحات والشاشات، أو مشتريات التجارة الإلكترونية) باستخدام مكتبة تقارير GA4.

تعديل جداول التقارير القياسية

  1. افتح أي تقرير تفصيلي افتراضي في GA4 (مثل التقارير → التفاعل → الصفحات والشاشات).
  2. انقر رمز قلم تخصيص التقرير أعلى اليمين (يتطلب وصولًا إداريًا).
  3. في اللوحة اليمنى تحت بيانات التقرير، انقر الأبعاد.
  4. أضف MousePlayer Session URL إلى قائمة الأبعاد الأساسية أو الثانوية واجعله مرئيًا.
  5. انقر حفظ → حفظ التغييرات في التقرير الحالي.

بعد الحفظ، يستطيع أي محلل يراجع جداول الاكتساب أو التحويل القياسية إضافة MousePlayer Session URL كبُعد ثانوي لفحص سلوك الزوار بصريًا فورًا عبر شرائح الزيارات المعتادة.

6. مرجع JavaScript API & التوافق مع GA4 / GTM

يوفر MousePlayer واجهة JavaScript API سهلة متوافقة مع GA4 (باستخدام أوامر بنمط gtag()) وكائنًا عامًا (window.MousePlayer). يتيح هذا للمطورين طلب روابط الجلسات في وحدة التحكم وربط معرّفات عملاء B2B وحقن روابط إعادة التشغيل في مكاتب مساعدة أو أدوات أخطاء خارجية.

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 مخصّصة (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. طرق جلب بيانات غير متزامنة

يمكنك استخدام صيغة رد النداء القياسية لـ 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 علاقة تجارية بهؤلاء المزودين.