Flutter数据分析与跟踪插件flutuate_mixpanel的使用

flutuate_mixpanel

一个用于Flutter的分析与跟踪插件，支持Mixpanel服务。

获取开始

此插件封装了Mixpanel SDK的大部分功能，并且可以在Android和iOS上运行。
要使用它，您必须在Mixpanel官网注册一个令牌。

配置

在pubspec.yaml文件中添加flutuate_mixpanel依赖项到dependencies字段：

dependencies:
  flutuate_mixpanel: ^最新版本号

导入

在您的库中添加以下导入语句：

import 'package:flutuate_mixpanel/flutuate_mixpanel.dart';

使用

为了在您的Flutter应用中使用该插件，首先需要获取Mixpanel插件的一个实例：

MixpanelAPI instance = await MixpanelAPI.getInstance('<您的Mixpanel令牌>');

之后，您可以调用Mixpanel Android API文档中指定的方法。
更多详细信息请参阅Mixpanel文档。

示例

以下是一个完整的示例代码，展示了如何使用flutuate_mixpanel插件来实现事件跟踪、属性设置等常见操作。

示例代码

import 'package:flutter/material.dart';
import 'dart:async';
import 'package:flutuate_mixpanel/flutuate_mixpanel.dart';

/// 设置您的Mixpanel令牌
const YOUR_MIXPANEL_TOKEN = null;

void main(List<String> args) {
  String mixpanelToken = args.isNotEmpty ? args[0] : YOUR_MIXPANEL_TOKEN;

  print(mixpanelToken);
  runApp(MyApp(mixpanelToken));
}

class MyApp extends StatefulWidget {
  final String _mixpanelToken;

  MyApp(this._mixpanelToken);

  [@override](/user/override)
  _MyAppState createState() => _MyAppState(_mixpanelToken);
}

class _MyAppState extends State<MyApp> {
  MixpanelAPI _mixpanel;
  final String _mixpanelToken;
  String _resultMessage = '';

  _MyAppState(this._mixpanelToken);

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  Future<void> initPlatformState() async {
    if (!mounted) return;
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    List<Widget> content;
    if (_mixpanelToken == null || _mixpanelToken.isEmpty) {
      content = [Text('您的Mixpanel令牌未提供')];
    } else {
      content = createButtons(context);
    }
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Flutuate.io Mixpanel插件示例'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.start,
            children: <Widget>[
              Text(
                _resultMessage,
                key: Key('resultMessage'),
              ),
              Column(
                children: content,
              ),
            ],
          ),
        ),
      ),
    );
  }

  List<Widget> createButtons(BuildContext context) {
    return [
      buttonGetInstance(context),
      buttonTrackEvent(context),
      buttonRegisterSuperProperties(context),
      buttonGetDeviceInfo(context),
      buttonGetDistinctId(context),
      buttonReset(context),
      buttonFlush(context),
    ];
  }

  Widget buttonGetInstance(BuildContext context) => ElevatedButton(
        key: Key('getInstance'),
        child: Text('获取Mixpanel插件实例'),
        onPressed: () => getInstance(),
      );

  Widget buttonTrackEvent(BuildContext context) => ElevatedButton(
        key: Key('trackEvent'),
        child: Text('跟踪事件'),
        onPressed: () => trackEvent(),
      );

  Widget buttonRegisterSuperProperties(BuildContext context) => ElevatedButton(
        key: Key('registerSuperProperties'),
        child: Text('注册超级属性'),
        onPressed: () => registerSuperProperties(),
      );

  Widget buttonReset(BuildContext context) => ElevatedButton(
        key: Key('reset'),
        child: Text('重置'),
        onPressed: () => reset(),
      );

  Widget buttonGetDeviceInfo(BuildContext context) => ElevatedButton(
        key: Key('getDeviceInfo'),
        child: Text('获取设备信息'),
        onPressed: () => getDeviceInfo(),
      );

  Widget buttonGetDistinctId(BuildContext context) => ElevatedButton(
        key: Key('getDistinctId'),
        child: Text('获取唯一ID'),
        onPressed: () => getDistinctId(),
      );

  Widget buttonFlush(BuildContext context) => ElevatedButton(
        key: Key('flush'),
        child: Text('刷新数据'),
        onPressed: () => flush(),
      );

  void getInstance() {
    MixpanelAPI.getInstance(_mixpanelToken).then((mixpanel) {
      _mixpanel = mixpanel;
      setState(() {
        _resultMessage = '实例创建成功！';
      });
    });
  }

  void trackEvent() {
    var properties = {'按钮点击': '一个按钮被点击'};
    _mixpanel.track('Flutuate.io Mixpanel插件事件', properties);
    setState(() {
      _resultMessage = '事件发送成功！';
    });
  }

  void registerSuperProperties() {
    var properties = {'插件': 'flutuate_mixpanel'};
    _mixpanel.registerSuperProperties(properties);
    setState(() {
      _resultMessage = '超级属性注册成功！';
    });
  }

  void reset() {
    _mixpanel.reset();
  }

  void getDeviceInfo() async {
    var devInfo = await _mixpanel.getDeviceInfo();
    print(devInfo);
    setState(() {
      _resultMessage = devInfo.toString();
    });
  }

  void getDistinctId() async {
    var distinctId = await _mixpanel.getDistinctId();
    print(distinctId);
    setState(() {
      _resultMessage = distinctId;
    });
  }

  void flush() {
    _mixpanel.flush();
    setState(() {
      _resultMessage = '数据刷新成功！';
    });
  }
}