firebase-analytics

Firebase Analytics Skill

This skill defines how to correctly implement Firebase Analytics in Flutter applications, covering setup, event logging, user properties, and data collection best practices.

When to Use

Use this skill when:

• Setting up and configuring Firebase Analytics in a Flutter project.
• Logging predefined or custom analytics events.
• Setting user properties or default event parameters.
• Implementing screen view tracking with GoRouter or Navigator observers.
• Building conversion funnels or tracking user flows.

---

1. Setup and Configuration

flutter pub add firebase_analytics
flutter run

import 'package:firebase_analytics/firebase_analytics.dart';

// After Firebase.initializeApp():
FirebaseAnalytics analytics = FirebaseAnalytics.instance;

• Initialize Firebase before using any Firebase Analytics features.
• Analytics automatically logs some events and user properties — no additional code needed for those.
• On iOS, if your app does not use the IDFA (Advertising Identifier), use the IDFA-free Analytics dependency (FirebaseAnalyticsCore under Swift Package Manager, or FirebaseAnalytics/Core under CocoaPods) instead of the default FirebaseAnalytics dependency to avoid App Store review questions about advertising identifiers:
  • Swift Package Manager: set FIREBASE_ANALYTICS_WITHOUT_ADID=true when building (FIREBASE_ANALYTICS_WITHOUT_ADID=true flutter build ios).

Add Navigator Observer for Automatic Screen Tracking

MaterialApp(
  navigatorObservers: [
    FirebaseAnalyticsObserver(analytics: FirebaseAnalytics.instance),
  ],
);

For GoRouter, log screen views manually on route changes:

GoRouter(
  observers: [FirebaseAnalyticsObserver(analytics: FirebaseAnalytics.instance)],
);

Verification Checklist

1. Confirm Firebase.initializeApp() completes before accessing FirebaseAnalytics.instance.
2. Run the app and check the Firebase DebugView console for incoming events.
3. Confirm automatic events (first_open, session_start) appear without extra code.