Where do I find my GA4 Measurement ID?

Log into analytics.google.com, select your property, and go to Admin (the gear icon in the lower-left) → Data Streams → click your web stream. The Measurement ID is displayed at the top right of the stream details panel and starts with G- followed by ten alphanumeric characters (for example G-ABCDE12345). If you haven't created a GA4 property yet, the Google Analytics help center has a step-by-step setup wizard — the only thing you need to provide is your blog's URL (yoursubdomain.velocms.org...

How does VeloCMS inject the tracking script?

VeloCMS uses Next.js's next/script component with strategy='afterInteractive' to load the GA4 script asynchronously after the page has rendered. This means the tracking script never blocks your page's First Contentful Paint or Largest Contentful Paint — it loads quietly in the background after your content is already visible. The implementation follows Google's recommended gtag.js setup exactly: a script tag loading gtag.js from googletagmanager.com followed by the initialization call with yo...

Does the analytics script fire on admin pages?

No. VeloCMS deliberately excludes admin dashboard routes from the analytics script injection. Admin pages are behind authentication and including them in your GA4 data would inflate your session counts and skew your engagement metrics since your own editing sessions look nothing like a real reader visit. The tracking script only loads on public-facing routes: the homepage, post detail pages, tag archives, help center articles, and any custom pages you've built. This exclusion happens at the m...

What events does VeloCMS track automatically?

VeloCMS relies on GA4's Enhanced Measurement, which Google enables by default for all new properties. Enhanced Measurement automatically tracks page views, scroll depth (measuring 90% scroll as a deep-read signal), outbound link clicks, site search queries (if you have search enabled), and video engagement for YouTube embeds. You don't need to set up any custom events for these — they just work once the Measurement ID is connected. For more advanced tracking like reading time, paywall convers...

كيف أربط Google Analytics 4 بمدوّنتي على VeloCMS؟

لربط Google Analytics 4 بمدوّنتك على VeloCMS، انسخ معرّف القياس الخاص بك (الرمز الذي يبدأ بـ G-XXXXXXXXXX من إعدادات خاصية Google Analytics)، والصقه في Admin → Settings → Analytics → Google Analytics Measurement ID، ثم انقر Save. سيحقن VeloCMS نص gtag.js تلقائيًا في جميع الصفحات العامة من تلك اللحظة فصاعدًا، دون الحاجة إلى تعديل أي قالب أو إدراج وسوم نصية يدويًا.

أين أجد معرّف القياس 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 (تُفعَّل من Admin → Settings → Privacy → Cookie consent) نص التحليلات حتى يوافق القارئ على ملفات تعريف الارتباط التحليلية. فعّل هذه اللافتة قبل الإطلاق مع GA4 إذا كان جمهورك يشمل مقيمين في دول الاتحاد الأوروبي.