本快速入门介绍如何将 Google Analytics 添加到您的应用并开始记录事件。
Google Analytics 会收集您的应用的使用情况和行为数据。SDK 会记录两种主要类型的信息:
- 事件:您的应用中发生了什么,例如用户操作、系统事件或错误。
- 用户属性:您为描述自己的各个细分用户群而定义的特性,例如语言首选项或地理位置。
Analytics 会自动记录某些事件和用户属性;您无需为此添加任何代码。
准备工作
- 安装
firebase_core
并向您的应用添加初始化代码(如果您尚未执行这些操作)。 - 在 Firebase 控制台中将您的应用添加到您的 Firebase 项目。
将 Analytics SDK 添加到您的应用
从 Flutter 项目的根目录运行以下命令,安装插件:
flutter pub add firebase_analytics
完成后,重新构建您的 Flutter 应用:
flutter run
安装后,将
firebase_analytics
插件导入到 Dart 代码中即可开始使用该插件:import 'package:firebase_analytics/firebase_analytics.dart';
通过在
FirebaseAnalytics
上访问instance
属性来创建新的 Firebase Analytics 实例:FirebaseAnalytics analytics = FirebaseAnalytics.instance;
开始记录事件
创建 FirebaseAnalytics
实例后,您就可以开始使用库中的 log
- 方法记录事件了。
某些事件推荐用于所有应用;其他事件则推荐用于特定业务类型或行业。您应该同时发送推荐事件及预设参数,以确保报告能够提供最详细的信息,并让您在未来功能和集成方案推出时马上就能受益。本部分展示了如何记录预定义的事件;如需详细了解如何记录事件,请参阅记录事件。
以下代码会记录 Checkout 事件:
await FirebaseAnalytics.instance
.logBeginCheckout(
value: 10.0,
currency: 'USD',
items: [
AnalyticsEventItem(
itemName: 'Socks',
itemId: 'xjw73ndnw',
price: '10.0'
),
],
coupon: '10PERCENTOFF'
);
后续步骤
- 使用 DebugView 验证事件。
- 在 Firebase 控制台中浏览数据。
- 浏览事件和用户属性的相关指南。
- 了解如何将数据导出到 BigQuery。