لقد قمت بتنفيذ نظام لتتبع التحليلات لـ Guest Gate v2.0 مع دعم كامل لـ GTM (Google Tag Manager) وتسجيل مرن للأحداث المخصصة.
الإعدادات المضافة
-
enable_analytics(معطّل افتراضياً): يفعّل أو يعطّل وظيفة التتبع بالكامل بناءً على الطلب. -
analytics_debug_logging: عند تفعيله، يسجّل جميع الأحداث المتتبَّعة مباشرةً في وحدة التحكم بالمتصفح. هذا مفيد بشكل خاص أثناء الإعداد عند تكوين محفّزات GTM.
الوظائف الأساسية
يتولى وحدة مساعدة مخصصة (guest-gate-analytics.js) مهمة إرسال الأحداث. يتم دفع كل حدث متتبَّع إلى وجهتين في وقت واحد:
-
window.dataLayer.push(...): يتم التقاطه تلقائياً بواسطة Google Tag Manager (GTM) وGoogle Analytics 4 (GA4) إذا كانا نشطين على الموقع. -
discourse-guest-gate:analytics(حدث متصفح مخصص): يسمح بالدمج مع أدوات الطرف الثالث (مثل Matomo أو Plausible أو خطافات ويب مخصصة) دون الحاجة إلى أي تعديلات برمجية إضافية.
الأحداث المتتبَّعة
-
guest_gate_shown(يُطلق عند ظهور النافذة المنبثقة)-
guest_gate_reason: نوع المحفّز (page_viewأوtimeأوscrollأوlightbox). -
guest_gate_path: مسار URL حيث تم عرض النافذة المنبثقة.
-
-
guest_gate_click(يُطلق عند تفاعل الزائر مع النافذة المنبثقة)-
guest_gate_click_action: الإجراء المحدد المتخذه (loginأوsignupأوsso_loginأوsso_signupأوexternal_<provider>مثل زر تسجيل الدخول عبر Google، أوdismissإذا أُغلقت دون اتخاذ إجراء). -
يتضمن نفس بيانات
reasonوpathلربط التفاعلات بمحفّزات العرض بسهولة.
-
الخصوصية وحماية البيانات
- لا يتم جمع أو إرسال أي معلومات شخصية معرِّفة (PII)، بل فقط البيانات الوصفية التشغيلية الدنيا المذكورة أعلاه.
قريباً…