Flutter追踪分析插件wisetrack_sdk的使用

Flutter追踪分析插件wisetrack_sdk的使用

在本文中，我们将详细介绍如何在Flutter项目中集成和使用wisetrack_sdk插件。该插件主要用于追踪用户行为和事件，并提供丰富的回调功能来监控会话和事件的成功或失败情况。

环境配置与初始化

首先，确保您的Flutter环境已正确配置，并在pubspec.yaml文件中添加wisetrack_sdk依赖：

dependencies:
  wisetrack_sdk: ^版本号

运行以下命令以安装依赖：

flutter pub get

接下来，在应用启动时进行初始化。以下是完整的初始化代码示例：

import 'package:wisetrack_sdk/wisetrack.dart';
import 'package:wisetrack_sdk/wisetrack_config.dart';

void initPlatformState() async {
  // 初始化配置对象
  WiseTrackConfig config = new WiseTrackConfig(
    "your_app_token", // 替换为您的App Token
    WiseTrackEnvironment.sandbox, // 使用沙箱环境
  );

  // 设置其他参数（如默认跟踪器、包名等）
  config.defaultTracker = "your_default_tracker";
  config.packageName = "com.example.yourapp";
  config.storeName = "Your Store Name";

  // 设置回调函数
  config.attributionCallback = (WiseTrackAttribution attributionChangedData) {
    print('[WiseTrack]: Attribution changed!');
    print('[WiseTrack]: Tracker token: ${attributionChangedData.trackerToken}');
  };

  // 启动SDK
  WiseTrack.initSdk(config);
}

跟踪事件

wisetrack_sdk允许您通过WiseTrackEvent类记录自定义事件。以下是一个完整的事件跟踪示例：

import 'package:wisetrack_sdk/wisetrack_event.dart';
import 'package:wisetrack_sdk/wisetrack_currency.dart';

void trackCustomEvent() {
  // 创建事件对象
  WiseTrackEvent event = WiseTrackEvent("custom_event_token");

  // 设置事件名称
  event.setEventName("Purchase Completed");

  // 设置事件价格和货币类型
  event.setRevenue(100, WiseTrackCurrency.USD);

  // 跟踪事件
  WiseTrack.trackEvent(event);
}

处理生命周期事件

为了确保SDK正常工作，您需要监听应用的生命周期事件并在适当的时候调用相应的SDK方法。例如：

[@override](/user/override)
void didChangeAppLifecycleState(AppLifecycleState state) {
  switch (state) {
    case AppLifecycleState.resumed:
      WiseTrack.onResume();
      break;
    case AppLifecycleState.paused:
      WiseTrack.onPause();
      break;
    default:
      break;
  }
}

完整示例代码

以下是一个完整的Flutter应用示例，展示了如何配置和使用wisetrack_sdk插件：

import 'package:flutter/material.dart';
import 'package:wisetrack_sdk/wisetrack.dart';
import 'package:wisetrack_sdk/wisetrack_config.dart';
import 'package:wisetrack_sdk/wisetrack_event.dart';
import 'package:wisetrack_sdk/wisetrack_currency.dart';

void main() {
  runApp(MyApp());
}

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

class MyHomePage extends StatefulWidget {
  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final _formKey = GlobalKey<FormState>();
  final _eventTokenController = TextEditingController();
  final _eventNameController = TextEditingController();
  final _eventPriceController = TextEditingController();
  final _eventCurrencyController = TextEditingController();

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

  void initPlatformState() async {
    WiseTrackConfig config = new WiseTrackConfig(
      "your_app_token",
      WiseTrackEnvironment.sandbox,
    );
    config.defaultTracker = "your_default_tracker";
    config.packageName = "com.example.yourapp";
    config.storeName = "Your Store Name";

    config.attributionCallback = (WiseTrackAttribution attributionChangedData) {
      print('[WiseTrack]: Attribution changed!');
      print('[WiseTrack]: Tracker token: ${attributionChangedData.trackerToken}');
    };

    WiseTrack.initSdk(config);
  }

  void trackEvent() {
    if (_formKey.currentState!.validate()) {
      WiseTrackEvent event = WiseTrackEvent(_eventTokenController.text);
      event.setEventName(_eventNameController.text);
      event.setRevenue(
        int.parse(_eventPriceController.text),
        WiseTrackCurrency[_eventCurrencyController.text],
      );
      WiseTrack.trackEvent(event);
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Wisetrack Example'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Form(
          key: _formKey,
          child: Column(
            children: <Widget>[
              TextFormField(
                controller: _eventTokenController,
                decoration: InputDecoration(labelText: 'Event Token'),
                validator: (value) {
                  if (value == null || value.isEmpty) {
                    return 'Please enter event token';
                  }
                  return null;
                },
              ),
              TextFormField(
                controller: _eventNameController,
                decoration: InputDecoration(labelText: 'Event Name'),
                validator: (value) {
                  if (value == null || value.isEmpty) {
                    return 'Please enter event name';
                  }
                  return null;
                },
              ),
              TextFormField(
                controller: _eventPriceController,
                decoration: InputDecoration(labelText: 'Event Price'),
                keyboardType: TextInputType.number,
                validator: (value) {
                  if (value == null || value.isEmpty) {
                    return 'Please enter event price';
                  }
                  return null;
                },
              ),
              DropdownButton<String>(
                value: "USD",
                items: ["USD", "EUR", "JPY"]
                    .map((currency) => DropdownMenuItem(
                          value: currency,
                          child: Text(currency),
                        ))
                    .toList(),
                onChanged: (value) {
                  _eventCurrencyController.text = value!;
                },
              ),
              ElevatedButton(
                onPressed: trackEvent,
                child: Text('Track Event'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}