进阶指南

最近更新 2026/10/02

1. 初始化参数

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

1.1 TDSettings

属性名	类型	说明
appId	String	在 AE 后台创建的项目的 app id
serverUrl	String	在 AE 后台创建的项目的 server url
mode	String	SDK 运行模式（none、debug、debugOnly）
enableLog	Boolean	是否开启日志打印
zoneOffset	Number	SDK 默认时区
autoTrack	object	自动采集相关配置

1.2 SDK 运行模式

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

2. 自定义拉取时机

2.1 自动拉取

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

• 冷启动
• ThinkingSDK 账号系统发生了变更，例如 login、logout

2.2 手动拉取

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

TDRemoteConfig.fetch();

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

3. 自定义 Fetch 参数

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

3.1 添加

TDRemoteConfig.setCustomFetchParams({});

3.2 删除

根据指定的 key 进行删除

TDRemoteConfig.removeCustomFetchParam("key");