راهنما خطاها در ابزار آنالیز وب

فیلتر #

۱. موارد #

با استفاده از دکمه فیلتر می‌تونی نمایش خطاها رو محدودتر کنی تا سریع‌تر به موردی که دنبالش هستی برسی.

1. مسیر
   نمایش اطلاعات بر اساس آدرس (URL) صفحات سایت. برای بررسی یک صفحه یا بخش خاص از سایت کاربرد داره.
2. عنوان صفحه
   داده‌ها رو بر اساس عنوان صفحات فیلتر می‌کنه تا سریع‌تر صفحه موردنظرت رو پیدا کنی.
3. کوئری
   کاربران رو بر اساس پارامترهای موجود در Query String آدرس صفحه فیلتر می‌کنه.
4. صفحه
   برای نمایش اطلاعات مربوط به یک صفحه مشخص از سایت استفاده میشه.
5. نام میزبان
   اگر چند دامنه یا زیردامنه به وبینش متصل باشه، می‌تونی داده‌های هر میزبان رو جداگانه مشاهده کنی.
6. شناسه کاربر
   اطلاعات مربوط به یک کاربر مشخص رو نمایش میده؛ مناسب برای بررسی رفتار یک کاربر خاص.
7. نام رویداد
   گزارش‌ها رو فقط بر اساس یک رویداد مشخص مثل کلیک، ثبت فرم یا خرید نمایش میده.
8. ارجاع‌دهنده
   مشخص می‌کنه کاربران از چه سایت یا صفحه‌ای وارد سایت شما شدن.
9. کانال
   داده‌ها رو بر اساس کانال ورود کاربران مثل جستجوی گوگل، شبکه‌های اجتماعی یا تبلیغات فیلتر می‌کنه.
10. صفحه ورود
    کاربرانی رو نمایش میده که اولین صفحه ورودشون به سایت، صفحه انتخاب‌شده بوده.
11. صفحه خروج
    کاربرانی رو نمایش میده که آخرین صفحه‌ای که قبل از خروج از سایت دیدن، صفحه انتخاب‌شده بوده.
12. کشور
    نمایش اطلاعات کاربران یک کشور خاص.
13. منطقه
    فیلتر اطلاعات بر اساس استان یا منطقه جغرافیایی کاربران.
14. شهر
    نمایش اطلاعات کاربران یک شهر مشخص.
15. نوع دستگاه
    فیلتر کاربران بر اساس موبایل، دسکتاپ یا تبلت.
16. سیستم عامل
    نمایش اطلاعات کاربران بر اساس سیستم عامل مثل Windows، Android، iOS یا Linux.
17. نسخه سیستم عامل
    برای بررسی کاربران هر نسخه از سیستم عامل به صورت جداگانه.
18. مرورگر
    اطلاعات کاربران رو بر اساس مرورگرهایی مثل Chrome، Firefox، Safari و… نمایش میده.
19. نسخه مرورگر
    برای بررسی نسخه‌های مختلف هر مرورگر استفاده میشه.
20. زبان
    داده‌ها رو بر اساس زبان مرورگر کاربران فیلتر می‌کنه.
21. ابعاد صفحه نمایش
    کاربران رو بر اساس رزولوشن یا اندازه صفحه نمایش دستگاهشون فیلتر می‌کنه.
22. منبع UTM
    نمایش اطلاعات بر اساس مقدار utm_source؛ مثل Google، Telegram یا Instagram.
23. مدیوم UTM
    داده‌ها رو بر اساس utm_medium فیلتر می‌کنه؛ مثل Organic، CPC، Email یا Social.
24. کمپین UTM
    برای بررسی عملکرد کمپین‌های تبلیغاتی با استفاده از utm_campaign.
25. محتوای UTM
    بر اساس utm_content فیلتر می‌کنه؛ مناسب برای مقایسه نسخه‌های مختلف تبلیغات.
26. عبارت UTM
    اطلاعات رو بر اساس utm_term نمایش میده که معمولاً برای کلمات کلیدی تبلیغات استفاده میشه.
27. عرض جغرافیایی
    داده‌ها رو بر اساس عرض جغرافیایی کاربران فیلتر می‌کنه.
28. طول جغرافیایی
    داده‌ها رو بر اساس طول جغرافیایی کاربران نمایش میده.
29. منطقه زمانی
    نمایش اطلاعات کاربران بر اساس Time Zone دستگاه یا موقعیت جغرافیایی اون‌ها.

۲. عملگرها #

