كيف أربط Google Analytics 4 بمدوّنتي على VeloCMS؟
أضف معرّف القياس GA4 في إضافة Google Analytics 4 (لوحة التحكم ← الإضافات) وسيحقن VeloCMS سكريبت التتبع في كل صفحة عامة.
لربط Google Analytics 4 بمدوّنتك على VeloCMS، انسخ معرّف القياس الخاص بك (الرمز الذي يبدأ بـ G-XXXXXXXXXX من إعدادات خاصية Google Analytics)، وانتقل إلى لوحة التحكم ← الإضافات، ثبّت إضافة Google Analytics، والصق المعرّف في حقل «معرّف القياس» (Measurement ID) في الإضافة، ثم انقر «حفظ». سيحقن VeloCMS سكريبت gtag.js تلقائيًا في جميع الصفحات العامة من تلك اللحظة فصاعدًا، دون الحاجة إلى تعديل أي قالب أو إدراج وسوم script يدويًا.
أين أجد معرّف القياس GA4؟
سجّل الدخول إلى analytics.google.com، حدد خاصيتك، واذهب إلى Admin (أيقونة الترس في أسفل اليسار) ← Data Streams ← انقر على تدفق الويب الخاص بك. يظهر معرّف القياس في أعلى يمين لوحة تفاصيل التدفق، ويبدأ بـ G- يتبعه عشرة أحرف وأرقام، (مثل G-ABCDE12345). إن لم تكن قد أنشأت خاصية GA4 بعد، يوفر مركز مساعدة Google Analytics معالج إعداد خطوة بخطوة — كل ما تحتاج إلى تقديمه هو رابط مدوّنتك (yoursubdomain.velocms.org أو نطاقك المخصص).
كيف يحقن VeloCMS سكريبت التتبع؟
يستخدم VeloCMS مكوّن next/script من Next.js بالاستراتيجية strategy='afterInteractive' لتحميل سكريبت GA4 بصورة غير متزامنة بعد اكتمال عرض الصفحة. هذا يعني أن سكريبت التتبع لا يُعيق أبدًا أول ظهور للمحتوى (First Contentful Paint) ولا أكبر عنصر مرئي (Largest Contentful Paint) — إذ يُحمَّل بهدوء في الخلفية بعد أن يصبح المحتوى مرئيًا للقارئ. يتبع التطبيق إعداد gtag.js الموصى به من Google تمامًا: وسم نصي يُحمِّل gtag.js من googletagmanager.com، يتبعه استدعاء التهيئة بمعرّف القياس الخاص بك.
هل يُطلَق سكريبت التحليلات في صفحات لوحة التحكم؟
لا. يستثني VeloCMS عمدًا مسارات لوحة التحكم من حقن سكريبت التحليلات. صفحات لوحة التحكم محمية بمصادقة، وإدراجها في بيانات GA4 سيُضخّم عدد جلساتك ويُشوّه مقاييس التفاعل، إذ لا تشبه جلسات التحرير الخاصة بك زيارة قارئ حقيقي في شيء. لا يُحمَّل سكريبت التتبع إلا في المسارات العامة: الصفحة الرئيسية، وصفحات تفاصيل المقالات، وأرشيفات الوسوم، ومقالات مركز المساعدة، وأي صفحات مخصصة أنشأتها. يحدث هذا الاستثناء على مستوى البرنامج الوسيط (middleware) فيعمل باتساق بصرف النظر عن متصفحك أو إعدادات حاجب الإعلانات.
ما الأحداث التي يتتبعها VeloCMS تلقائيًا؟
يعتمد VeloCMS على ميزة Enhanced Measurement في GA4 التي تُفعّلها Google تلقائيًا لجميع الخصائص الجديدة. تتتبع هذه الميزة تلقائيًا مشاهدات الصفحات، وعمق التمرير (بقياس التمرير إلى 90% من الصفحة كإشارة للقراءة المعمّقة)، ونقرات الروابط الخارجية، واستعلامات البحث في الموقع (إن فعّلت خاصية البحث)، ومشاركة مقاطع YouTube المُضمَّنة. لا تحتاج إلى إعداد أي أحداث مخصصة لهذه الميزات — فهي تعمل فور ربط معرّف القياس. أما لمتطلبات التتبع المتقدمة كوقت القراءة، وأحداث تحويل الجدار المدفوع، أو إسناد الاشتراك في النشرة البريدية، فستُهيّئ أحداثًا مخصصة عبر Google Tag Manager، وهو تكامل منفصل تُضيفه من لوحة Head & Footer Code المتاحة في خطة Business.
إن كانت مدوّنتك تستقطب قراء أوروبيين، فقد تُخالف إضافة GA4 دون آلية موافقة لوائح GDPR. تظهر لافتة الموافقة على ملفات تعريف الارتباط المدمجة في VeloCMS لقرّائك تلقائياً بمجرد تفعيل GA4 — فلا يوجد مفتاح منفصل لتشغيلها — وهي تُوقف سكريبت التحليلات حتى يوافق القارئ على ملفات تعريف الارتباط التحليلية.