跳到主要内容

进阶指南

最近更新 2026/09/03

1. 初始化参数​

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

属性名类型说明
appIdString在 AE 后台创建的项目的 app id
serverUrlString在 AE 后台创建的项目的 server url
modeStringSDK 运行模式（none、debug、debugOnly）
enableLogBoolean是否开启日志打印
zoneOffsetNumberSDK 默认时区
autoTrackobject自动采集相关配置
triggerListenerfunction通知触发结果

2. 设置客户端参数​

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

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

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

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

// 设置客户端参数，多次设置会取并集
TDStrategy.addClientParams({
    "key":"value"
});

3. 自定义拉取时机​

3.1 自动拉取​

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

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

3.2 手动拉取​

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

TDStrategy.fetch();

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

4. 触达漏斗事件​

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

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

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

  • 事件需要携带运营特有的参数。该参数可以通过推送内容 TDStrategyResult 对象中的 opsProperties 属性来获取，具体上报方式如下：
TDApp.init({
   appId: "AppId",
   serverUrl:"ServerUrl",
   enableLog:true,
   triggerListener:function(result){
       TDAnalytics.track("ops_click", result.opsProperties);
   }
 });

5. 发送测试​

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

TDApp.init({
   appId: "AppId",
   serverUrl:"ServerUrl",
   enableLog:true,
   mode: "debug",//设置测试模式
   triggerListener:function(result){
       
   }
 });

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

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

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

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