هنگام ساخت فیلتر، می‌تونی نوع مقایسه رو هم مشخص کنی:

• هست: مقدار دقیق با فیلتر برابر باشه.
• نیست: مقدار با فیلتر برابر نباشه.
• شامل: مقدار انتخاب‌شده داخل متن وجود داشته باشه.
• شامل نیست: مقدار انتخاب‌شده داخل متن وجود نداشته باشه.
• مطابقت با Regex: داده‌ها رو بر اساس یک عبارت منظم (Regular Expression) فیلتر می‌کنه. این گزینه برای جستجوهای پیشرفته و الگوهای خاص کاربرد داره.
• عدم مطابقت با Regex: فقط داده‌هایی نمایش داده میشن که با عبارت منظم (Regular Expression) واردشده مطابقت نداشته باشن.

💡نکته: Regex یک روش پیشرفته برای جستجو و فیلتر کردن متن‌هاست و بیشتر توسط کاربران حرفه‌ای و توسعه‌دهندگان استفاده میشه

۳. انتخاب مقادیر #

بعد از انتخاب نوع فیلتر، از این قسمت مقدار یا مقادیر موردنظرت رو انتخاب کن. فقط داده‌هایی که با مقدار انتخاب‌شده مطابقت داشته باشن، در گزارش نمایش داده میشن.

۴. ذخیره فیلترها #

اگر از یک فیلتر زیاد استفاده می‌کنی، می‌تونی اون رو ذخیره کنی تا بعداً فقط با یک کلیک دوباره اعمالش کنی.

نوار ابزار #

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

۱. کاربران آنلاین #

عدد سبزرنگ کنار نوار ابزار، تعداد کاربران آنلاینی رو نشون میده که در ۵ دقیقه گذشته داخل سایت فعال بودن.

با قرار دادن نشانگر ماوس روی این قسمت، توضیح مربوط به اون نمایش داده میشه.

این عدد به صورت لحظه‌ای بروزرسانی میشه و برای بررسی وضعیت فعلی ترافیک سایت کاربرد داره.

۲. خروجی گرفتن از گزارش‌ها #

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

در حال حاضر دو نوع خروجی در دسترسه:

• خروجی PDF
  گزارش فعلی رو به صورت فایل PDF دریافت می‌کنی که برای چاپ، ارائه یا اشتراک‌گذاری مناسبه.
• خروجی CSV
  اطلاعات جدول رو به صورت فایل CSV (فشرده‌شده ZIP) دریافت می‌کنی تا بتونی اون رو در نرم‌افزارهایی مثل Excel یا Google Sheets باز و تحلیل کنی.

۳. انتخاب بازه زمانی #

بالای صفحه میتونی مشخص کنی اطلاعات مربوط به چه زمانی نمایش داده بشه.

مثلا:

• امروز
• دیروز
• ۷ روز اخیر
• ۳۰ روز اخیر
• یا یک بازه زمانی دلخواه
• و….

با تغییر بازه زمانی، تمام آمار و نمودارهای این صفحه بر اساس همون تاریخ بروزرسانی میشن.

۴. جابه‌جایی بین روزها #

بدون اینکه از تقویم استفاده کنی، می‌تونی با فلش‌های کنار انتخاب تاریخ، بین روزها جابه‌جا بشی.

• فلش سمت چپ: نمایش گزارش روزهای قبل. با هر بار کلیک، یک روز به عقب می‌ری.
• فلش سمت راست: برگشت به روزهای بعد تا رسیدن به امروز. با کلیک روی فلش سمت راست می‌تونی دوباره به روزهای بعد برگردی تا در نهایت به امروز برسی.

لیست خطاها #

هر ردیف از جدول، مربوط به یک نوع خطاست.

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

۱. نوع خطا #

سمت راست هر ردیف، نوع خطا نمایش داده میشه.

مثلا:

• TypeError
• ReferenceError
• AbortError
• NetworkError
• Error

این مورد مشخص می‌کنه مرورگر چه نوع خطایی ثبت کرده.

۲. پیام خطا #

زیر نوع خطا، متن کامل خطا نمایش داده میشه.

مثلاً:

• Failed to fetch
• h is not defined
• Cannot read properties of null
• signal is aborted
• Permission denied

همین پیام معمولا اولین سرنخ برای پیدا کردن مشکل برنامه است.

۳. تعداد رخدادها #

این عدد نشون میده این خطا چند بار ثبت شده.

