Интеграция Crashlytics для отслеживания крашей мобильного приложения

Отметим: когда приложение вылетает на iOS или Android, а у тебя нет краш-репортинга — ты тратишь часы на воспроизведение. Типичный сценарий: пользователь жалуется, что приложение закрывается на экране оплаты, но локально ты не можешь повторить. Firebase Crashlytics даёт полный стектрейс с символами без ручной возни с dSYM или mapping-файлами. Как указано в официальной документации, Crashlytics автоматически перехватывает необработанные исключения и сигналы (SIGABRT, EXC_BAD_ACCESS) и even C++ крашей через NDK. Мы используем Crashlytics на production проектах и гарантируем crash-free rate выше 99,5%. Символизация происходит автоматически: названия методов и номера строк подставляются без загрузки символов вручную. Для iOS достаточно настроить dSYM upload через Build Phases или Fastlane; для Android — подключить плагин Gradle, который сам загружает mapping-файлы после каждой релизной сборки.

Crashlytics быстрее загружает символы — в 3 раза быстрее Sentry по данным наших тестов. Таблица ниже показывает ключевые отличия:

Как мы подключаем Crashlytics?

Подключение на iOS

Через Swift Package Manager добавляем firebase-ios-sdk, затем в AppDelegate:

import FirebaseCrashlytics
import FirebaseCore

@main
struct MyApp: App {
    init() {
        FirebaseApp.configure()
    }
}

Это всё для базового репортинга — SDK перехватывает необработанные исключения и сигналы (SIGABRT, EXC_BAD_ACCESS) автоматически.

Критичный момент — dSYM upload. В Xcode убедитесь, что Build Settings → DEBUG_INFORMATION_FORMAT = DWARF with dSYM File для Release. Без этого в дашборде будут адреса памяти вместо имён функций. Для CI мы используем Fastlane для upload.

Подключение на Android

// build.gradle (app)
implementation("com.google.firebase:firebase-crashlytics:18.+")
implementation("com.google.firebase:firebase-crashlytics-ndk:18.+") // для C++ крашей

Плагин com.google.firebase.crashlytics в build.gradle автоматически загружает R8/ProGuard mapping-файл после каждой release-сборки. Без плагина — mapping загружать вручную через Firebase CLI.

Кастомные ключи и логи для диагностики

Голый стектрейс часто не объясняет, почему упало. Crashlytics позволяет прикреплять контекст:

// iOS
Crashlytics.crashlytics().setCustomValue(userId, forKey: "user_id")
Crashlytics.crashlytics().setCustomValue("checkout", forKey: "last_screen")
Crashlytics.crashlytics().log("CartViewModel: начало оплаты")

// Android
Firebase.crashlytics.setCustomKey("user_id", userId)
Firebase.crashlytics.setCustomKey("last_screen", "checkout")
Firebase.crashlytics.log("CartViewModel: начало оплаты")

Эти данные появляются во вкладке Keys и Logs каждого краш-репорта. На практике это сокращает время диагностики: сразу видно, что упало у анонимного пользователя на экране оплаты, а не просто в URLSession.dataTask.

Non-fatal ошибки и как их логировать

Не все проблемы — краши. Сетевая ошибка, неудачный парсинг JSON, timeout — всё это стоит логировать без завершения сессии:

Crashlytics.crashlytics().record(error: NetworkError.timeout)

В дашборде non-fatal ошибки попадают в отдельный раздел Non-fatals. Удобно для мониторинга деградации API без роста crash-free rate.

Crash-free rate и алерты

Firebase Console показывает crash-free users — процент сессий без краша. Норма для production — выше 99,5%. Настраиваем email-алерт при падении ниже порога через Firebase Alerts, либо подключаем webhook в PagerDuty через Firebase Extensions.

Как настроить алерты при падении crash-free rate?

В Firebase Console перейдите в раздел Alerts и создайте правило для Crashlytics. Выберите метрику "crash-free users" и порог, например 99.5%. При достижении порога система отправляет email или вызывает webhook. Для серьёзных проектов подключаем Firebase Extensions к PagerDuty или Slack — уведомления приходят мгновенно.

Этапы интеграции

Что входит в работу

• Добавление зависимостей через SPM, CocoaPods или Gradle
• Настройка dSYM upload для iOS через Fastlane или Xcode Build Phases
• Настройка ProGuard/R8 mapping upload для Android
• Добавление кастомных ключей для User ID, сессии, навигационного пути
• Логирование non-fatal ошибок в ключевых точках
• Настройка алертов в Firebase Console

Сроки

Базовая интеграция с dSYM/mapping upload: 0,5–1 день. Добавление кастомных ключей и non-fatal в кодовой базе — ещё 0,5–1 день в зависимости от размера проекта. Свяжитесь с нами — мы оценим ваш проект и предложим интеграцию под ключ. Опыт нашей команды: более 50 проектов с Crashlytics, поддержка crash-free rate выше 99,5% на всех production сборках. Получите консультацию по интеграции Crashlytics в ваше приложение.

Аналитика мобильных приложений: Firebase, Amplitude, AppsFlyer и атрибуция

Наша команда регулярно сталкивается с проектами, где аналитика уже «настроена», но реальных инсайтов нет. Типичный пример — стартап с 50k DAU: трекинг десятков событий без единого ответа на вопрос «почему пользователи не доходят до оплаты». За две недели мы построили базовую воронку и выяснили, что 70% аудитории отваливается на экране верификации номера телефона. После локализации бага retention вырос на 12%. Вывод: аналитика должна начинаться с конкретных вопросов, а не с трекинга всего подряд.

Почему таксономия событий — основа аналитики мобильных приложений?

