开始使用 Google Analytics(分析)

本快速入门介绍如何将 Google Analytics(分析)添加到您的应用并开始记录事件。

Google Analytics(分析)会收集您的应用的使用情况和行为数据。SDK 会记录两种主要类型的信息:

  • 事件:您的应用中发生了什么,例如用户操作、系统事件或错误。
  • 用户属性:您为描述自己的各个细分用户群而定义的特性,例如语言首选项或地理位置。

Analytics 会自动记录某些事件用户属性;您无需为此添加任何代码。

准备工作

  1. 安装 firebase_core 并向您的应用添加初始化代码(如果您尚未执行这些操作)。
  2. Firebase 控制台中将您的应用添加到您的 Firebase 项目。

将 Analytics SDK 添加到您的应用

  1. 从 Flutter 项目的根目录运行以下命令,安装插件:

    flutter pub add firebase_analytics
    
  2. 完成后,重新构建您的 Flutter 应用:

    flutter run
    
  3. 安装后,将 firebase_analytics 插件导入到 Dart 代码中即可开始使用该插件:

    import 'package:firebase_analytics/firebase_analytics.dart';
    
  4. FirebaseAnalytics 上调用 instance getter 来创建一个新的 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'
  );

后续步骤