Android

最近更新 2026/10/03

提示

Android SDK 要求最低系统版本为 Android 4.0（API 14）

最新版本：v1.4.1

更新时间：2026-05-12

资源下载：下载

1. 概述

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

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

2. 集成

2.1 自动集成 SDK

• 在 Project 级别的 build.gradle 文件中添加如下配置依赖

buildscript {
    repositories {
        jcenter()
        mavenCentral()
    }
}

• 在 module 工程目录下的 build.gradle文件中添加依赖项：

dependencies {
    implementation 'cn.thinkingdata.android:TDStrategy:1.4.1'
}

2.2 手动集成数数 SDK

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

SDK 名称	功能介绍	版本要求
TDAnalytics	实现数据采集与处理	>= 3.1.0
TDRemoteConfig	拉取 AE 后台的配置信息	>= 1.0.0
TDCore	提供基础组件能力	>= 1.1.0
TDStrategy	提供客户端触发式能力	>=1.0.0

1. 点击页面上方资源下载链接，下载 SDK 并解压
2. libs 文件夹中添加 TDAnalytics.aar、TDCore.aar、TDRemoteConfig.aar、TDStrategy.aar
3. 在 build.gradle 添加如下配置

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar','*.aar'])
}

3. 初始化

初始化 SDK

import cn.thinkingdata.core.TDApp;
import cn.thinkingdata.core.TDSettings;
// TDSettings 配置的详细使用方式请查看【进阶指南】
TDSettings settings = new TDSettings();
settings.appId = "AppId";
settings.serverUrl = "ServerUrl";
TDApp.init(this,settings);

4. 设置回调监听

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

import cn.thinkingdata.strategy.TDStrategy;
import cn.thinkingdata.strategy.core.result.TDStrategyResult;
import cn.thinkingdata.strategy.core.result.TDStrategyResultListener;

TDStrategy.setTriggerListener(new TDStrategyResultListener() {
    @Override
    public void onTriggerResult(TDStrategyResult tdStrategyResult) {
        
    }
});

4.1 回调的数据模型

public class TDStrategyResult {
    public String appId;
    public String taskId;
    public String channelMsgType;
    public String pushId;
    public JSONObject content;
    public JSONObject userParams;
    public JSONObject opsProperties;
}

属性说明

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