Flutter数据分析管理插件analytics_manager的使用

在项目开发过程中，经常会遇到需要同时集成多个数据分析工具的情况，比如Firebase、Amplitude、OneSignal等。analytics_manager 插件旨在为这些需求提供一个简单的解决方案。

为什么选择这个插件？

它可以帮助你在一个项目中轻松管理多个分析工具。通过统一的接口来处理不同分析工具的操作，使代码更加简洁和易于维护。

开始使用

创建 AnalyticsHandler

首先，你需要创建一个继承自 AnalyticsHandler 的类。这个类包含了所有需要实现的方法，例如初始化、用户属性设置、事件记录等。

class DummyAnalyticsHandler extends AnalyticsHandler {  

  [@override](/user/override)
  Future<void> deleteAccount() {
    // 实现删除账户逻辑
  }

  [@override](/user/override)
  Future<void> handleEvent(AnalyticsEvent event) {
    // 实现处理事件逻辑
  }

  [@override](/user/override)
  Future<void> initialize() {
    // 实现初始化逻辑
  }

  [@override](/user/override)
  Future<void> logOutUser() {
    // 实现登出用户逻辑
  }

  [@override](/user/override)
  Future<void> setUserEmail(String userEmail) {
    // 实现设置用户邮箱逻辑
  }

  [@override](/user/override)
  Future<void> setUserId(String userId) {
    // 实现设置用户ID逻辑
  }

  [@override](/user/override)
  Future<void> setUserProperty(String name, value) {
    // 实现设置用户属性逻辑
  }
}

初始化 AnalyticsHandler

在应用启动时，初始化 AnalyticsHandler：

await AnalyticsManager.initialize(handlers: [DummyAnalyticsHandler()]);

创建自定义事件

你可以创建自定义事件类来封装特定的事件数据。例如，创建一个记录添加到购物车事件的类：

class AddToCartEvent extends AnalyticsEvent {  
  final String productName;  
  
  AddToCartEvent(this.productName)  
      : super(  
          name: 'add_to_cart',  
          parameters: {  
            'product_name': productName,  
          },  
        );  
}

在Widget中发送事件和用户属性

在你的应用中，可以在需要的时候发送事件或设置用户属性：

AnalyticsManager.instance.logEvent(AddToCartEvent('My awesome product'));
AnalyticsManager.instance.setUserProperty('first_name', 'Bob');

完整示例

下面是一个完整的示例代码，展示了如何使用 analytics_manager 插件。

import 'package:analytics_manager/analytics_manager.dart';
import 'package:example/analytics/analytics_events.dart';
import 'package:flutter/material.dart';

import 'dummy_firebase_analytics_handler.dart';

void main() async {
  // 初始化 AnalyticsManager
  await AnalyticsManager.initialize(
    loggingEnabled: true,
    handlers: [
      DummyFirebaseAnalyticsHandler(),
    ],
  );
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key});

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  void _logSomeThings() {
    // 记录事件和设置用户属性
    AnalyticsManager.instance.logEvent(SignupEvent());
    AnalyticsManager.instance.logEvent(LoginEvent());
    AnalyticsManager.instance.logEvent(LogoutEvent());
    AnalyticsManager.instance.logEvent(AddToCartEvent('Bande dessinnée'));
    AnalyticsManager.instance.setUserId('john_doe');
    AnalyticsManager.instance.setUserEmail('john@doe.com');
    AnalyticsManager.instance.setUserProperty('age', 25);
    AnalyticsManager.instance.logOutUser();
    AnalyticsManager.instance.deleteAccount();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
      ),
      body: const Center(child: Text('Hello')),
      floatingActionButton: FloatingActionButton(
        onPressed: _logSomeThings,
        child: const Icon(Icons.send),
      ), // 这个尾随逗号使自动格式化更美观
    );
  }
}