进阶指南

最近更新 2026/09/03

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 默认时区
enableBatch	Boolean	是否开启事件缓存批量上报
batchConfig	object	批量上报配置信息
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 会自动拉取远端配置数据

• 小游戏冷启动
• 小游戏 前后台切换，两次间隔超过6小时
• TDAnalytics SDK 账号系统发生了变更，例如 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");