Flutter连接状态跟踪插件flutter_connecttracker的使用

开始使用移动应用跟踪 - Flutter

安装ConnecTracker SDK

将移动应用跟踪集成到您的应用中

import 'package:flutter_connecttracker/connecttracker.dart';
import 'package:flutter_connecttracker/connecttracker_options.dart';
...

var options = ConnectTrackerOptions("android_app_key", "ios_app_key");
final initialized =  await ConnectTracker.instance.init(options) ?? false;

使用更多选项进行初始化

import 'package:flutter_connecttracker/connecttracker.dart';
import 'package:flutter_connecttracker/connecttracker_options.dart';
...


var options = ConnectTrackerOptions("android_app_key", "ios_app_key");
// 禁用或启用广告ID跟踪（在两个平台上）
options.isAdIdTrackingDisabled = true;
// 请求iOS上的应用跟踪权限
options.requestAppTrackingPermission = true;
// 在两个平台上启用位置服务回调。
options.useLocation = true;
// 设置推送通知
options.usePushNotifications = true;
// 设置沙盒模式（适用于两个平台）
options.isSandbox = true;

final initialized =  await ConnectTracker.instance.init(options) ?? false;

运行应用在iOS模拟器或Android模拟器上，并检查app_open事件是否被发送到Connected Interactive仪表板。

深度链接方法

// 通知SDK该应用已通过深度链接打开
ConnectTracker.instance.appWillOpenUrl("schema://deeplink");

// 解析由电子邮件客户端生成的深度链接并将其传递给SDK
ConnectTracker.instance.resolveDeeplink("schema://deeplink", ["prefix1", "prefix2"]);

// 跟踪管理方法
// 关闭跟踪
ConnectTracker.instance.turnOffTracking();

// 打开跟踪
ConnectTracker.instance.turnOnTracking();

// 检查SDK是否已初始化
ConnectTracker.instance.isInitialized();

// 检查跟踪是否开启
ConnectTracker.instance.isTrackingOn();

// 从SDK中删除用户数据
ConnectTracker.instance.deleteUserData();

位置和服务权限方法

// 请求位置权限
ConnectTracker.instance.onWillRequestLocationPermission();

// 位置权限被拒绝
ConnectTracker.instance.onLocationPermissionDenied();

// 位置权限被授予
ConnectTracker.instance.onLocationPermissionGranted();

应用生命周期方法

// 应用程序处于暂停状态
ConnectTracker.instance.onApplicationPaused();

添加自定义事件

设置自定义事件跟踪

为了跟踪自定义事件，请在项目中添加以下代码：

ConnectTracker.instance.trackEvent("YOUR_EVENT_NAME", null)

如果要跟踪带有值的事件（例如货币价值），可以调用以下代码：

ConnectTracker.instance.trackEvent("YOUR_EVENT_NAME", "YOUR_VALUE")

为了启用事件回调，在调用ConnectTracker.instance.trackEvent之前设置ConnectTrackerOptions中的callbacks属性。

var options = ConnectTrackerOptions("android_app_key", "ios_app_key");
var callbacks = ConnectTrackerCallbacks();
options.callbacks = callbacks;

实现回调函数

callbacks.onSessionStartSuccess = (value) {
    // 处理值作为字典以获取会话开始详细信息
    print(value['trackingId']);
};
callbacks.onSessionStartFailed = (value) {
    // 处理值作为字典以获取会话开始详细信息
    print(value['trackingId']);
};

callbacks.onEventTracked = (value) {
    // 处理值作为字典以获取事件跟踪详细信息
    print(value['trackingId']);
};

callbacks.onEventTrackedFailed = (value) {
    // 处理值作为字典以获取事件跟踪失败详细信息
    print(value['trackingId']);
};

callbacks.onAppTrackingPermissionDenied = (value) {
    // value匹配iOS ATTrackingManagerAuthorizationStatusAuthorized常量（3）
    print(value);
};

callbacks.onAppTrackingPermissionDenied = (value) {
    // value匹配这些权限状态之一
    // ATTrackingManagerAuthorizationStatusNotDetermined(0), ATTrackingManagerAuthorizationStatusRestricted(1), ATTrackingManagerAuthorizationStatusDenied(3)
};

callbacks.onAttributionChanged = (value) {
    print(value['trackingId']);
};

示例代码

以下是完整的示例代码：

// example/lib/main.dart
import 'package:flutter/material.dart';

import 'package:flutter_connecttracker_example/first.dart';

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

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {  

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      routes: {
        '/': (context) {
          return const First(); 
        }
      }
    );
  }
}