integrationlatest接入文档 / 小程序&小游戏
小程序&小游戏
最新版本:v1.3.0
更新时间:2026-02-02
支持平台:微信小程序、微信小游戏、支付宝小程序、支付宝小游戏、抖音小程序、抖音小游戏、快手小程序、快手小游戏
1. 概述
从 AE 4.4 版本开始,运营模块上线了“客户端触发式任务”功能,支持端内新用户注册、创角等场景中的毫秒级触发需求,并支持实时 A/B 分流。客户端侧由数数 SDK 来实现与 AE 后端的通信,完成任务的拉取与计算。
在 小游戏 端需要集成数数 SDK。小游戏端只需要关注与数数 SDK 的交互即可,不需要关心 AE 后台的任务细节。
2. 集成
2.1 手动集成 SDK
客户端触发式需要依赖以下数数 SDK:
| SDK名称 | 介绍 | 版本要求 |
|---|---|---|
| TDAnalytics | 实现数据采集与处理 | >= 3.1.0 |
| TDRemoteconfig | 拉取 AE 后台的配置信息 | >= 1.0.0 |
| TDCore | 提供统一初始化能力 | >= 1.0.0 |
| TDStrategy | 提供客户端触发式能力 | >=1.0.0 |
- 点击页面上方资源下载链接,下载 SDK 并解压
- 小程序&小游戏 SDK 为常见小程序平台、小游戏平台的提供了一套标准的 API 接口。以微信平台的文件为示例:
小程序
- 微信小程序:tdcore.wx.min.js、tdanalytics.wx.min.js、tdremoteconfig.wx.min.js、tdstrategy.wx.min.js
小游戏
- 微信小游戏:tdcore.mg.wx.min.js、tdanalytics.mg.wx.min.js、tdremoteconfig.mg.wx.min.js、tdstrategy.mg.wx.min.js
- 将对应平台的文件拖入到项目同一目录下
3. 初始化
初始化 SDK
var TDApp = require("./tdcore.mg.wx.min.js");
var TDAnalytics = require("./tdanalytics.mg.wx.min.js");
var TDRemoteConfig = require("./tdremoteconfig.mg.wx.min.js");
var TDStrategy = require("./tdstrategy.mg.wx.min.js");
TDApp.init({
appId: "AppId",
serverUrl:"ServerUrl",
enableLog:true,
autoTrack: {
appLaunch: true, // 自动采集 ta_mg_launch
appShow: true, // 自动采集 ta_mg_show
appHide: true // 自动采集 ta_mg_hide
},
triggerListener:function(result){
}
});
4. 设置回调监听
初始化 SDK 的时候,给 TDStrategy SDK 设置一个回调监听。
//在初始化config中配置
triggerListener:function(result){
}
TDStrategy SDK 任务触发结果:
| 属性名 | 类型 | 说明 |
|---|---|---|
| channelMsgType | String | 通道消息类型 |
| appId | String | 您的 AE 项目的 app id |
| pushId | String | 运营任务的通道发送 ID |
| taskId | String | 运营任务的 ID |
| content | object | 运营任务的推送内容 |
| userParams | object | 客户端通道中的自定义参数 |
| opsProperties | object | 客户端触发任务携带的通道信息,用于触达漏斗事件的回执参数。 |
这篇文档对你有帮助吗?

