进阶指南

最近更新 2026/10/03

1. 初始化参数

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

1.1 TDSettings

属性名	类型	说明
appId	String	在 AE 后台创建的项目的 app id
serverUrl	String	在 AE 后台创建的项目的 server url
mode	TDMode	SDK 运行模式的枚举
enableLog	boolean	是否开启日志打印
rccFetchParams	JSONObject	（TDRemoteConfig 使用）拉取配置时的自定义请求参数
encryptVersion	int	（ThinkingSDK 使用）当开启数据加密时，密钥版本号
encryptKey	String	（ThinkingSDK 使用）当开启数据加密时，公钥信息
defaultTimeZone	TimeZone	（ThinkingSDK 使用）SDK 格式化时间所用到的时区
instanceName	String	（ThinkingSDK 使用）给采集 SDK 实例设置别名
enableAutoPush	boolean	（ThinkingSDK 使用）是否开启推送点击自动回收
enableAutoCalibrated	boolean	（ThinkingSDK 使用）是否开启自动时间校准

1.2 TDSettings.TDMode

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

2. 自定义拉取时机

2.1 自动拉取

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

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

2.2 手动拉取

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

TDRemoteConfig.fetch();

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

3. 自定义 Fetch 参数

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

3.1 添加

TDRemoteConfig.setCustomFetchParams(new JSONObject());

3.2 删除

根据指定的 key 进行删除

TDRemoteConfig.removeCustomFetchParam("key");