进阶指南

最近更新 2026/09/03

1. 初始化参数

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

属性名	类型	说明
APP ID	String	在 AE 后台创建的项目的 app id
Server Url	String	在 AE 后台创建的项目的 server url
mode	TDMode	SDK 运行模式的枚举
enableLog	boolean	是否开启日志打印

1.1TDMode

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

2. 自定义拉取时机

2.1 自动拉取

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

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

2.2 手动拉取

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

UTDRemoteConfig::Fetch();

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

3. 自定义 Fetch 参数

Fetch 参数为客户端 SDK 请求 AE 服务端取值时可用的参数，您可自定义 Fetch 参数，将参数添加为配置通道的环境参数，即可在配置策略时，使用 Fetch 参数自定义目标受众环境。

3.1 添加

UTDRemoteConfig::SetCustomFetchParams("{\"key1\":\"value1\"}");

3.2 删除

根据指定的 key 进行删除

UTDRemoteConfig::RemoveCustomFetchParam("key");