Flutter电容聚合追踪插件aggregatori_capaci_sdk_tracking的使用

开始使用

环境配置

• flutter: “>=3.0.0”
• sdk: ‘>=3.1.3 <4.0.0’

在 pubspec.yaml 文件中添加依赖：

dependencies:
  aggregatori_capaci_sdk_tracking: 0.0.1

初始化插件

首先确保在 main() 函数中初始化插件：

void main() async {
  WidgetsFlutterBinding.ensureInitialized(); // 确保Flutter绑定已初始化
  await AppTracking.instance.init('https://cardoctor-api-dev.aggregatoricapaci.com/'); // 初始化插件并传入基础URL
  runApp(const MyApp()); // 运行应用
}

跟踪登录事件

当用户成功登录后，可以调用 trackLogin 方法来跟踪登录事件：

AppTracking.instance.trackLogin('YOUR_USER_ID', ePassId: 'YOUR_EPASS_ID');

跟踪动态事件

可以通过传递一个包含事件信息的 Map 来跟踪动态事件：

var content = {
  'key1': 'value1',
  'key2': 'value2',
  'userId': 'your_user_id',
};

AppTracking.instance.trackEvent('your_event_name', content: content);

跟踪屏幕观察者

可以在 MaterialApp 中添加 navigatorObservers 来跟踪屏幕变化：

import 'package:aggregatori_capaci_sdk_tracking/aggregatori_capaci_sdk_tracking.dart';

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
      navigatorObservers: [CarDoctorObserver()], // 添加观察者
    );
  }
}

完整示例代码

以下是一个完整的示例代码，展示了如何使用该插件：

import 'package:aggregatori_capaci_sdk_tracking/aggregatori_capaci_sdk_tracking.dart';
import 'package:flutter/material.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await AppTracking.instance.init('https://cardoctor-api-dev.aggregatoricapaci.com/'); // 初始化插件并传入基础URL
  runApp(const MyApp());
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
      navigatorObservers: [CarDoctorObserver()], // 添加观察者
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

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

class _MyHomePageState extends State<MyHomePage> {

  [@override](/user/override)
  void initState() {
    // 在初始化状态时跟踪登录事件
    AppTracking.instance.trackLogin('userId');
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Builder(builder: (context) {
        return Center(
          child: GestureDetector(
            onTap: () async {
              AppTracking.instance.trackButtonClick('open'); // 跟踪按钮点击事件
              AppTracking.instance.trackScroll('home', 0.7); // 跟踪滚动事件
            },
            child: const Icon(Icons.add),
          ),
        );
      }),
    );
  }
}