رویدادهای اشکال زدایی

DebugView شما را قادر می‌سازد تا داده‌های خام رویدادهای ثبت‌شده توسط برنامه‌تان را در دستگاه‌های توسعه‌دهنده تقریباً به‌صورت بلادرنگ مشاهده کنید. این قابلیت برای اهداف اعتبارسنجی در طول مرحله ابزار دقیق توسعه بسیار مفید است و می‌تواند به شما در کشف خطاها و اشتباهات در پیاده‌سازی Analytics و تأیید صحت ثبت همه رویدادها و ویژگی‌های کاربر کمک کند.

فعال کردن حالت اشکال‌زدایی

به‌طورکلی، رویدادهای ثبت‌شده توسط برنامه شما در طول تقریباً یک ساعت دسته‌بندی شده و با هم آپلود می‌شوند. این رویکرد باعث صرفه‌جویی در مصرف باتری دستگاه‌های کاربران نهایی و کاهش مصرف داده شبکه می‌شود. با این حال، برای اعتبارسنجی پیاده‌سازی Analytics خود (و برای مشاهده Analytics خود در گزارش DebugView)، می‌توانید حالت اشکال‌زدایی را در دستگاه توسعه خود فعال کنید تا رویدادها با حداقل تأخیر آپلود شوند.

آی‌او‌اس+

برای فعال کردن حالت اشکال‌زدایی Analytics در دستگاه توسعه‌دهنده خود، آرگومان خط فرمان زیر را در Xcode مشخص کنید:

-FIRDebugEnabled

این رفتار تا زمانی که شما صریحاً حالت اشکال‌زدایی را با مشخص کردن آرگومان خط فرمان زیر غیرفعال کنید، ادامه می‌یابد:

-FIRDebugDisabled

شما می‌توانید این آرگومان‌ها را با ویرایش طرح پروژه خود و اضافه کردن یک ورودی جدید به «آرگومان‌های ارسال شده در هنگام راه‌اندازی» اضافه کنید.

اندروید

برای فعال کردن حالت اشکال‌زدایی Analytics در دستگاه اندروید، دستورات زیر را اجرا کنید:

adb shell setprop debug.firebase.analytics.app PACKAGE_NAME

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

adb shell setprop debug.firebase.analytics.app .none.

وب

برای فعال کردن حالت اشکال‌زدایی Analytics در مرورگر خود، افزونه‌ی کروم Google Analytics Debugger را نصب کنید.

پس از نصب، افزونه را فعال کرده و صفحه را رفرش کنید. از آن به بعد، افزونه در حالت اشکال‌زدایی، رویدادها را در برنامه شما ثبت می‌کند.

شما می‌توانید رویدادهای ثبت‌شده در DebugView را در کنسول Firebase مشاهده کنید.

گزارش داده‌های رویداد

پس از فعال کردن حالت اشکال‌زدایی (debug mode) در دستگاه‌های توسعه خود، با انتخاب پیکان کنار StreamView در منوی بالای Google Analytics و انتخاب DebugView، به DebugView بروید.

با انتخاب پیکان کنار StreamView در منوی بالای <span class=> به DebugView بروید. گوگل آنالیتیکس و انتخاب DebugView">

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

گزارش DebugView.

جریان ثانیه‌ها (ستون وسط) رویدادهایی را نشان می‌دهد که در ۶۰ ثانیه گذشته ثبت شده‌اند. جریان دقیقه‌ها (ستون سمت چپ) مجموعه‌ای از بایگانی رویدادها در ۳۰ دقیقه گذشته را نشان می‌دهد. و ستون سمت راست، رویدادهای برتر ثبت شده در دوره ۳۰ دقیقه‌ای و همچنین ویژگی‌های کاربر فعلی برای دستگاه توسعه انتخاب شده فعلی را نشان می‌دهد.

جریان ثانیه‌ها

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

یک لیست نمونه از پارامترهای رویداد.

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

یک نمونه از ویژگی کاربر.

پخش زنده دقایق

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

نمونه‌ای از جریان دقایق.

رویدادهای برتر و ویژگی‌های کاربر فعلی

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

نمونه‌ای از جدول رویدادهای برتر.

انتخابگر دستگاه

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

نمونه‌ای از انتخابگر دستگاه.