Flutter数据分析与追踪插件Matomo的使用

Matomo 是一个用于数据分析和追踪的Dart客户端，完全用Dart编写，支持跨平台，包括Web。本文将介绍如何在Flutter应用中集成和使用Matomo。

开始使用

首先，在pubspec.yaml文件中添加Matomo依赖：

dependencies:
    matomo: ^1.1.0

然后，在应用启动时尽早配置Matomo Tracker，指定您的实例URL和站点ID。

初始化Tracker

await MatomoTracker().initialize(
  siteId: 'your_site_id',
  url: 'https://your-matomo-instance.com/piwik.php',
);

如果您需要使用自定义的访客ID，可以在初始化时传递：

await MatomoTracker().initialize(
  siteId: 'your_site_id',
  url: 'https://your-matomo-instance.com/piwik.php',
  visitorId: 'custom_visitor_id',
);

跟踪视图

为了跟踪视图，可以将StatelessWidget替换为TraceableStatelessWidget，将StatefulWidget替换为TraceableStatefulWidget，并将InheritedWidget替换为TraceableInheritedWidget。

您也可以直接调用trackScreen或trackScreenWithName来手动跟踪视图。

跟踪事件和目标

对于事件和目标的跟踪，分别调用trackEvent和trackGoal方法。例如：

MatomoTracker().trackEvent('eventName', 'eventAction', eventValue: 'eventValue');

用户退出选项

如果希望提供用户退出分析的选项，可以使用setOptOut()方法：

MatomoTracker().setOptOut(true);

示例代码

以下是一个完整的示例，演示了如何在Flutter应用中集成和使用Matomo进行数据追踪：

import 'package:flutter/material.dart';
import 'package:matomo/matomo.dart';
import 'package:logging/logging.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  MyApp() {
    Logger.root.level = Level.FINEST;
    Logger.root.onRecord.listen((LogRecord rec) {
      print('[${rec.time}][${rec.level.name}][${rec.loggerName}] ${rec.message}');
    });

    MatomoTracker().initialize(
      siteId: 1,
      url: 'https://analytics.example.com/piwik.php',
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Matomo Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(title: 'Matomo Example'),
    );
  }
}

class MyHomePage extends TraceableStatefulWidget {
  MyHomePage({Key key, this.title}) : super(key: key, name: title);

  final String title;

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

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() {
    MatomoTracker.trackEvent('IncrementCounter', 'Click');
    setState(() {
      _counter++;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              'You have pushed the button this many times:',
            ),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headline4,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: 'Increment',
        child: Icon(Icons.add),
      ),
    );
  }
}