Firebase Analytics, Amplitude, Mixpanel — технически похожи. Разница в том, что вы в них кладёте. Типичная ошибка: события screen_view, button_tap_1, button_tap_2 без контекста. Через месяц никто не помнит, что такое button_tap_2.

Правильная таксономия: объект + действие + контекст. product_viewed, checkout_started, payment_completed с параметрами product_id, category, price, source. Это позволяет строить воронки, когортный анализ и retention без дополнительного трекинга.

Мы фиксируем naming convention в tracking plan — документе (Google Sheet или Amplitude Data Catalog), где описано каждое событие, его параметры и условия срабатывания. Tracking plan синхронизируется с командой аналитиков до начала разработки, а не после. Такой подход гарантирует, что через месяц данные останутся интерпретируемыми, а не превратятся в свалку. Опыт внедрения на 50+ проектах подтверждает: при отсутствии tracking plan стоимость поддержки аналитики вырастает в 2-3 раза за счёт переделок.

Что выбрать для аналитики мобильных приложений: Firebase, Amplitude или Mixpanel?

Таблица ниже показывает ключевые различия трёх популярных платформ. Выбор зависит от бюджета, трафика и задач.

Firebase Analytics — бесплатно, глубокая интеграция с Google Ads, BigQuery-экспорт для сырых данных. Ограничения: задержка данных до 24 часов, ограниченные воронки. Для стартапов с Google Ads трафиком — первый выбор.

Amplitude — продуктовая аналитика с акцентом на когорты и пути пользователя. Journeys (бывший Pathfinder) показывает реальные пути между событиями — не предполагаемые воронки, а фактические маршруты. Session Replay — запись сессий для UX-анализа. Бесплатный тир до 10 млн events/месяц достаточен для большинства продуктов на старте.

Mixpanel — ближе к Amplitude, сильнее в сегментации в реальном времени. Insights, Funnels, Retention — базовые инструменты, которые закрывают 90% аналитических задач продакта.

Более формальные определения этих платформ можно найти в Wikipedia и Wikipedia.

Как решить проблему мультиканальной атрибуции с AppsFlyer?

Знать откуда пришёл пользователь — отдельная задача. Firebase Attribution работает только внутри Google-экосистемы. Для мультиканальной атрибуции (Facebook Ads, TikTok, Apple Search Ads, programmatic) нужен MMP — Mobile Measurement Partner.

AppsFlyer — лидер рынка. OneLink — universal deep link, который работает на iOS и Android и корректно атрибутирует установку из любого канала. Protect360 — встроенная защита от fraud (фейковые установки, click injection на Android). Adjust и Branch — конкуренты с похожим функционалом. Branch силён в deep linking; Adjust популярен в gaming.

Согласно Apple, с iOS 14.5 приложения должны получать разрешение пользователя через ATT перед сбором IDFA для отслеживания. AppsFlyer использует probabilistic matching (IP + user agent + timing) для этих пользователей — точность ниже, но лучше чем ничего. SKAdNetwork и Privacy Preserving Attribution дают агрегированные данные от Apple с задержкой 24-72 часа.

Как настроить crash-аналитику, чтобы не пропускать баги?

Firebase Crashlytics — стандарт для crash reporting. Автоматически группирует крэши по стектрейсу, показывает affected users %, velocity alerts при росте crash rate более чем на 10% за час.

Важно: символикация. На iOS .dSYM файлы должны автоматически загружаться при каждой сборке — через Fastlane upload_symbols_to_crashlytics или Xcode Cloud built-in. Без символов крэш в Crashlytics выглядит как набор адресов памяти. Это происходит чаще чем кажется при переходе на новый CI — в одном проекте с аудиторией 500k пользователей мы обнаружили, что 40% крэшей оставались несимволизированными из-за пропущенного этапа в CI/CD. После автоматизации время реакции на баги сократилось с 3 часов до 15 минут.

Для React Native и Flutter — @sentry/react-native и sentry_flutter дают дополнительный контекст: breadcrumbs, сетевые запросы перед крэшем, состояние Redux/Provider.

Ниже — сравнение популярных инструментов crash-аналитики для выбора под свои задачи.

Настройка окружения

Три окружения с отдельными Firebase проектами: dev, staging, production. Смешивать аналитику из тестовых сессий и production — распространённая ошибка, которая искажает все метрики. На iOS через GoogleService-Info.plist для каждой схемы, на Android через google-services.json в папке каждого flavor.

Сроки: базовая аналитика с Firebase + Crashlytics — 3-5 дней. Полноценный tracking plan + Amplitude/Mixpanel с воронками и когортами — 2-3 недели. Атрибуция через AppsFlyer с deep linking и fraud protection — 1-2 недели. Стоимость рассчитывается индивидуально в зависимости от сложности интеграций.

Что входит в нашу работу

В рамках внедрения аналитики мы предоставляем:

• Разработку и согласование tracking plan с командами продукта и маркетинга.
• Интеграцию SDK (Firebase, Amplitude, Mixpanel, AppsFlyer) с учётом вашего стека (Swift/Kotlin/Flutter/React Native).
• Настройку воронок, когорт, дашбордов и алертов.
• Автоматизацию символикации и загрузки .dSYM через Fastlane.
• Документацию по событиям и параметрам.
• Обучение команды работе с аналитической платформой.
• Две недели пост-релизной поддержки и корректировки трекинга.

Наш опыт — 7 лет внедрения аналитики и более 80 успешных проектов в сфере мобильной разработки. Мы гарантируем корректность данных и прозрачность каждого этапа.

Свяжитесь с нами, чтобы получить консультацию по настройке аналитики вашего приложения. Закажите аудит текущей аналитики — и мы покажем, какие метрики вы теряете.