# AnalyticsService Example Complete example of a generated `AnalyticsService` class. This is based on `Find_Doctor.md` and `Packages.md` measurement plans but demonstrates the **generic pattern** applicable to any project. --- ```dart import 'package:firebase_analytics/firebase_analytics.dart'; /// Centralized analytics service for Firebase Analytics tracking. /// All event tracking throughout the app must go through this class. /// /// Usage: /// AnalyticsService.setUserId(userId); // on login /// AnalyticsService.clearUserId(); // on logout /// AnalyticsService.logViewDoctorList(...); // custom event class AnalyticsService { AnalyticsService._(); // prevent instantiation static final FirebaseAnalytics _analytics = FirebaseAnalytics.instance; // ───────────────────────────────────────────── // USER IDENTITY // ───────────────────────────────────────────── /// Set the Firebase Analytics user ID. /// Call this after a successful login or registration. /// [userId] — unique identifier from your backend (e.g., user ID, phone number). static Future setUserId(String? userId) async { await _analytics.setUserId(id: userId); } /// Clear the Firebase Analytics user ID. /// Call this when the user logs out. static Future clearUserId() async { await _analytics.setUserId(id: null); } // ───────────────────────────────────────────── // FIND DOCTOR — Find Doctor Screen // ───────────────────────────────────────────── /// When the doctor list card appears 100% in visitor's screen. /// Trigger: VisibilityDetector (visibleFraction == 1.0) /// Screen: Find Doctor Screen static Future logViewDoctorList({ required String doctorId, required String contentCategory, String contentSection = 'Find a Doctor', String screenName = 'Find Doctor Screen', }) async { await _analytics.logEvent( name: 'view_doctor_list', parameters: { 'doctor_id': doctorId, 'content_category': _truncate(contentCategory), 'content_section': contentSection, 'screen_name': screenName, }, ); } /// When user clicks Make Appointment button from doctor list card. /// Trigger: onPressed /// Screen: Find Doctor Screen static Future logMakeAnAppointment({ required String doctorId, required String contentCategory, String contentSection = 'Find a Doctor', String screenName = 'Find Doctor Screen', }) async { await _analytics.logEvent( name: 'make_an_appointment', parameters: { 'doctor_id': doctorId, 'content_category': _truncate(contentCategory), 'content_section': contentSection, 'screen_name': screenName, }, ); } /// When user clicks Teleconsultation button from doctor list card. /// Trigger: onPressed /// Screen: Find Doctor Screen static Future logSelectDoctorTeleconsultation({ required String doctorId, required String contentCategory, String contentSection = 'Find a Doctor', String screenName = 'Find Doctor Screen', }) async { await _analytics.logEvent( name: 'select_doctor_teleconsultation', parameters: { 'doctor_id': doctorId, 'content_category': _truncate(contentCategory), 'content_section': contentSection, 'screen_name': screenName, }, ); } // ───────────────────────────────────────────── // PACKAGES — Health Packages Screen // ───────────────────────────────────────────── /// When user arrives on Health Packages screen. /// Trigger: initState / addPostFrameCallback /// Screen: Health Packages Screen static Future logViewItemList({ required List items, String? itemListId, String? itemListName, }) async { await _analytics.logViewItemList( itemListId: itemListId, itemListName: itemListName, items: items, ); } /// When user clicks on a package card. /// Trigger: onTap /// Screen: Health Packages Screen static Future logSelectItem({ required List items, String? itemListId, String? itemListName, }) async { await _analytics.logSelectItem( itemListId: itemListId, itemListName: itemListName, items: items, ); } /// When user arrives on Package Detail screen. /// Trigger: initState / addPostFrameCallback /// Screen: Package Detail Screen static Future logViewItem({ required List items, String currency = 'IDR', double? value, }) async { await _analytics.logViewItem( currency: currency, value: value, items: items, ); } // ───────────────────────────────────────────── // HELPERS // ───────────────────────────────────────────── /// Build an [AnalyticsEventItem] from common e-commerce product fields. static AnalyticsEventItem buildItem({ required String itemId, required String itemName, String? itemCategory, String? itemVariant, String itemBrand = 'RS Bunda', double? price, int quantity = 1, }) { return AnalyticsEventItem( itemId: itemId, itemName: itemName, itemCategory: itemCategory, itemVariant: itemVariant, itemBrand: itemBrand, price: price, quantity: quantity, ); } /// Truncate string to Firebase's 100-character parameter limit. static String _truncate(String value, {int maxLength = 100}) { return value.length > maxLength ? value.substring(0, maxLength) : value; } } ```

firebase-analytics-tracker

Install this skill

Comments