برای هر یک از برنامه های شما، Crashlytics به طور خودکار معیارهای بدون خرابی را محاسبه و نمایش می دهد، به ویژه درصد کاربران بدون خرابی و درصد جلسات بدون خرابی . این معیارها می توانند به شما کمک کنند تا به سرعت پایداری برنامه خود را درک کنید.
می‌توانید نمودارهایی از این معیارهای بدون خرابی را در بالای داشبورد Crashlytics بیابید، و می‌توانید این نمودارها را بر اساس ابعاد مختلف، مانند محدوده زمانی، ساخت و (برای برنامه‌های Android) توسط آهنگ Google Play فیلتر کنید.
توجه داشته باشید که معیارهای بدون خرابی فقط برای رویدادهای مرگبار محاسبه می‌شوند (و استثنائات کشف نشده به عنوان مرگبار برای Unity و Flutter گزارش می‌شوند).
معیارهای بدون خرابی را دریافت کنید
برای اکثر برنامه‌ها، وقتی Crashlytics SDK را در برنامه خود ادغام می‌کنید، معیارهای بدون خرابی به‌طور خودکار محاسبه می‌شوند. با این حال، شرایط خاصی وجود دارد که در آن Crashlytics داده‌های لازم را برای محاسبه معیارهای بدون خرابی دریافت نمی‌کند:
ساخت‌های برنامه شما که از نسخه قدیمی Crashlytics SDK استفاده می‌کنند (در زیر با حداقل نسخه‌های پشتیبانی‌شده آشنا شوید)
ساخت‌های برنامه شما که جمع‌آوری و گزارش خودکار داده‌های Crashlytics را غیرفعال می‌کند (در بخش «تأثیر تنظیمات جمع‌آوری داده‌ها بر کیفیت معیارها» این صفحه بیشتر بیاموزید)
نسخه‌های SDK که از معیارهای بدون خرابی پشتیبانی می‌کنند
برای دریافت معیارهای بدون خرابی، باید برنامه خود را به‌روزرسانی کنید تا از نسخه Crashlytics SDK استفاده کنید که از آنها پشتیبانی می‌کند. موارد زیر حداقل نسخه های پشتیبانی شده از Crashlytics SDK هستند که می توانند معیارهای بدون خرابی را تقویت کنند:
- پلتفرم های اپل: v10.8.0+
- Android: نسخه 18.6.0+ ( BoM v32.6.0+)
- فلوتر: نسخه 3.4.5+
- یونیتی: 11.7.0+
برای ساخت‌های برنامه‌تان که از نسخه به‌روزرسانی‌شده SDK استفاده می‌کنند، باید به‌طور خودکار معیارهای بدون خرابی دریافت کنید.
معیارهای بدون تصادف چیست؟
معیارهای بدون خرابی شامل کاربران بدون خرابی و جلسات بدون خرابی است.
معیارهای بدون خرابی به دو مفهوم بستگی دارد: کاربران و جلسات. برای دریافت معیارهای بدون خرابی برای برنامه خود، باید از یک نسخه Crashlytics SDK استفاده کنید که می تواند اطلاعات مربوط به هر دوی این مفاهیم را ارسال کند. Crashlytics چگونه یک کاربر را از یک جلسه متمایز می کند:
کاربر نصب فردی برنامه شما در یک دستگاه است. به عنوان مثال، اگر شخصی برنامه شما را روی چندین دستگاه مختلف نصب کرده باشد، Crashlytics هر نصب را به عنوان یک کاربر متفاوت و منحصر به فرد حساب می کند.
جلسه یک دوره زمانی مداوم است که کاربر با یک برنامه درگیر است. یک جلسه جدید زمانی شروع می شود که برنامه به صورت سرد شروع شود یا برنامه پس از حداقل 30 دقیقه پس زمینه در پیش زمینه قرار گیرد.
همچنین، معیارهای بدون خرابی فقط برای رویدادهای مرگبار محاسبه می‌شوند (و استثنائات کشف نشده به عنوان کشنده برای Unity و Flutter گزارش می‌شوند).
معیار کاربران بدون خرابی چیست؟
معیار کاربران بدون خرابی، درصد کاربرانی است که در یک بازه زمانی انتخاب شده با برنامه شما درگیر بوده اند اما خرابی نداشته اند. این معیار نشان دهنده تجربه ای است که برنامه شما به یک کاربر ارائه می دهد. اغلب به عنوان معیار کلیدی سلامت برای کل برنامه ردیابی می شود، زمانی که هدف تجربه کلی کاربر است.
این معیار ممکن است به طور خاص برای انواع برنامه های زیر قابل استفاده باشد:
برنامه‌هایی با جلسات طولانی و معمولی مانند برنامه‌های پخش درخواستی، برنامه‌های رسانه‌های اجتماعی یا بازی‌های معمولی، جایی که کاربر می‌تواند از جایی که پایان داده است ادامه دهد. از آنجایی که کاربران معمولاً در تجربه‌های طولانی‌تر و اغلب چند جلسه‌ای با این برنامه‌ها درگیر می‌شوند، به حداکثر رساندن تعداد کل کاربران بدون خرابی نسبت به اطمینان از بی‌عیب بودن هر جلسه، اولویت دارد.
برنامه‌هایی با پایگاه‌های کاربری تثبیت‌شده مانند برنامه‌های کاری تثبیت‌شده یا پلت‌فرم‌های آنلاین در مقیاس بزرگ، که در آن عادت و نیاز به این پلت‌فرم‌ها بیشتر از ناراحتی ناشی از خرابی است.
معیار جلسات بدون خرابی چیست؟
معیار جلسات بدون خرابی، درصد جلساتی است که در یک دوره زمانی انتخاب شده اتفاق افتاده و به خرابی ختم نشده‌اند. جلسات بدون خرابی، قابلیت اطمینان کلی یک برنامه را نشان می دهد و اعتماد کاربر را ایجاد می کند. ردیابی جلسات بدون خرابی به ویژه در مراحل اولیه نسخه جدید مهم است، زمانی که خرابی در اولین تعامل کاربر می‌تواند منجر به ناامیدی فوری تا حد رها شدن شود.
این معیار معمولاً معیار ترجیحی برای انواع برنامه‌های زیر است:
برنامه‌هایی با الگوهای استفاده کوتاه و شدید مانند بازی‌های بی‌درنگ یا برنامه‌های استریم حساس به زمان، که در آن خرابی در وسط یک لحظه بحرانی می‌تواند کاربر را ویران کند.
برنامه‌هایی با پیامدهای مهم مانند برنامه‌های مالی یا برنامه‌های ناوبری، که در آنها تأکید بر وضعیت نهایی تجربه است. خرابی یکی از این برنامه ها می تواند منجر به مشکلات قابل توجهی شود و در نتیجه اعتماد به برنامه از بین برود.
محاسبه معیارهای بدون خرابی
کاربران بدون خرابی چگونه محاسبه می شوند؟
مقدار کاربران بدون خرابی نشان‌دهنده درصد کاربرانی است که با برنامه شما درگیر بوده‌اند اما در یک بازه زمانی انتخابی خرابی نداشته‌اند .
در اینجا فرمول محاسبه درصد کاربران بدون خرابی وجود دارد. مقادیر ورودی آن توسط Crashlytics SDK ارائه می‌شود و بر اساس دوره زمانی است که شما از منوی کشویی در سمت راست بالای داشبورد Crashlytics انتخاب کرده‌اید.
CRASH_FREE_USERS_PERCENTAGE = 1 - ( CRASHED_USERS / ALL_USERS )
CRASHED_USERS تعداد کل کاربران منحصربه‌فردی را نشان می‌دهد که در بازه زمانی انتخاب‌شده دچار خرابی شده‌اند.
ALL_USERS تعداد کل کاربرانی را نشان می‌دهد که در بازه زمانی انتخابی با برنامه شما درگیر شده‌اند.
درصد کاربران بدون خرابی یک تجمع در طول زمان است، نه میانگین.
به عنوان مثال، تصور کنید برنامه شما سه کاربر دارد. ما آنها را User A، User B و User C می نامیم. جدول زیر نشان می دهد که چه کاربرانی هر روز با برنامه شما درگیر بوده اند و کدام یک از آن کاربران در آن روز خراب شده اند:
| دوشنبه | سه شنبه | چهارشنبه | |
|---|---|---|---|
| کاربرانی که با برنامه شما درگیر هستند | الف، ب، ج | الف، ب، ج | الف، ب |
| کاربری که دچار خرابی شده است | سی | ب | الف |
در روز چهارشنبه، درصد کاربران بدون خرابی شما 50٪ است (از هر 2 کاربر، 1 کاربر بدون خرابی بود).
دو نفر از کاربران شما روز چهارشنبه با برنامه شما درگیر شدند، اما تنها یکی از آنها (کاربر B) هیچ خرابی نداشت.در 2 روز گذشته، درصد کاربران بدون خرابی شما 33.3٪ است (از هر 3 کاربر، 1 کاربر بدون خرابی بود).
سه نفر از کاربران شما در دو روز گذشته با برنامه شما درگیر بودند، اما فقط یکی از آنها (کاربر C) هیچ خرابی نداشت.در 3 روز گذشته، درصد کاربران بدون خرابی شما 0٪ است (0 کاربر از 3 کاربر بدون خرابی بودند).
سه نفر از کاربران شما در سه روز گذشته با برنامه شما تعامل داشتند، اما هیچ کدام از آنها هیچ خرابی نداشتند.
ارزش کاربران بدون خرابی را نباید در دوره های زمانی مختلف مقایسه کرد. احتمال اینکه یک کاربر با دفعات بیشتری از برنامه شما استفاده کند، افزایش می‌یابد، بنابراین ارزش کاربران بدون خرابی احتمالاً برای دوره‌های زمانی طولانی‌تر کمتر خواهد بود.
جلسات بدون خرابی چگونه محاسبه می شود؟
مقدار جلسات بدون خرابی نشان دهنده درصد جلساتی است که در برنامه شما اتفاق افتاده است اما در یک دوره زمانی انتخابی خرابی نداشته است.
در اینجا فرمول محاسبه درصد جلسات بدون خرابی آمده است. مقادیر ورودی آن توسط Crashlytics SDK ارائه می‌شود و بر اساس دوره زمانی است که شما از منوی کشویی در سمت راست بالای داشبورد Crashlytics انتخاب کرده‌اید.
CRASH_FREE_SESSIONS_PERCENTAGE = 1 - ( CRASHED_SESSIONS / ALL_SESSIONS )
CRASHED_SESSIONS تعداد جلساتی را نشان می‌دهد که در بازه زمانی انتخاب شده به خرابی ختم شده‌اند.
ALL_SESSIONS تعداد کل جلساتی را نشان می دهد که در برنامه شما در بازه زمانی انتخاب شده اتفاق افتاده است.
درصد جلسات بدون خرابی یک تجمع در طول زمان است، نه میانگین.
تأثیر تنظیمات جمع آوری داده ها بر کیفیت معیارها
بسته به تنظیمات جمع‌آوری داده‌های شما، معیارهای بدون خرابی شما ممکن است مقادیر کم یا صفر را نشان دهند. در اینجا دو سناریو متداول وجود دارد که می‌تواند باعث ایجاد معیارهای غیرقابل اطمینان بدون خرابی شود:
اگر با غیرفعال کردن گزارش خودکار خرابی، گزارش انتخاب را فعال کنید ، اطلاعات خرابی را فقط می‌توان از کاربرانی که صریحاً در جمع‌آوری داده‌ها شرکت کرده‌اند به Crashlytics ارسال کرد. بنابراین، دقت معیارهای بدون خرابی تحت تأثیر قرار خواهد گرفت زیرا Crashlytics فقط اطلاعات خرابی را از این کاربران انتخاب شده (به جای همه کاربران شما) در اختیار دارد. این بدان معنی است که معیارهای بدون خرابی شما ممکن است کمتر قابل اعتماد باشد و کمتر منعکس کننده ثبات کلی برنامه شما باشد.
اگر جمع‌آوری خودکار داده‌ها را غیرفعال کرده‌اید، می‌توانید از
sendUnsentReportsبرای ارسال گزارش‌های حافظه پنهان روی دستگاه به Crashlytics استفاده کنید. استفاده از این روش، داده‌های خرابی را به Crashlytics ارسال می‌کند، اما نه داده‌های جلسات را که باعث می‌شود نمودارهای کنسول مقادیر کم یا صفر را برای معیارهای بدون خرابی نشان دهند.