SuperAPI AI 工具集

firebase-analytics

数据与分析

查看项目

更新于 10-15 23:40

技能介绍

用途:在 Flutter 项目中正确实现 Firebase Analytics,覆盖初始化、事件记录、用户属性与数据采集规范。

主要能力:配置 Firebase Analytics;记录预定义或自定义事件;设置用户属性与默认事件参数;通过 GoRouter 或 Navigator 观察者实现屏幕浏览追踪;构建转化漏斗与用户流程追踪。

使用方式:先执行 flutter pub add firebase_analytics 与 flutter run,并在 Firebase.initializeApp() 之后获取 FirebaseAnalytics.instance。自动事件与用户属性无需额外代码。屏幕追踪可在 MaterialApp 的 navigatorObservers 或 GoRouter 的 observers 中加入 FirebaseAnalyticsObserver。事件可用预定义方法(如 logSelectContent)或通用 logEvent(),自定义事件示例为 add_to_cart。默认参数用 setDefaultEventParameters(Web 不支持),用户属性用 setUserProperty,用户 ID 用 setUserId。开发期可用 DebugView 验证:Android 执行 adb shell setprop debug.firebase.analytics.app <package_name>,iOS 在 Xcode scheme 参数加 -FIRDebugEnabled。

限制与规范:事件名区分大小写,最多 500 种事件类型;事件名与参数名不超过 40 字符,须以字母开头,仅含字母数字与下划线;字符串参数值不超过 100 字符;firebase_、google_、ga_ 前缀保留;每事件最多 25 个自定义参数,每项目最多 25 个自定义用户属性;自定义参数与用户属性需在控制台注册后才能用于报告。iOS 若不使用 IDFA,可改用无 IDFA 依赖(Swift Package Manager 下 FirebaseAnalyticsCore,CocoaPods 下 FirebaseAnalytics/Core),构建时设置 FIREBASE_ANALYTICS_WITHOUT_ADID=true。不要记录敏感或可识别个人信息,采集前获取必要权限,自定义命名建议使用 snake_case。

适用场景:Flutter 应用的埋点、用户分群、漏斗分析与屏幕浏览统计。