For each of your apps, Crashlytics automatically calculates and displays crash-free metrics, specifically the percentage of crash-free users and the percentage of crash-free sessions . These metrics can help you quickly understand the stability of your app.
You can find charts of these crash-free metrics at the top of the Crashlytics dashboard , and you can filter these charts by a variety of dimensions, like time range, build, and (for Android apps) by Google Play track.
توجه داشته باشید که معیارهای بدون خرابی فقط برای رویدادهای مهلک (و استثنائات ناشناخته که به عنوان رویدادهای مهلک برای Unity و Flutter گزارش شده‌اند) محاسبه می‌شوند.
معیارهای بدون خرابی را دریافت کنید
For most apps, crash-free metrics are automatically calculated when you integrate the Crashlytics SDK in your app. However, there are certain situations where Crashlytics doesn't receive the necessary data to calculate crash-free metrics:
نسخه‌های قدیمی برنامه شما که از نسخه قدیمی Crashlytics SDK استفاده می‌کنند (در زیر با حداقل نسخه‌های پشتیبانی‌شده آشنا شوید)
نسخه‌هایی از برنامه شما که جمع‌آوری و گزارش‌دهی خودکار داده‌های Crashlytics را غیرفعال می‌کنند (برای اطلاعات بیشتر به بخش «تأثیر تنظیمات جمع‌آوری داده‌ها بر کیفیت معیارها» در این صفحه مراجعه کنید)
نسخه‌های SDK که از معیارهای بدون خرابی پشتیبانی می‌کنند
To get crash-free metrics, you must update your app to use a Crashlytics SDK version that supports them. The following are the minimum supported versions of the Crashlytics SDK that can power crash-free metrics:
- پلتفرم‌های اپل: نسخه ۱۰.۸.۰+
- اندروید: نسخه ۱۸.۶.۰+ ( BoM نسخه ۳۲.۶.۰+)
- فلاتر: نسخه ۳.۴.۵+
- یونیتی: ۱۱.۷.۰+
شما باید به طور خودکار معیارهای بدون خرابی را برای نسخه‌های ساخته شده برنامه خود که از نسخه SDK به‌روز شده استفاده می‌کنند، دریافت کنید.
معیارهای بدون خرابی چیست؟
معیارهای بدون خرابی شامل کاربران بدون خرابی و جلسات بدون خرابی می‌شود.
Crash-free metrics depend on two concepts: users and sessions. To get crash-free metrics for your app, you need to use a Crashlytics SDK version that can send data about both of these concepts. Here's how Crashlytics differentiates a user from a session:
A user is an individual installation of your app on a device. For example, if a person has your app installed on several different devices, then Crashlytics will count each installation as a different and unique user.
A session is a continuous period of time when a user is engaged with an application. A new session starts when the app is cold-started or the app is foregrounded after at least 30 minutes of backgrounding.
همچنین، معیارهای بدون خرابی فقط برای رویدادهای مهلک (و استثنائات گزارش نشده به عنوان رویدادهای مهلک برای Unity و Flutter) محاسبه می‌شوند.
معیار کاربران بدون خرابی چیست؟
The crash-free users metric is the percentage of users who engaged with your app during a selected time period but did not have a crash. This metric reflects the experience that your app delivers to a single user. It's frequently tracked as the key health metric for the entire app, when the goal is the overall user experience.
این معیار می‌تواند به‌طور خاص برای انواع برنامه‌های زیر قابل استفاده باشد:
Apps with long and casual sessions such as on-demand streaming apps, social media apps, or casual games, where the user can continue where they left off. Because users typically engage with these apps in longer, often multi-session experiences, maximizing the total number of crash-free users takes precedence over ensuring each individual session is flawless.
برنامه‌هایی با پایگاه‌های کاربری تثبیت‌شده مانند برنامه‌های کاری جاافتاده یا پلتفرم‌های آنلاین در مقیاس بزرگ، که در آنها عادت و نیاز به این پلتفرم‌ها بر ناراحتی ناشی از خرابی غلبه می‌کند.
معیار جلسات بدون خرابی چیست؟
معیار جلسات بدون خرابی، درصد جلساتی است که در یک دوره زمانی انتخاب شده اتفاق افتاده و به خرابی ختم نشده است. جلسات بدون خرابی، نشان‌دهنده قابلیت اطمینان کلی یک برنامه است و اعتماد کاربر را افزایش می‌دهد. ردیابی جلسات بدون خرابی به ویژه در مراحل اولیه انتشار یک نسخه جدید مهم است، زمانی که خرابی در اولین تعامل کاربر می‌تواند منجر به ناامیدی فوری تا حد رها کردن شود.
این معیار اغلب معیار ترجیحی برای انواع برنامه‌های زیر است:
برنامه‌هایی با الگوهای استفاده کوتاه و شدید مانند بازی‌های بلادرنگ یا برنامه‌های پخش جریانی حساس به زمان، که در آنها خرابی در میانه یک لحظه بحرانی می‌تواند کاربر را به شدت آسیب برساند.
Apps with significant consequences such as financial apps or navigational apps, where the emphasis is on the end state of the experience. A crash in one of these apps can lead to significant problems, resulting in loss of trust in the app.
محاسبه معیارهای بدون تصادف
کاربران بدون خرابی چگونه محاسبه می‌شوند؟
مقدار کاربران بدون خرابی، درصد کاربرانی را نشان می‌دهد که با برنامه شما تعامل داشته‌اند اما در یک دوره زمانی انتخاب شده، خرابی نداشته‌اند .
Here is the formula for calculating the crash-free users percentage. Its input values are provided by the Crashlytics SDK, and they're based on the time period that you've selected from the drop-down menu in the upper-right of the Crashlytics dashboard.
CRASH_FREE_USERS_PERCENTAGE = 1 - ( CRASHED_USERS / ALL_USERS )
CRASHED_USERS تعداد کل کاربران منحصر به فردی را نشان می‌دهد که در بازه زمانی انتخاب شده دچار خرابی شده‌اند.
ALL_USERS تعداد کل کاربرانی را نشان می‌دهد که در بازه زمانی انتخاب شده با برنامه شما تعامل داشته‌اند.
درصد کاربران بدون خرابی، حاصل جمع کل زمان است، نه میانگین.
For example, imagine your app has three users; we'll call them User A, User B, and User C. The following table shows which users engaged with your app each day and which of those users had a crash that day:
| دوشنبه | سه‌شنبه | چهارشنبه | |
|---|---|---|---|
| کاربرانی که با اپلیکیشن شما تعامل داشته‌اند | الف، ب، ج | الف، ب، ج | الف، ب |
| کاربری که دچار خرابی شده است | سی | ب | الف |
روز چهارشنبه، درصد کاربران بدون خرابی شما ۵۰٪ است (از هر ۲ کاربر، ۱ نفر بدون خرابی بوده است).
دو نفر از کاربران شما روز چهارشنبه با برنامه شما تعامل داشتند، اما فقط یکی از آنها (کاربر B) هیچ مشکلی نداشت.در دو روز گذشته، درصد کاربران بدون خرابی شما ۳۳.۳٪ است (از هر ۳ کاربر، ۱ نفر بدون خرابی بوده است).
سه نفر از کاربران شما در دو روز گذشته با برنامه شما تعامل داشته‌اند، اما فقط یکی از آنها (کاربر C) هیچ مشکلی نداشته است.در ۳ روز گذشته، درصد کاربران بدون خرابی شما ۰٪ است (۰ از ۳ کاربر بدون خرابی بوده‌اند).
سه نفر از کاربران شما در سه روز گذشته با اپلیکیشن شما تعامل داشته‌اند، اما هیچ‌کدام از آنها دچار خرابی (کرش) نشده‌اند.
The crash-free users value shouldn't be compared over different time periods. The probability of a single user experiencing a crash grows the more times they use your app, so the crash-free users value is likely to be smaller for longer time periods.
دوره‌های بدون خرابی چگونه محاسبه می‌شوند؟
مقدار جلسات بدون خرابی، درصد جلساتی را نشان می‌دهد که در یک دوره زمانی انتخاب شده در برنامه شما اتفاق افتاده اما خرابی نداشته‌اند .
Here is the formula for calculating the crash-free sessions percentage. Its input values are provided by the Crashlytics SDK, and they're based on the time period that you've selected from the drop-down menu in the upper-right of the Crashlytics dashboard.
CRASH_FREE_SESSIONS_PERCENTAGE = 1 - ( CRASHED_SESSIONS / ALL_SESSIONS )
CRASHED_SESSIONS تعداد جلساتی را نشان می‌دهد که در دوره زمانی انتخاب شده به خرابی منجر شده‌اند.
ALL_SESSIONS تعداد کل جلساتی را نشان می‌دهد که در دوره زمانی انتخاب شده در برنامه شما رخ داده است.
درصد جلسات بدون خرابی، یک میانگین نیست، بلکه یک مجموع در طول زمان است.
تأثیر تنظیمات جمع‌آوری داده‌ها بر کیفیت معیارها
بسته به تنظیمات جمع‌آوری داده‌های شما، معیارهای بدون خرابی شما ممکن است مقادیر کم یا صفر را نشان دهند. در اینجا دو سناریوی رایج وجود دارد که می‌توانند باعث ایجاد معیارهای بدون خرابی غیرقابل اعتماد شوند:
اگر با غیرفعال کردن گزارش خودکار خرابی، گزارش‌دهی اختیاری را فعال کنید ، اطلاعات خرابی فقط از کاربرانی که صریحاً در جمع‌آوری داده‌ها مشارکت داشته‌اند، می‌تواند به Crashlytics ارسال شود. بنابراین، دقت معیارهای بدون خرابی تحت تأثیر قرار خواهد گرفت زیرا Crashlytics فقط اطلاعات خرابی این کاربران انتخابی (و نه همه کاربران شما) را دارد. این بدان معناست که معیارهای بدون خرابی شما ممکن است کمتر قابل اعتماد باشند و کمتر نشان‌دهنده پایداری کلی برنامه شما باشند.
اگر جمع‌آوری خودکار داده‌ها را غیرفعال کرده‌اید، می‌توانید از
sendUnsentReportsبرای ارسال گزارش‌های ذخیره‌شده روی دستگاه به Crashlytics استفاده کنید. استفاده از این روش، داده‌های خرابی را به Crashlytics ارسال می‌کند، اما داده‌های جلسات را نه، که باعث می‌شود نمودارهای کنسول مقادیر کم یا صفر را برای معیارهای بدون خرابی نشان دهند.