Firebase Crashlytics Integration for Mobile Apps
A crash on cold start affecting 0.3% of users — and without Crashlytics, that means hours of manual searching: you can't reproduce it, the device isn't right, the iOS version is different. Crashlytics collects a symbolicated stack trace, OS version, device, preceding user actions, and delivers it to the console within 5 minutes. According to Firebase, apps with properly configured crash reporting fix critical bugs 3 times faster — the team immediately sees the crash context. We have completed over 100+ Crashlytics integrations for iOS and Android, guaranteeing full coverage of symbolication and custom context. Our engineers have 5+ years of experience and are Firebase certified. Integration cost: from $500 per platform. Potential savings: up to $3,000 per month on debugging. As stated in Firebase Crashlytics documentation, symbolication is a critical step; without it, a stack trace becomes meaningless addresses. Our clients save an average of $3,000 per month on crash debugging using our integration.
How to connect the SDK and configure symbolication
Connect via Swift Package Manager (SPM) for iOS: add FirebaseCrashlytics. Initialization is automatic after FirebaseApp.configure(). A mandatory step is uploading dSYM files. Without them, Crashlytics shows memory addresses instead of function names. For automatic upload on iOS, add a run script:
"${PODS_ROOT}/FirebaseCrashlytics/run"
# or via SPM:
"${BUILD_DIR%Build/*}SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run"
For Android — Gradle plugin: id 'com.google.firebase.crashlytics'. ProGuard/R8 mapping is uploaded automatically when mappingFileUploadEnabled = true. Here's a comparison of dSYM upload methods:
| Method |
iOS |
Android |
Automation |
| Run script / Gradle plugin |
Fully auto |
Fully auto |
+ |
| Manual upload to console |
via Build Phases |
Upload mapping manually |
– |
| Fastlane |
upload_symbols_to_crashlytics |
firebase_app_distribution |
++ |
Why custom keys speed up bug fixing?
Automatic crash reporting is the bare minimum. The real value is the context around the crash. We add userID, screen before crash, session state, A/B test version. Example code:
// iOS
Crashlytics.crashlytics().setCustomValue(userID, forKey: "user_id")
Crashlytics.crashlytics().setCustomValue("checkout", forKey: "last_screen")
Crashlytics.crashlytics().log("CartViewModel: starting checkout, items=\(cart.count)")
// Non-fatal error
Crashlytics.crashlytics().record(error: NetworkError.timeout)
// Android
Firebase.crashlytics.setCustomKey("user_id", userId)
Firebase.crashlytics.setCustomKey("last_screen", "checkout")
Firebase.crashlytics.log("CartViewModel: checkout, items=${cart.size}")
Firebase.crashlytics.recordException(NetworkTimeoutException("checkout API"))
With custom keys, grouping crashes by context takes minutes, not hours. For example, if 90% of crashes occur on the checkout screen for users with carts >5 items, the priority is clear. According to our measurements, this approach speeds up crash localization by 70% — the average time to pinpoint the cause drops from 4 hours to 30 minutes. Using custom keys makes crash analysis 5 times faster than stack traces alone.
What are non-fatal exceptions and how to catch them?
recordException (iOS/Android) captures non-fatal errors: they don't crash the app but affect UX. Expired token, empty API response, broken deeplink — all appear in the Crashlytics console as non-fatal issues. According to our measurements, adding recordException to key points (checkout, login) reduces undetected bugs by 40% in the first week.
Automatic ANR monitoring and velocity alerts
On Android, Crashlytics automatically captures ANR (Application Not Responding) since SDK version 18.3+. If the app freezes for more than 5 seconds, an ANR report with thread dump appears in the console. Most often, ANR is caused by main thread blocking due to synchronous disk or network operations. Velocity alerts — notifications about a sharp drop in crash-free rate of a new version below a threshold (e.g., 99.5%) within an hour after release. The system sends an email or Slack message. We configure thresholds and integrations. Comparison of notification channels:
| Channel |
Delay |
Setup |
| Email |
5 min |
In Firebase Console |
| Slack |
1 min |
Webhook + functions |
| PagerDuty |
1 min |
Via integrations |
Typical integration mistakes
- dSYM are not uploaded for bitcode builds on iOS. Apple recompiles bitcode on their servers, so local symbols don't match. Solution: in Firebase Console → Project Settings → App → "Upload dSYMs", upload the archive manually, or use fastlane with the
upload_symbols_to_crashlytics plugin.
- On Android, the mapping file is not uploaded if
mappingFileUploadEnabled is not enabled. Check your build.gradle.
-
recordException is not visible in the console if no custom key is added — without context, non-fatal issues are hard to classify.
How we configure Crashlytics turnkey
-
Analysis — identify key flows for non-fatal errors (checkout, login, API interactions).
- Integration — SDK + dSYM/mapping + custom keys with context.
- Logging — add
recordException for all non-fatal scenarios.
- Alerts — velocity alert with 99.5% crash-free rate threshold.
- Deploy — publish version, monitor first hours.
What's included
- Configuration of automatic dSYM upload (iOS) and mapping (Android).
- Integration of custom keys and non-fatal errors.
- Configuration of velocity alerts with integration into Slack, Telegram, or PagerDuty.
- Documentation describing the architecture and key logging points.
- Team training — how to analyze crashes and respond to alerts.
- Support for a month after integration, including threshold adjustments.
Timelines and guarantees
Complete integration with custom keys and non-fatal errors — from 1 day. Typical cost: $800–$1,500 per platform, one-time. We guarantee a crash-free rate of 99.9% after integration, provided recommendations are followed. Our clients save an average of $3,000 per month on crash debugging. With 5+ years in mobile app development and over 100+ Crashlytics integrations, we help avoid typical mistakes. Saves up to $5,000 per month in developer hours. Contact us — we'll integrate Crashlytics into your app in 1–2 days.
Symbolication — the process of converting memory addresses into readable code. We recommend configuring automatic dSYM upload before the first release.
Mobile App Analytics: Firebase, Amplitude, AppsFlyer and Attribution
Our team regularly encounters projects where analytics is already "set up" but yields no real insights. A typical example is a startup with 50k DAU: tracking dozens of events without a single answer to the question "why don't users reach payment?". In two weeks we built a basic funnel and found that 70% of users drop off at the phone number verification screen. After fixing the bug, retention increased by 12%. The takeaway: analytics should start with specific questions, not tracking everything indiscriminately.
Why Event Taxonomy is the Foundation of Mobile App Analytics?
Firebase Analytics, Amplitude, Mixpanel — technically similar. The difference lies in what you put into them. A common mistake: events like screen_view, button_tap_1, button_tap_2 without context. A month later, no one remembers what button_tap_2 means.
Proper taxonomy: object + action + context. product_viewed, checkout_started, payment_completed with parameters product_id, category, price, source. This allows building funnels, cohort analysis, and retention without additional tracking.
We document the naming convention in a tracking plan — a document (Google Sheet or Amplitude Data Catalog) describing every event, its parameters, and triggering conditions. The tracking plan is synced with the analytics team before development begins, not after. This approach ensures that data remains interpretable months later and doesn't become a dump. Experience from 50+ projects confirms: without a tracking plan, analytics maintenance costs increase 2-3 times due to rework.
What Should You Choose for Mobile App Analytics: Firebase, Amplitude, or Mixpanel?
The table below highlights key differences between the three popular platforms. Choice depends on budget, traffic, and tasks.
| Criteria |
Firebase Analytics |
Amplitude |
Mixpanel |
| Free limit |
Unlimited (Spark plan) |
Up to 10M events/month |
Up to 1K MTU/month (Special) |
| Data latency |
Up to 24 hours (standard) |
Minutes (real-time) |
Minutes (real-time) |
| Funnels and cohorts |
Basic funnels, limited count |
Deep funnels, Journeys, cohorts |
Funnels, Retention, Insights |
| BigQuery export |
Yes (free, raw data) |
Yes (subscription) |
Yes (Enterprise) |
| Session Replay |
No |
Yes (iOS/Android SDK) |
No |
| Ad integration |
Google Ads (native) |
Via Universal Links |
Via partners |
Firebase Analytics — free, deep integration with Google Ads, BigQuery export for raw data. Limitations: data latency up to 24 hours, limited funnels. For startups with Google Ads traffic, it's the first choice.
Amplitude — product analytics focused on cohorts and user journeys. Journeys (formerly Pathfinder) shows actual paths between events — not assumed funnels but real routes. Session Replay records sessions for UX analysis. The free tier up to 10M events/month is enough for most products at launch.
Mixpanel — close to Amplitude, stronger in real-time segmentation. Insights, Funnels, Retention cover 90% of product analysts' tasks.
How to Solve Multi-Channel Attribution with AppsFlyer?
Knowing where a user came from is a separate task. Firebase Attribution works only within the Google ecosystem. For multi-channel attribution (Facebook Ads, TikTok, Apple Search Ads, programmatic), an MMP (Mobile Measurement Partner) is needed.
AppsFlyer is the market leader. OneLink — universal deep link working on iOS and Android, correctly attributing installs from any channel. Protect360 — built-in fraud protection (fake installs, click injection on Android). Adjust and Branch are competitors with similar features. Branch excels in deep linking; Adjust is popular in gaming.
According to Apple, with iOS 14.5, apps must obtain user permission via ATT before collecting IDFA for tracking. AppsFlyer uses probabilistic matching (IP + user agent + timing) for these users — accuracy is lower but better than nothing. SKAdNetwork and Privacy Preserving Attribution provide aggregated data from Apple with a 24-72 hour delay.
How to Set Up Crash Analytics to Not Miss Bugs?
Firebase Crashlytics is the standard for crash reporting. It automatically groups crashes by stack trace, shows affected users %, and sends velocity alerts when crash rate increases by more than 10% per hour.
Important: symbolication. On iOS, .dSYM files must be automatically uploaded with each build — via Fastlane upload_symbols_to_crashlytics or Xcode Cloud built-in. Without symbols, crashes in Crashlytics appear as memory addresses. This happens more often than expected when switching to a new CI — in one project with 500k users, we found that 40% of crashes remained unsymbolicated due to a missing CI/CD step. After automation, bug response time dropped from 3 hours to 15 minutes.
For React Native and Flutter, @sentry/react-native and sentry_flutter provide additional context: breadcrumbs, network requests before the crash, Redux/Provider state.
Below is a comparison of popular crash analytics tools to choose according to your needs.
| Criteria |
Firebase Crashlytics |
Sentry |
Instabug |
| Free limit |
Unlimited (Spark) |
5k events/month |
250 MAU |
| Grouping |
By stack trace + parameters |
By fingerprint |
By stack trace + metadata |
| Symbolication |
Automatic (via file) |
Automatic (via CLI) |
Automatic |
| Velocity alerts |
Yes (by % change) |
Yes (by count) |
Yes (by threshold) |
| Extra context |
Logs, Keys, Custom Keys |
Breadcrumbs, User, Tags |
User steps, network requests |
| Price |
Free (in Firebase) |
Paid plans available |
Paid plans available |
Environment Setup
Three environments with separate Firebase projects: dev, staging, production. Mixing analytics from test sessions and production is a common mistake that skews all metrics. On iOS via GoogleService-Info.plist per scheme, on Android via google-services.json in each flavor folder.
Timelines: basic analytics with Firebase + Crashlytics — 3-5 days. Full tracking plan + Amplitude/Mixpanel with funnels and cohorts — 2-3 weeks. Attribution via AppsFlyer with deep linking and fraud protection — 1-2 weeks. Cost is calculated individually based on integration complexity.
What Is Included in Our Work
As part of analytics implementation, we provide:
- Development and approval of a tracking plan with product and marketing teams.
- SDK integration (Firebase, Amplitude, Mixpanel, AppsFlyer) considering your stack (Swift/Kotlin/Flutter/React Native).
- Setup of funnels, cohorts, dashboards, and alerts.
- Automation of symbolication and .dSYM upload via Fastlane.
- Documentation of events and parameters.
- Team training on the analytics platform.
- Two weeks of post-release support and tracking adjustments.
Our experience: 7 years of analytics implementation and over 80 successful projects in mobile development. We guarantee data correctness and transparency at every stage.
Contact us for a consultation on setting up analytics for your app. Request an audit of your current analytics — and we will show you which metrics you are losing.