اشکال زدایی

این راهنما نحوه استفاده از نسخه اشکال زدایی کتابخانه analytics.js را توضیح می دهد تا اطمینان حاصل شود که پیاده سازی های شما به درستی کار می کنند.

نسخه اشکال زدایی کتابخانه analytics.js

گوگل آنالیتیکس یک نسخه اشکال زدایی از کتابخانه analytics.js را ارائه می دهد که پیام های دقیق را در کنسول جاوا اسکریپت هنگام اجرا ثبت می کند. این پیام ها شامل دستورات با موفقیت اجرا شده و همچنین اخطارها و پیام های خطا است که می تواند به شما بگوید که برچسب شما به درستی تنظیم نشده است. همچنین تجزیه و تحلیل هر بازدید ارسال شده به Google Analytics را ارائه می دهد، بنابراین می توانید دقیقاً ببینید چه داده هایی گرفته می شود.

می‌توانید نسخه اشکال‌زدایی analytics.js را با تغییر URL موجود در تگ جاوا اسکریپت از 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 ارسال می کند. این به شما امکان می‌دهد از وب‌سایتی که کد analytics.js را اجرا می‌کند بازدید کنید و اجرای آن را بدون دخالت در نحوه جمع‌آوری داده‌ها بررسی کنید.

اگر نمی‌خواهید در موارد خاص (مثلاً محیط‌های توسعه یا آزمایش) داده‌ها را به Google Analytics ارسال کنید، می‌توانید وظیفه sendHitTask را غیرفعال کنید و چیزی ارسال نخواهد شد.

هنگام اجرا بر روی لوکال هاست، کد زیر از ارسال هرگونه بازدید به Google Analytics جلوگیری می کند:

(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 را همانطور که در بالا توضیح داده شد بارگیری کنید و خط زیر را از جاوا اسکریپت قبل از هر فراخوانی به صف فرمان 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');

افزونه Google Analytics Debugger Chrome

گوگل آنالیتیکس همچنین یک برنامه افزودنی کروم ارائه می دهد که می تواند نسخه اشکال زدایی analytics.js را بدون نیاز به تغییر برچسب خود فعال کند. این به شما امکان می دهد تا سایت های خود را اشکال زدایی کنید و همچنین ببینید که سایت های دیگر چگونه Google Analytics را با analytics.js پیاده سازی کرده اند.

دستیار تگ گوگل

Google Tag Assistant یک برنامه افزودنی کروم است که به شما کمک می کند تا برچسب را در وب سایت خود تأیید کنید و مشکلات رایج را عیب یابی کنید. این یک ابزار ایده آل برای اشکال زدایی و آزمایش پیاده سازی های analytics.js شما به صورت محلی و اطمینان از صحت همه چیز قبل از استقرار کد شما در تولید است.

دستیار برچسب با این امکان کار می کند که یک جریان کاربر معمولی را ضبط کنید. تمام بازدیدهایی را که ارسال می‌کنید جمع‌آوری می‌کند، آن‌ها را برای هر گونه مشکلی بررسی می‌کند و گزارش کاملی از تعاملات به شما می‌دهد. اگر هر گونه مشکل یا پیشرفت احتمالی را تشخیص دهد، به شما اطلاع خواهد داد.

برای کسب اطلاعات بیشتر، از مرکز راهنمایی دیدن کنید و درباره «دستیار برچسب» و «درباره ضبط‌های دستیار برچسب» بخوانید. همچنین می‌توانید این ویدیوی نمایشی را تماشا کنید که نشان می‌دهد از «دستیار برچسب» برای شناسایی خطاها و بررسی اعتبار پیاده‌سازی‌های پیشرفته مانند اندازه‌گیری بین دامنه استفاده می‌شود.