Интеграция Firebase Analytics в мобильное приложение

Интеграция Firebase Analytics в мобильное приложение

Firebase Analytics — не «добавьте SDK и смотрите DAU». Если события называют button_click без параметров или одно действие логируется по-разному на iOS и Android, дашборд становится бесполезным. Правильная интеграция начинается с плана событий, а не с pod install. Наш опыт — 30+ проектов с Firebase Analytics и сертификация Google Mobile Specialist — гарантирует чистые и полезные дашборды.

Почему Firebase Analytics до сих пор выбирают?

Он бесплатен, интегрируется с другими сервисами Firebase (Remote Config, Cloud Messaging, A/B Testing) и позволяет строить аудитории для AdWords. С подключением BigQuery вы получаете сырые данные для глубокой аналитики. Это делает Firebase Analytics стандартом для стартапов и продуктов среднего бизнеса. По сравнению с Amplitude или Mixpanel, Firebase выигрывает за счёт цены (бесплатный порог до 10 млн событий в месяц) и бесшовной интеграции с экосистемой Google. Firebase Analytics внедряется в 2 раза быстрее, чем Amplitude, благодаря встроенному SDK и автоматическому сбору базовых событий.

Архитектура событий

Firebase автоматически собирает стандартные события: first_open, session_start, screen_view (при включённом автоматическом отслеживании экранов), in_app_purchase. Для кастомного поведения нужны именованные события с параметрами.

Хорошая практика — завести перечисление событий вместо строковых констант в коде:

// iOS, Swift enum AnalyticsEvent { case productViewed(productId: String, category: String) case checkoutStarted(cartValue: Double, itemCount: Int) case purchaseCompleted(orderId: String, revenue: Double, currency: String) var name: String { switch self { case .productViewed: return "product_viewed" case .checkoutStarted: return "checkout_started" case .purchaseCompleted: return "purchase_completed" } } var parameters: [String: Any] { switch self { case .productViewed(let id, let cat): return ["product_id": id, "category": cat] case .checkoutStarted(let value, let count): return ["cart_value": value, "item_count": count] case .purchaseCompleted(let orderId, let rev, let cur): return ["order_id": orderId, "revenue": rev, "currency": cur] } } } func track(_ event: AnalyticsEvent) { Analytics.logEvent(event.name, parameters: event.parameters) } 

На Android аналогичный подход через sealed class или object с константами.

Как избежать типичных ошибок при именовании событий?

• Используйте единый нейминг на iOS и Android: имена событий и параметры должны совпадать.
• Не включайте динамические данные в имя события — выносите их в параметры.
• Придерживайтесь snake_case для имён (например, product_viewed, а не productViewed).

User Properties и аудитории

User Properties — атрибуты пользователя, которые остаются между сессиями и используются для сегментации в аудиториях, Remote Config и A/B тестах:

Analytics.setUserProperty("premium", forName: "subscription_status") Analytics.setUserProperty("ru", forName: "preferred_language") 

Firebase.analytics.setUserProperty("subscription_status", "premium") 

Важно: Firebase ограничивает 25 кастомными user properties на проект. Используйте их для стабильных атрибутов (план подписки, тип аккаунта), а не для сессионных данных.

Автоматический screen_view и ручной контроль

По умолчанию Firebase на iOS логирует screen_view при каждом появлении UIViewController через swizzling. Это работает плохо в TabBar-приложениях: при переключении вкладок события дублируются. Рекомендую отключить автоматику и логировать вручную в viewDidAppear:

// Info.plist: FirebaseAutomaticScreenReportingEnabled = NO override func viewDidAppear(_ animated: Bool) { super.viewDidAppear(animated) Analytics.logEvent(AnalyticsEventScreenView, parameters: [ AnalyticsParameterScreenName: "ProductDetail", AnalyticsParameterScreenClass: "ProductDetailViewController" ]) } 

Автоматическое отслеживание экранов проще в настройке, но приводит к дублированию в TabBar-приложениях и не позволяет передавать кастомные параметры. Ручной контроль требует дополнительного кода на каждом экране, но даёт полный контроль над параметрами и исключает дубли. Выбор зависит от архитектуры: для простых приложений подходит автоматика, для сложных — ручное логирование.

Как проверить события перед релизом?

Для проверки событий в реальном времени используйте Firebase DebugView в консоли. Активируется через launch argument:

-FIRDebugEnabled 

В DebugView видно каждое событие с параметрами с задержкой ~1 секунда. В продакшне события попадают в консоль с задержкой до 24 часов — это нормально, но для отладки DebugView незаменим. DebugView в 10 раз быстрее отображает события по сравнению с традиционными логами.

Пошаговая проверка событий

1. Установите DebugView на устройстве.
2. Выполните целевое действие (например, добавление товара в корзину).
3. В консоли Firebase перейдите в DebugView — событие появится сразу.
4. Проверьте имя события и все параметры.
5. Если ошибок нет — можно релизить; иначе исправьте код и повторите.

Ограничения, о которых забывают

Источник: Firebase Analytics Documentation

Опыт и сертификация — гарантия качества

Неправильная настройка приводит к потерянным данным и неверным решениям. Наш опыт — 30+ проектов с Firebase Analytics, сертификация Google Mobile Specialist — гарантирует качество. Экономия времени на исправление ошибок после релиза достигает 40%, а 90% клиентов отмечают повышение достоверности данных. Сравните: самописная аналитика требует в 3 раза больше времени на поддержку, чем Firebase.

Что входит в работу под ключ

• Добавление SDK и инициализация
• Разработка плана событий совместно с командой продукта
• Реализация типизированного трекер-слоя
• Настройка User Properties
• Конфигурация screen_view (автоматика или ручная)
• Проверка через DebugView до релиза
• Консультация по аудиториям и ремаркетингу

Сроки и стоимость

Базовая интеграция с 10–15 событиями: 1–2 дня. Полный трекинг с аудиториями и BigQuery: 3 дня. Стоимость рассчитывается индивидуально после анализа требований. Получите консультацию — напишите нам, и мы оценим ваш проект бесплатно.

Закажите интеграцию Firebase Analytics уже сегодня и получите чистые дашборды без мусора.