Інтеграція Bugsnag для відстеження помилок мобільного додатку

Інтеграція Bugsnag для відстеження помилок мобільного додатку

Bugsnag займає нішу між Crashlytics і Sentry: багате групування помилок без overhead performance-трейсингу. Ми використовуємо його в проєктах з 10k+ DAU — це скорочує час на triage у 3 рази. Основна сила — алгоритм error grouping, який інтелектуально групує краші за стектрейсом, не створюючи тисячу issue з однієї помилки з різними адресами пам'яті. Алгоритм використовує fuzzy matching — він кластеризує схожі stack trace, ігноруючи відмінності в адресах та часових мітках. Це особливо важливо для iOS, де ASLR змінює адреси при кожному запуску. У нас 8+ років досвіду в мобільній розробці, і ми гарантуємо стабільність після інтеграції. Економія на підтримці сягає 40% за рахунок скорочення ручного аналізу дублікатів.

Чому Bugsnag, а не Crashlytics?

Crashlytics безкоштовний, але його групування базове: дублікати доводиться розбирати вручну. Bugsnag групує в 3 рази точніше завдяки fuzzy matching. Він також підтримує вкладки метаданих — ми налаштовуємо їх так, щоб бачити стан додатку без логів. Наші клієнти економлять до 30% часу на налагодження після переходу з Crashlytics. Крім того, Bugsnag дозволяє задавати Severity на рівні події, що критично для triage: error-події надсилають алерт у PagerDuty, warning — у дайджест Slack. Така гнучкість недоступна в Crashlytics.

Як налаштувати метадані для швидкої діагностики?

Метадані структуруються по вкладках у кожному баг-репорті. Нижче приклад конфігурації для iOS — секція app_state з'являється окремою вкладкою, показуючи користувача, підписку та кошик.

Bugsnag.addOnSendError { event in
    event.addMetadata([
        "user_id": userId,
        "subscription": "premium",
        "cart_items": cartCount
    ], section: "app_state")
    event.setUser(userId, withEmail: email, andName: name)
    return true
}

Для Android конфігурація аналогічна — SDK ініціалізується автоматично при старті Application. Рекомендуємо додавати метадані на етапі addOnSendError, щоб не блокувати основний потік. Breadcrumbs автоматично логуються при кожній значущій дії користувача, що дає повну картину перед крашем.

Підключення на iOS

// Package.swift або SPM у Xcode
// https://github.com/bugsnag/bugsnag-cocoa

import Bugsnag

@main
struct MyApp: App {
    init() {
        let config = BugsnagConfiguration.loadConfig()
        config.apiKey = "YOUR_API_KEY"
        config.releaseStage = Bundle.main.infoDictionary?["ReleaseStage"] as? String ?? "production"
        config.notifyReleaseStages = ["staging", "production"]
        Bugsnag.start(with: config)
    }
}

notifyReleaseStages — один із перших параметрів, який варто налаштувати. Без нього debug-збірки засмічують дашборд подіями розробки. Також не забудьте завантажити dSYM-файли для символізації кражів — це робиться автоматично через скрипт у build phase.

Підключення на Android

implementation("com.bugsnag:bugsnag-android:5.+")

Ініціалізація з кастомною конфігурацією:

val config = Configuration.load(this).apply {
    releaseStage = BuildConfig.RELEASE_STAGE
    enabledReleaseStages = setOf("staging", "production")
    maxBreadcrumbs = 50
}
Bugsnag.start(this, config)

Для Android критично налаштувати ProGuard/R8 mapping file — інакше стектрейси будуть обфусковані. Ми підключаємо плагін bugsnag-android-gradle-plugin, який автоматично завантажує mapping при збірці.

Severity та управління пріоритетом

Severity впливає на сортування в дашборді та алерти. error — негайне сповіщення, warning — агрегування в дайджест. Ми налаштовуємо Severity для кожного типу помилок, щоб не пропустити критичні збої.

Bugsnag.notifyError(NetworkError.timeout) { event in
    event.severity = .warning
    event.context = "profile_image_load"
    return true
}

Як працює error grouping в деталях?

Bugsnag аналізує не лише точний стек, але й його структуру: кількість фреймів, імена функцій, типи винятків. Навіть якщо адреси різняться, алгоритм знаходить спільний патерн. Це дозволяє об'єднувати помилки, які в Crashlytics виглядали б як різні. На практиці ми спостерігаємо скорочення кількості відкритих issue у 2–3 рази після міграції. Для критичних помилок можна вимкнути групування через groupingHash.

Bugsnag vs Crashlytics: коли обрати Bugsnag

Порівняння часу налаштування: базова vs повна інтеграція

Що входить в роботу

• Підключення SDK (iOS SPM / Android Gradle / Flutter / React Native) — від $500
• Налаштування release stages та фільтрація dev-збірок
• Конфігурація метаданих через addOnSendError
• Налаштування breadcrumbs та кастомного контексту
• Інтеграція з Jira або Slack для алертів
• Upload dSYM (iOS) та ProGuard mapping (Android)

Замовте інтеграцію під ключ — ми оцінимо ваш проєкт всього за 1 день. Напишіть нам, і ми підготуємо пропозицію з фіксованою вартістю.

Джерело: офіційна документація Bugsnag, розділ Grouping. https://docs.bugsnag.com/platforms/ios/grouping/

Аналітика мобільних застосунків: 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 (Firebase) та Wikipedia (Amplitude).

Як вирішити проблему мультиканальної атрибуції з 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 успішних проектів у сфері мобільної розробки. Ми гарантуємо коректність даних і прозорість кожного етапу.

Зв'яжіться з нами, щоб отримати консультацію з налаштування аналітики вашого застосунку. Замовте аудит поточної аналітики — і ми покажемо, які метрики ви втрачаєте.