进阶指南

最近更新 2026/09/03

1. 初始化参数

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

1.1 TDSettings

属性名	类型	说明
appId	String	在 AE 后台创建的项目的 app id
serverUrl	String	在 AE 后台创建的项目的 server url
coreMode	TDCoreMode	SDK 运行模式的枚举
enableLog	boolean	是否开启日志打印
encryptVersion	int	当开启数据加密时，密钥版本号
encryptKey	String	当开启数据加密时，公钥信息

1.2 TDCoreMode

枚举值	说明
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 添加

Dictionary<string, object> fetchParams = new Dictionary<string, object>
{
    { "key","value"}
};
TDRemoteConfig.SetCustomFetchParams(fetchParams);

3.2 删除

根据指定的 key 进行删除

TDRemoteConfig.RemoveCustomFetchParam("key");