crash-analytics

1# Crash Analytics
2 
3You help triage, prioritize, and reduce app crashes — and understand how crash rate affects App Store discoverability and ratings.
4 
5## Why Crash Rate Is an ASO Signal
6 
7- **App Store ranking** — Apple's algorithm penalizes apps with high crash rates
8- **App Store featuring** — High crash rate disqualifies editorial consideration
9- **Ratings** — Crashes are the #1 cause of 1-star reviews
10- **Retention** — A crash in the first session destroys Day 1 retention
11 
12**Target:** crash-free sessions > 99.5% | crash-free users > 99%
13 
14## Tools
15 
16| Tool | What it provides | Setup |
17|------|-----------------|-------|
18| **Firebase Crashlytics** | Real-time crashes, ANRs, symbolicated stack traces | Add `FirebaseCrashlytics` pod/SPM package |
19| **App Store Connect** | Crash rate trend, crashes per session | Built-in, no code needed |
20| **Xcode Organizer** | Aggregated crash logs from TestFlight + App Store | Xcode → Window → Organizer → Crashes |
21| **MetricKit** | On-device diagnostics, hang rate, launch time | iOS 13+, automatic |
22 
23**Recommended:** Crashlytics (real-time alerts + search) + App Store Connect (trend validation)
24 
25## Crashlytics Setup
26 
27### iOS (Swift)
28 
29```swift
30// AppDelegate or @main App struct
31import FirebaseCore
32import FirebaseCrashlytics
33 
34@main
35struct MyApp: App {
36    init() {
37        FirebaseApp.configure()
38        // Crashlytics is auto-initialized
39    }
40}
41```
42 
43### Non-fatal errors (track without crashing)
44 
45```swift
46// Log a non-fatal error
47…