跳到主要内容

进阶指南

最近更新 2026/10/03

1. 初始化参数​

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

属性名类型说明
appIdString在 AE 后台创建的项目的 app id
serverUrlString在 AE 后台创建的项目的 server url
enableLogBoolean是否开启日志打印
debugModeString传 debug 时开启测试模式。仅 Android / iOS / HarmonyOS 原生通道生效
triggerListenerfunction通知触发结果

数据采集相关配置（如 autoTrack、enableNative）请在 TDAnalytics.init 中设置。必须先初始化 TDAnalytics，再初始化 TDStrategy。

2. 设置客户端参数​

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

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

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

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

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

// 删除指定客户端参数
TDStrategy.removeClientParam('key');

3. 触达漏斗事件​

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

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

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

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

4. 发送测试​

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

TDStrategy.init({
  appId: 'AppId',
  serverUrl: 'ServerUrl',
  enableLog: true,
  debugMode: 'debug', // 设置测试模式
  triggerListener: function (result) {

  }
});

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

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

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

5. 自定义 Fetch 参数​

Fetch 参数为客户端 SDK 请求 AE 服务端取值时可用的参数，您可自定义 Fetch 参数，将参数添加为配置通道的环境参数。

5.1 添加​

TDStrategy.setCustomFetchParams({
  demo_param: 'from_client'
});

// 主动拉取最新任务配置（可选）
TDStrategy.fetch();

5.2 删除​

根据指定的 key 进行删除

TDStrategy.removeCustomFetchParam('demo_param');
这篇文档对你有帮助吗？
本页内容