راه‌اندازی Google Analytics خود را تأیید و عیب‌یابی کنید

این راهنما به شما کمک می‌کند تأیید کنید برچسب Google Analytics شما به‌درستی نصب شده است و داده‌ها را ارسال می‌کند، و درصورتی‌که داده‌های موردانتظارتان را نمی‌بینید، مراحلی را برای تشخیص مشکلات رایج ارائه می‌دهد.

روش‌های درستی‌سنجی فوری

این ابزارها به شما کمک می‌کنند تا به‌محض راه‌اندازی برچسب، بررسی کنید که آیا برچسب شما فعال می‌شود یا نه:

  • نمای اشکال‌زدایی Google Analytics: «نمای اشکال‌زدایی» را فعال کنید تا رویدادها را در زمان واقعی هم‌زمان با تعامل با وب‌سایت یا برنامه‌تان ببینید. این بهترین راه برای تأیید رویدادها و پارامترها است که به‌درستی ارسال می‌شوند. پایش رویدادها در DebugView را ببینید. برای فعال کردن حالت اشکال‌زدایی برای جلسه در gtag.js، 'debug_mode': true را ارسال کنید:

    gtag('config', 'G-XXXXXX', { 'debug_mode': true });
    
  • همراه دستیار برچسب Google: این افزونه مرورگر به اعتبارسنجی پیاده‌سازی برچسب Google‏ (gtag.js) در وب‌سایت‌ها کمک می‌کند. نشان می‌دهد کدام برچسب‌ها فعال هستند و داده‌ها منتقل می‌شوند. درباره Tag Assistant را ببینید.

  • ابزارهای توسعه‌دهنده مرورگر:

    • برگه شبکه: ابزارهای توسعه‌دهنده مرورگرتان (مثلاً Chrome DevTools) را باز کنید و هنگام پیمایش در سایتتان، درخواست‌های شبکه به google-analytics.com/g/collect یا analytics.google.com/g/collect را جستجو کنید. باید ببینید که این درخواست‌ها در هر بارگذاری صفحه و برای رویدادها فعال می‌شوند. رمز وضعیت 200 OK یا 204 No Content نشان‌دهنده انتقال موفق است.
    • برگه کنسول: هرگونه خطای جاوا اسکریپت مربوط به gtag.js یا کد سایتتان را که ممکن است مانع از اجرای برچسب شود بررسی کنید.

بررسی گزارش‌های Google Analytics

  • گزارش بلادرنگ: داده‌ها باید ظرف چند دقیقه پس‌از فعال شدن صحیح برچسب در گزارش بلادرنگ ظاهر شوند. باید بازدیدهای صفحه، رویدادها، و کاربران فعال را ببینید.
  • گزارش‌های استاندارد: اکثر داده‌های موجود در گزارش‌های استاندارد ۲۴ تا ۴۸ ساعت طول می‌کشد تا به‌طور کامل پردازش و دردسترس قرار گیرند. اگر داده‌های کامل را بلافاصله در خارج از «زمان واقعی» و «نمای اشکال‌زدایی» مشاهده نکردید، نگران نباشید.

مشکلات رایج راه‌اندازی و نحوه رفع آن‌ها

  • شناسه سنجش نادرست: مطمئن شوید «شناسه سنجش» در فراخوانی gtag('config', 'G-XXXXXX') دقیقاً با شناسه تنظیمات جاری‌سازی داده‌های وب Google Analytics شما مطابقت داشته باشد. غلط املایی در «شناسه اندازه‌گیری» یکی از رایج‌ترین و آسان‌ترین اشتباهات در راه‌اندازی است، بنابراین آن را با دقت دوباره‌سنجی کنید.
  • برچسب در همه صفحه‌ها نیست: گزیده برچسب Google باید در بخش <head> همه صفحه‌هایی که می‌خواهید پیگیری کنید وجود داشته باشد.
  • جای‌گذاری نادرست برچسب: برچسب سایت Global ‏ (gtag.js) باید تا حد امکان در بالای <head> کد HTML شما قرار گیرد.
  • مشکلات حالت موافقت: اگر «حالت موافقت» را پیاده‌سازی کرده‌اید، مطمئن شوید که برچسب‌ها بی‌دلیل مسدود نشده باشند. برچسب‌ها فقط پس‌از اینکه کاربر رضایت لازم را ارائه کرد فعال می‌شوند. از «دستیار برچسب» برای اشکال‌زدایی حالت‌های رضایت استفاده کنید. به عیب‌یابی حالت رضایت مراجعه کنید.
  • مسدودکننده‌های آگهی و افزونه‌های حریم خصوصی: برخی‌از افزونه‌های مرورگر می‌توانند مانع از اجرای اسکریپت‌های Google Analytics شوند. در پنجره ناشناس یا مرورگر دیگری که افزونه‌های آن غیرفعال است آزمایش کنید.
  • فیلترهای Google Analytics: بررسی کنید که آیا فیلترهای داده در تنظیمات دارایی Google Analytics شما فعال هستند (سرپرست > تنظیمات داده > فیلترهای داده) که ممکن است داده‌های موردنظرتان را مستثنی کنند.
  • ذخیره در حافظه نهان: ذخیره در حافظه نهان مرورگر یا سمت سرور ممکن است نسخه‌های قدیمی‌تر صفحه را بدون برچسب ارائه دهد. پس‌از افزودن برچسب، حافظه‌های نهان را پاک کنید.

آنچه انتظار می‌رود: داده‌های اولیه

پس‌از شروع جریان داده‌ها، باید موارد زیر را ببینید:

  • رویدادهای خودکار ثبت‌شده: page_view،‏ session_start، first_visit، و user_engagement به‌طور پیش‌فرض جمع‌آوری می‌شوند.
  • ابعاد پایه: در گزارش‌ها، داده‌های ابعادی مثل مسیر صفحه، منبع/واسطه، دسته دستگاه، کشور، و غیره را خواهید دید.

چقدر طول می‌کشد تا داده‌ها نشان داده شود؟

  • DebugView: رویدادها ظرف چند ثانیه ظاهر می‌شوند.
  • گزارش‌های بلادرنگ: داده‌ها ظرف چند دقیقه نشان داده می‌شود.
  • گزارش‌های استاندارد: اجازه دهید ۲۴ تا ۴۸ ساعت برای پردازش کامل داده‌ها و گزارش‌دهی زمان بگذرد.

اگر این مراحل را انجام داده‌اید و هنوز داده‌ها را نمی‌بینید، پیاده‌سازی برچسب را دوباره بررسی کنید و با مرکز راهنمایی Google Analytics مشورت کنید.