لماذا لا يتتبع Plausible أو GA4 الزوار؟
تحقّق أولًا من أدوات حجب الإعلانات، ثم من سماح ترويسات CSP بنصوص التتبع، وصحة إعداد النطاق المخصص، وترتيب تحميل النصوص.
أعددت Plausible أو GA4 وانتظرت بضعة أيام، ولوحة المعلومات تُظهر صفرًا من الجلسات — أو رقمًا منخفضًا بشكل مريب لا يعكس الواقع. لأعطال تتبع التحليلات أسباب شائعة محددة، ومعظمها قابل للإصلاح دون المساس بشيفرة VeloCMS.
هل تختبر بأداة حجب إعلانات مفعّلة؟
تحقق من هذا قبل أي شيء آخر. افتح مدونتك في متصفح مع تعطيل جميع الإضافات (وضع التصفح الخاص في Chrome مع تعطيل الإضافات، أو ملف تعريف Firefox جديد) وتحقق مما إذا كانت أداة التحليلات تسجّل الزيارة. فإن سجّلتها، فأداة حجب الإعلانات لديك تحجب نص التتبع أثناء اختباراتك — وهذا سلوك متوقع. قرّاؤك الذين لا يستخدمون أدوات حجب الإعلانات يُتتبَعون بشكل صحيح.
تشير الدراسات إلى أن 25–40% من قراء سطح المكتب يستخدمون أدوات حجب الإعلانات. ويُحجب Plausible تحديدًا بقوة بواسطة uBlock Origin وPrivacy Badger. لتتبع هؤلاء المستخدمين، يتيح Plausible خيار نص تتبع عبر وكيل (Proxy) — أي تقديم نص Plausible من نطاقك الخاص. راجع وثائق Plausible لإعداد الوكيل.
ترويسات CSP تحجب نص التتبع
يضبط VeloCMS سياسة أمان محتوى (CSP) صارمة على جميع الصفحات. يسمح CSP الافتراضي بالنصوص البرمجية من أصل الصفحة ذاتها بالإضافة إلى عدد محدود من شبكات توصيل المحتوى (CDN) المسموح بها صراحةً. إذا لم يكن نطاق نص التحليلات ضمن قائمة السماح في CSP، فسيحجبه المتصفح بصمت. ستظهر في وحدة تحكم المتصفح (Console) رسالة خطأ مثل: «Refused to load the script because it violates the following Content Security Policy directive: script-src...».
سياسة CSP تضبطها المنصة ولا يمكن تعديلها من لوحة التحكم. وهي تسمح مسبقاً بمزوّدي التحليلات المدمجين (Plausible وGoogle Analytics وTag Manager وMicrosoft Clarity)، لذا ثبّتهم عبر لوحة التحكم ← الإضافات بدلاً من لصق وسم script مكتوب يدوياً. فإن ظلّت وحدة تحكم المتصفح تُظهر مخالفة لنص برمجي من نطاق آخر، فهذا النطاق ليس ضمن قائمة السماح — تواصل مع الدعم مع ذكر النطاق بالضبط كما يظهر في خطأ وحدة التحكم.
GA4 — تأخر التقارير الفورية
قد تصل فترة تأخر معالجة البيانات في تقارير GA4 القياسية إلى 48 ساعة. لا تحكم على تتبع GA4 بالنظر إلى التقارير القياسية في اليوم الأول. بدلًا من ذلك، تحقق من تقرير «الوقت الفعلي» في Google Analytics — فهو يتحدّث خلال ثوانٍ وهو الطريقة الصحيحة للتحقق من عمل مقتطف التتبع. إذا رأيت نفسك في تقرير الوقت الفعلي عند زيارة مدونتك، فـ GA4 يعمل بشكل صحيح. ستلحق التقارير القياسية بالركب قريبًا.
وكيل النطاق المخصص لـ Plausible
لتقليل أثر أدوات حجب الإعلانات، يمكنك توجيه نص Plausible عبر نطاقك الخاص باستخدام Cloudflare Workers. يتضمن الإعداد إنشاء Cloudflare Worker يُحيل الطلبات إلى plausible.io وتقديم نص Plausible من analytics.yourdomain.com/js/script.js بدلًا من plausible.io/js/plausible.js. يستغرق ذلك نحو 10 دقائق ويُحسّن اكتمال التتبع بشكل ملحوظ. راجع وثائق Plausible الرسمية حول الوكيل للاطلاع على نص Cloudflare Worker.
ترتيب تحميل النصوص البرمجية وتوقيتها
يحمّل VeloCMS نصوص التحليلات باستخدام مكوّن Script في Next.js بالاستراتيجية strategy='afterInteractive'. يعني هذا أن النص يُحمَّل بعد أن تصبح الصفحة تفاعلية — ولن يعيق تحميلها. إذا أضفت نص تحليلات مخصصًا مباشرةً إلى قالب HTML الخاص بالسمة بدلًا من تثبيت إضافة المزوّد من لوحة التحكم ← الإضافات (Plausible أو Google Analytics أو Fathom أو Clarity)، فقد يعيق عرض الصفحة. استخدم الإضافة من لوحة التحكم ← الإضافات لإضافة مقتطف التتبع — يتولى VeloCMS تلقائيًا اختيار استراتيجية تحميل النص البرمجي.
إذا فعّلت في الوقت ذاته تتبع التحليلات على جانب العميل وعلى جانب الخادم، فقد تُحتسب الجلسات مرتين. اختر أسلوبًا واحدًا: العميل فقط (الافتراضي) أو الخادم فقط، وليس كليهما معًا.