跳到主要内容

进阶指南

最近更新 2026/10/03

1. 初始化参数​

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

1.1 TDSettings​

属性名类型说明
appIdString在 AE 后台创建的项目的 app id
serverUrlString在 AE 后台创建的项目的 server url
coreModeTDCoreModeSDK 运行模式的枚举
enableLogboolean是否开启日志打印
encryptVersionint当开启数据加密时，密钥版本号
encryptKeyString当开启数据加密时，公钥信息

1.2 TDCoreMode​

枚举值说明
NORMAL正常上报数据，并入库。

DEBUG

以 Debug 模式上报采集数据。

设备 id 需添加到 AE 控制台的测试设备列表。

在 AE 控制台 -> Debug 模式菜单项可以看到实时采集到的数据。

上报数据 会 存储到 AE 系统。

DEBUG_ONLY

以 DebugOnly 模式上报采集数据。

设备 id 需添加到 AE 控制台的测试设备列表。

在 AE 控制台 -> Debug 模式菜单项可以看到实时采集到的数据。

上报数据 不会 存储到 AE 系统。

2. 设置客户端参数​

创建客户端触发式任务时，可以填写「客户端条件」。配置方式参考：创建客户端触发式任务

「客户端条件」中可使用的参数来源于客户端自动采集的环境参数，以及您通过 TDStrategy SDK 设置的客户端参数。在您使用 TDStrategy SDK 开发的接口 SET 自定义的客户端参数后，您可以将自定义的客户端参数添加到 AE 运营设置的客户端参数管理模块中，并在运营任务中使用。

注意：您在客户端 SET 的参数的名字和类型需要和 AE 运营后台配置的客户端参数保持一致。

TDStrategy SDK 配置客户端参数的方式如下

using ThinkingData.Strategy;

// 设置客户端参数，多次设置会取并集
Dictionary<string, object> defaultValues = new Dictionary<string, object>
{
    { "key","value"}
};
TDStrategy.AddClientParams(defaultValues);

3. 自定义拉取时机​

3.1 自动拉取​

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

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

3.2 手动拉取​

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

TDStrategy.Fetch();

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

4. 触达漏斗事件​

创建客户端触发式通道时，可以开启触达漏斗设置。配置方式参考：通道设置

开启触达漏斗后，您可以配置漏斗步骤关联的元事件名，这样在使用该通道的运营任务数据详情页可以查看已配置步骤的转化数据。

被选用为「实际到达」、「点击推送」的事件有如下要求：

  • 事件需要携带运营特有的参数。该参数可以通过推送内容 TDStrategyResult 对象中的 opsProperties 属性来获取，具体上报方式如下：
using ThinkingData.Analytics;
using ThinkingData.Strategy;

public class ConcreteStrategyResultListener : TDStrategyResultListener {
    public void OnTriggerResult(TDStrategyResult result) {
         TDAnalytics.Track("ops_click", result.opsProperties);
    }
}

TDStrategy.SetTriggerListener(new ConcreteStrategyResultListener());

5. 发送测试​

为了快速的验证通道的可用性，与任务的有效性，SDK 支持开启测试模式。

using ThinkingData.Core;

TDSettings settings = new TDSettings();
settings.appId = "AppId";
settings.serverUrl = "ServerUrl";
// debug 
settings.mode = TDCoreMode.DEBUG;
TDApp.Init(settings);

客户端开启 debug 模式后，会每 5s 拉取一次测试任务。在 AE 运营模块可以创建通道测试或者任务测试，任务等待触发的过程中，可以关注前端页面的进度节点。

参考操作文档：任务发送测试、通道发送测试

客户端触发式发送测试需要使用测试设备，您可在测试设备列表中选择或添加测试设备

这篇文档对你有帮助吗？
本页内容