تصحيح الأخطاء

يوضّح هذا الدليل كيفية استخدام إصدار تصحيح الأخطاء من مكتبة analytics.js لضمان نجاح عمليات التنفيذ.

إصدار تصحيح الأخطاء في مكتبة analytics.js

توفِّر "إحصاءات Google" إصدار تصحيح أخطاء من مكتبة analytics.js تسجِّل الرسائل التفصيلية إلى وحدة تحكُّم JavaScript أثناء تشغيلها. وتتضمّن هذه الرسائل الأوامر التي تم تنفيذها بنجاح، بالإضافة إلى تحذيرات ورسائل خطأ يمكن أن تخبرك في حال إعداد علامتك بشكل غير صحيح. ويوفر أيضًا تفصيلًا لكل نتيجة يتم إرسالها إلى "إحصاءات Google"، بحيث يمكنك أن تعرف بالضبط البيانات التي يتم تسجيلها.

يمكنك تفعيل إصدار تصحيح الأخطاء من analytics.js عن طريق تغيير عنوان URL في علامة JavaScript من https://www.google-analytics.com/analytics.js إلى https://www.google-analytics.com/analytics_debug.js:

(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');

ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');

ملاحظة: يجب استخدام إصدار تصحيح الأخطاء من analytics.js أثناء التطوير والاختبار فقط، لأنّ حجمه أكبر قليلاً من analytics.js وستؤدي إلى إبطاء تحميل صفحتك.

اختبار عملية التنفيذ بدون إرسال نتائج

وسيرسل إصدار تصحيح الأخطاء من analytics.js البيانات إلى "إحصاءات Google" تمامًا مثل الإصدار الذي لا يحتوي على تصحيح الأخطاء. يتيح لك ذلك الانتقال إلى موقع إلكتروني يستخدم رمز analytics.js وفحص عملية التنفيذ بدون التدخل في كيفية تسجيل البيانات.

إذا كنت لا تريد إرسال البيانات إلى "إحصاءات Google" في حالات معيّنة (مثل بيئات التطوير أو الاختبار)، يمكنك إيقاف المهمة sendHitTask ولن يتمّ إرسال أيّ شيء.

عند التشغيل على مضيف محلي، سيمنع الرمز التالي إرسال أي نتائج إلى "إحصاءات Google":

(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');

ga('create', 'UA-XXXXX-Y', 'auto');

if (location.hostname == 'localhost') {
  ga('set', 'sendHitTask', null);
}

ga('send', 'pageview');

تتبُّع تصحيح الأخطاء

سيؤدي تفعيل تصحيح أخطاء التتبع إلى إخراج المزيد من المعلومات المطولة إلى وحدة التحكم.

لتفعيل تصحيح أخطاء التتبع، حمِّل إصدار تصحيح الأخطاء من analytics.js كما هو موضّح أعلاه وأضِف السطر التالي من JavaScript قبل أي عمليات استدعاء لقائمة انتظار الأوامر ga().

window.ga_debug = {trace: true};

في ما يلي العلامة الكاملة التي تم تفعيل تصحيح أخطاء التتبُّع بها:

(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');

window.ga_debug = {trace: true};
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');

إضافة Debugger لخدمة "إحصاءات Google" على Chrome

توفّر "إحصاءات Google" أيضًا إضافة في Chrome يمكنها تفعيل إصدار تصحيح الأخطاء لمقتطف analytics.js بدون أن يُطلب منك تغيير علامتك. يتيح لك ذلك تصحيح الأخطاء في مواقعك الإلكترونية والاطّلاع أيضًا على كيفية استخدام المواقع الإلكترونية الأخرى لخدمة "إحصاءات Google" باستخدام analytics.js.

Google Tag Assistant

Google Tag Assistant هي إحدى إضافات Chrome التي تساعدك في التحقّق من صحة العلامة على موقعك الإلكتروني وتحديد المشاكل الشائعة وحلّها. وهي أداة مثالية لتصحيح الأخطاء واختبار عمليات تنفيذ مقتطف analytics.js محليًا والتأكد من صحة كل شيء قبل نشر الرمز في مرحلة الإنتاج.

تعمل Tag Assistant عن طريق السماح لك بتسجيل تدفق مستخدم عادي. فهو يجمع جميع النتائج التي ترسلها، ويتحقق من وجود أي مشاكل، ويمنحك تقريرًا كاملاً بالتفاعلات. وفي حال رصد أي مشاكل أو تحسينات محتملة، سيتم إعلامك بذلك.

لمزيد من المعلومات، يُرجى زيارة مركز المساعدة وقراءة لمحة عن Tag Assistant ولمحة عن تسجيلات Tag Assistant. يمكنك أيضًا مشاهدة هذا الفيديو التوضيحي الذي يوضّح استخدام Tag Assistant لرصد الأخطاء والتحقّق من صلاحية عمليات التنفيذ المتقدّمة، مثل القياس على جميع النطاقات.