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

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

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

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

iOS+

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

-FIRDebugEnabled

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

-FIRDebugDisabled

شما می توانید این آرگومان ها را با ویرایش طرح پروژه خود و افزودن یک ورودی جدید به "Arguments Passed On Launch" اضافه کنید.

اندروید

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

adb shell setprop debug.firebase.analytics.app PACKAGE_NAME

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

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

وب

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

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

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

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

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

با انتخاب فلش کنار StreamView در بالای ناوبری Google Analytics و انتخاب DebugView به DebugView بروید.

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

گزارش DebugView.

جریان Seconds (ستون میانی) رویدادهایی را نشان می دهد که در 60 ثانیه گذشته ثبت شده اند. جریان Minutes (ستون سمت چپ) مجموعه‌ای از آرشیوهای رویدادهای 30 دقیقه گذشته را نشان می‌دهد. و ستون سمت راست رویدادهای برتر ثبت‌شده در دوره 30 دقیقه‌ای و همچنین ویژگی‌های کاربر فعلی را برای دستگاه توسعه انتخاب‌شده فعلی نشان می‌دهد.

جریان ثانیه

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

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

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

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

جریان دقیقه

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

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

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

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

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

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

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

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