هرچی این عدد بیشتر باشه یعنی کاربران بیشتری با این مشکل روبه‌رو شدن.

۴. تعداد سشن‌ها #

این قسمت نشون میده این خطا در چند سشن مختلف اتفاق افتاده.

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

هر رخداد خطا #

بعد از باز کردن خطا، هر کارت مربوط به یک بار وقوع همون خطاست.

برای هر رخداد اطلاعات زیر نمایش داده میشه.

۱. صفحه‌ای که خطا داخلش اتفاق افتاده #

بالای هر کارت، مسیر صفحه‌ای که کاربر داخلش بوده نمایش داده میشه.

این موضوع کمک می‌کنه سریع متوجه بشی مشکل مربوط به کدوم بخش سایت بوده.

۲. زمان وقوع #

کنار مسیر صفحه، زمان ثبت خطا نمایش داده میشه.

با این اطلاعات می‌تونی زمان دقیق رخ دادن مشکل رو بررسی کنی.

دستگاه کاربر #

کنار زمان، اطلاعات دستگاه کاربر نمایش داده میشه.

مثل:

• موبایل یا دسکتاپ
• مرورگر
• سیستم عامل
• کشور

این اطلاعات کمک می‌کنه بفهمی آیا خطا فقط روی یک مرورگر یا دستگاه خاص اتفاق افتاده یا نه.

۳. پیام خطا #

برای هر رخداد، متن خطای ثبت‌شده دوباره نمایش داده میشه.

همین پیام معمولا علت اصلی مشکل رو مشخص می‌کنه.

۴. Stack Trace #

یکی از مهم‌ترین بخش‌های این صفحه Stack Trace هست.

Stack Trace مسیر اجرای برنامه تا لحظه ایجاد خطا رو نشون میده.

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

۵. آدرس فایل #

بالای Stack Trace معمولاً مسیر فایل یا صفحه‌ای که خطا داخلش رخ داده نمایش داده میشه.

در بسیاری از مواقع شماره خط و ستون هم مشخص میشه تا راحت‌تر محل خطا رو پیدا کنی.

۶. مشاهده کاربر #

برای هر خطا، سشنی که خطا داخلش رخ داده هم نمایش داده میشه.

از همین بخش می‌تونی روی مشاهده کاربر کلیک کنی و رفتار کاربر قبل و بعد از وقوع خطا رو بررسی کنی.

صفحه‌بندی #

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

1. رفتن به صفحه اول
   با کلیک روی این دکمه، مستقیما به صفحه اول نتایج منتقل میشی.
2. صفحه قبل
   برای مشاهده صفحه قبلی از این دکمه استفاده کن.
3. صفحه بعد
   با کلیک روی این دکمه، صفحه بعدی نتایج نمایش داده میشه.
4. رفتن به صفحه آخر
   با این دکمه می‌تونی مستقیماً به آخرین صفحه نتایج بری.
5. اندازه صفحه
   مشخص می‌کنه در هر صفحه چند ردیف از اطلاعات نمایش داده بشه.
   مثلاً اگر مقدار 10 رو انتخاب کنی، در هر صفحه حداکثر 10 ردیف نمایش داده میشه. با افزایش این عدد، تعداد نتایج بیشتری در یک صفحه می‌بینی و نیاز کمتری به جابه‌جایی بین صفحات خواهی داشت.
6. تعداد نتایج
   در سمت راست پایین جدول، تعداد رکوردهای نمایش داده‌شده و تعداد کل نتایج رو مشاهده می‌کنی.
   مثلا اگر نوشته شده باشد نمایش ۱ تا 4 از 4 صفحه یعنی در حال حاضر ردیف‌های ۱ تا 4 از مجموع 4 نتیجه نمایش داده شده‌اند.

این تب به چه دردی می‌خوره؟ #

تب خطاها برای پیدا کردن مشکلات واقعی سایت طراحی شده.

به کمک این بخش می‌تونی:

• ببینی کاربران بیشتر با چه خطاهایی روبه‌رو میشن.
• بفهمی خطا داخل کدوم صفحه اتفاق افتاده.
• تعداد دفعات وقوع هر خطا رو بررسی کنی.
• مرورگر یا دستگاه‌هایی که خطا داخلشون رخ داده رو شناسایی کنی.
• Stack Trace خطا رو ببینی.
• و در نهایت با مشاهده سشن کاربر، دقیقاً مسیر اتفاق افتادن خطا رو بررسی و راحت‌تر مشکل رو برطرف کنی.