进阶指南

最近更新 2026/10/03

1. 初始化参数

初始化传入的 TDSettings 配置详细解释如下

1.1 TDSettings

属性名	类型	说明
appId	String	在 AE 后台创建的项目的 app id
serverUrl	String	在 AE 后台创建的项目的 server url
instanceName	String	给采集 SDK 实例设置别名
mode	TDMode	SDK 运行模式的枚举
enableLog	boolean	是否开启日志打印
defaultTimeZone	TimeZone	SDK 默认时区
encryptVersion	int	当开启数据加密时，密钥版本号
encryptKey	String	当开启数据加密时，公钥信息
enableAutoPush	boolean	是否开启推送点击自动回收
enableAutoCalibrated	boolean	是否开启自动时间校准

1.2 TDMode

枚举值	说明
NORMAL	正常上报数据，并入库。
DEBUG	以 Debug 模式上报采集数据。 设备 id 需添加到 AE 控制台的测试设备列表。 在 AE 控制台 -> Debug 模式菜单项可以看到实时采集到的数据。 上报数据 会 存储到 AE 系统。
DEBUG_ONLY	以 DebugOnly 模式上报采集数据。 设备 id 需添加到 AE 控制台的测试设备列表。 在 AE 控制台 -> Debug 模式菜单项可以看到实时采集到的数据。 上报数据 不会 存储到 AE 系统。

2. 设置客户端参数

创建客户端触发式任务时，可以填写「客户端条件」。配置方式参考：创建客户端触发式任务

「客户端条件」中可使用的参数来源于客户端自动采集的环境参数，以及您通过 TDRemoteConfig SDK 设置的客户端参数。在您使用 TDRemoteConfig SDK 提供的接口设置自定义的客户端参数后，您可以将自定义的客户端参数添加到 AE 运营设置的客户端参数管理模块中，并在运营任务中使用。

注意：您在客户端 SET 的参数的名字和类型需要和 AE 运营后台配置的客户端参数保持一致。

添加客户端参数

import cn.thinkingdata.remoteconfig.TDRemoteConfig;

// 设置客户端参数，多次设置会取并集
JSONObject json = new JSONObject();
json.put("key","value");
TDRemoteConfig.addClientParams(json);

删除客户端参数

TDRemoteConfig.removeClientParam("key");

获取客户端参数

//获取所有客户端参数
JSONObject params = TDRemoteConfig.getClientParams();

//获取单个客户端参数
Object obj = TDRemoteConfig.getClientParamValueForKey("key");

累加值类型的客户端参数

TDRemoteConfig.accumulateNum("key",1);

3. 自定义拉取时机

3.1 自动拉取

在以下场景，SDK 会自动拉取远端配置数据

• App 冷启动
• App 前后台切换，两次间隔超过6小时
• ThinkingSDK 账号系统发生了变更，例如 login、logout

3.2 手动拉取

手动调用 SDK 方法，随时拉取远端配置

TDStrategy.fetch();

该 API 内部有频控限制，请避免频繁拉取。

4. 触达漏斗事件

创建客户端触发式通道时，可以开启触达漏斗设置。配置方式参考：通道设置

开启触达漏斗后，您可以配置漏斗步骤关联的元事件名，这样在使用该通道的运营任务数据详情页可以查看已配置步骤的转化数据。

被选用为「实际到达」、「点击推送」的事件有如下要求：

• 事件需要携带运营特有的参数。该参数可以通过推送内容 TDStrategyResult 对象中的 opsProperties 属性来获取，具体上报方式如下：

TDStrategy.setTriggerListener(new TDStrategyResultListener() {
    @Override
    public void onTriggerResult(TDStrategyResult tdStrategyResult) {
        TDAnalytics.track("ops_click",tdStrategyResult.opsProperties);
    }
});

5. 发送测试

为了快速的验证通道的可用性，与任务的有效性，SDK 支持开启测试模式。

TDSettings settings = new TDSettings();
settings.appId = "AppId";
settings.serverUrl = "ServerUrl";
// debug 
settings.mode = TDSettings.TDMode.DEBUG;
TDApp.init(this,settings);

客户端开启 debug 模式后，会每 5s 拉取一次测试任务。在 AE 运营模块可以创建通道测试或者任务测试，任务等待触发的过程中，可以关注前端页面的进度节点。

参考操作文档：任务发送测试、通道发送测试

客户端触发式发送测试需要使用测试设备，您可在测试设备列表中选择或添加测试设备