Flutter

最近更新 2026/10/03

最新版本：v1.0.0

更新时间：2025-12-08

1. 概述

从 AE 4.4 版本开始，运营模块上线了“客户端触发式任务”功能，支持端内新用户注册、创角等场景中的毫秒级触发需求，并支持实时 A/B 分流。客户端侧由数数 SDK 来实现与 AE 后端的通信，完成任务的拉取与计算。

在 App 端需要集成数数 SDK。App 端只需要关注与数数 SDK 的交互即可，不需要关心 AE 后台的任务细节。

2. 集成

在您 Flutter 项目的 pubspec.yaml 文件中添加以下依赖：

dependencies:
  thinking_analytics: ^3.3.1
  td_remote_config: ^1.0.0
  td_strategy: ^1.0.0

客户端触发式任务需要依赖以下数数 SDK：

SDK 名称	功能介绍	版本要求
thinking_analytics	实现数据采集与处理	>= 3.3.1
td_remote_config	拉取 AE 后台的配置信息	>= 1.0.0
td_strategy	提供客户端触发式能力	>=1.0.0

3. 初始化

import 'package:thinking_analytics/td_analytics.dart';
import 'package:td_remote_config/remote_config.dart';
import 'package:td_strategy/strategy.dart';

TDAnalytics.init("appId", "serverUrl");

TDRemoteConfig.init("appId", "serverUrl");

//第一种
TDStrategy.init("appId", "serverUrl");
//第二种
TDStrategySettings strategySettings = TDStrategySettings();
strategySettings.appId = "appId";
strategySettings.serverUrl = "serverUrl";
TDStrategy.initWithConfig(strategySettings);

4. 设置回调监听

初始化 SDK 成功后，给 TDStrategy SDK 设置一个回调监听。

TDStrategy.setTriggerListener((tdStrategyResult) {

});

4.1 回调的数据模型

tdStrategyResult类型是Map<String, dynamic>，属性说明如下：

属性名	类型	说明
channelMsgType	String	通道消息类型
appId	String	您的 AE 项目的 app id
pushId	String	运营任务的通道发送 ID
taskId	String	运营任务的 ID
content	Map	运营任务的推送内容
userParams	Map	客户端通道中的自定义参数
opsProperties	Map	客户端触发任务携带的通道信息，用于触达漏斗事件的回执参数。