跳到主要内容

创建触发式任务(客户端)

最近更新 2026/10/03

1. 功能简介​

在服务端触发式运营任务中，受限于数据上报服务端的时效性，难以覆盖弱联网游戏中需要秒级触发响应的相关场景。因此，从 4.4 版本开始，搭载数数 SDK 的能力，运营模块上线了“客户端触发式任务”，支持端内新用户注册、创角等场景中的毫秒级触发需求，并支持实时 A/B 分流。

另一方面运营模块直接通过客户端 SDK 和 App 进行通信，无需额外开发 webhook 服务通道链路即可进行相关运营任务参数的下发。

  • 数据流转的路径
查看原图

2. 典型场景​

场景场景说明触发规则

新用户 - 新手引导A/B实验

针对新用户，进行不同的新手引导流程的A/B实验，最后确定效果最佳的新手引导流程策略同步全量用户启动生成游戏的用户标识ID，启动应用成功（加载完成游戏程序）或者创建角色、注册账号等，立即下发新手引导流程分组策略

对局中或结束后的资源礼包投放

针对棋牌类存在“代币”破产的游戏，在对局中或结算后出现破产后立即推送该“代币”资源礼包对局资源变化：对局中一般是判断道具变化值（某次道具扣除超过当前存量道具），结算则一般是判断变化后的值（<=0或不足以参加本类比赛的门票)
针对数值养成类游戏，在玩家关卡（每）连续失败后的关卡结算页面立即推送养成所需资源礼包每连续失败后基于不同养成线的情况推送不同的资源礼包（如果同时满足多个养成线资源礼包则会有优先级的逻辑）

弱联网产品

一些弱联网的产品，客户端配置需要重新发包，可以走客户端SDK进行热更发布（启动时或重新登录时主动拉取）

较通用的场景如弹窗、资源位、跑马灯等。

启动应用时或其他客户端行为事件

3. 接入流程​

查看原图
  • 确认接入场景：您可规划期望使用客户端触发式解决的业务场景，如礼包、新手A/B实验等。确认场景后，可联系 ThinkingAI 客户经理辅助后续内容的接入。
  • 接入SDK：详见客户端触发式技术接入文档，支持iOS/Android/小游戏平台。
  • 创建&测试客户端通道：打开AE运营模块，进入运营设置 > 通道设置 > 客户端通道页面，创建客户端通道，详见客户端通道设置。
  • 创建任务：通道接入完成后，进入运营任务创建页面。即可根据业务需求，自定义触发规则及推送内容。
提示

使用客户端触发式任务需集成数数SDK，部分触发处理能力需满足最小SDK版本号，使用前请确认您当前集成的SDK类型和版本。详见本章 第6节 SDK版本支持能力说明。

4. 创建客户端触发式任务​

入口：运营 > 运营任务 > 创建任务 > 选择触达方式 > 选择客户端触达 > 选择通道 后进入到运营任务编辑页面。

4.1 推送时机​

客户端触发式任务目前支持【触发-完成A】和【触发-完成A后未完成B】的推送类型，并支持「每完成」、「每连续完成」和「每依次完成」三种触发统计模式。

在用户完成指定 行为事件 或 行为序列 后立即进行推送触达。如当玩家等级到达 50 级触发 50 级限时礼包。

提示

客户端触发规则仅支持客户端采集事件的触发计算，且不支持被标识为可更新事件、首次事件的计算。

4.1.1 【触发 - 完成A】 — 每完成​

「每完成」：指用户在任务周期内 每累计完成某行为 则触发一次推送

举例：用户每完成两次充值事件，就推送一份折扣券

  • 支持在选定的起止时间内，按天/周/月或周期内统计每累计完成某行为后进行推送触达
  • 支持单事件多次的触发规则，支持行为事件属性筛选
  • 支持 自定义 每日/每周/每月 的起止时间，如 5:00->次日 5:00 为一日、每周三 5:00->下周三 5:00 为一周
  • 若您设置触发条件为每完成 条件1 或 条件2 。支持设置其中任一条件触发时，其他条件的计算窗口是否关闭。

4.1.2 【触发 - 完成A】— 每连续完成​

「每连续完成」：指用户在任务周期内 每连续完成多次 某事件，且期间未做过另一事件（支持通过「添加未做过事件」设置），则触发一次推送。

举例：给2小时内，每连续两次升级失败且中间未充值过的用户推送礼包

  • 支持在选定的起止时间内，按天/周/月或周期内统计每连续完成指定事件多次后进行推送触达
  • 支持单事件多次的触发规则，支持行为事件属性筛选
  • 支持添加关联属性，时间窗口 和 未做过事件
  • 支持 自定义 每日/每周/每月 的起止时间，如 5:00->次日 5:00 为一日、每周三 5:00->下周三 5:00 为一周

4.1.3 【触发 - 完成A】 — 每依次完成​

「每依次完成」：每按顺序完成指定行为序列，则触发一次推送。

举例：给2小时内，按顺序 依次完成 "登录-抽卡-付费" 的用户推送礼包

  • 支持在选定的起止时间内，按天/周/月或周期内统计依次完成指定行为序列后进行推送触达
  • 支持多种事件触发规则，支持行为事件属性筛选
  • 支持 自定义 每日/每周/每月 的起止时间，如 5:00->次日 5:00 为一日、每周三 5:00->下周三 5:00 为一周

4.1.4 【触发 - 完成A后未完成B】​

在用户完成指定行为A，并在一段时间内未完成行为B后进行推送触达。

如当玩家获取某个限时礼包（完成A），且在0.5小时内未完成购买（未完成B），则触发站内消息提醒礼包即将过期。

提示

用户每完成一次A条件，即为其开启一个独立的观察期，以判断是否在期内完成B条件。一旦用户在任一观察期内完成了B条件，则触发一次推送，且其余所有观察期立即终止。

4.2 推送控制​

4.2.1 频率控制​

支持通过 频率控制 对用户在一段时间内最多收到推送的次数进行限制。支持选择：

  • 单次启动内，用户最多可接收的推送次数（单次启动指从打开应用到退出/杀掉应用，离开应用界面进入后台依旧在单次启动内)
  • 任务周期内，用户最多可接收的推送次数（如任务周期内仅1次）
  • X天/周内，用户最多可接收的推送次数（滑动窗口，如7天内仅支持1次，即最近7*24小时内仅支持一次）
  • 每X天 / 周 /月 内，用户最多可接收的推送次数（滚动窗口，如每周内1次，即每个自然周内仅支持一次）

比如，游戏内活动是按周更新，触发规则是玩家每周完成参与玩法次数超过 30次后就推送一次相关道具。但是同时我们也希望该玩家每周内仅收到 1 次推送，则可以在起止时间中选择“每周”累计完成，频率控制中设置每周内单用户最多接受1次推送即可。您也可以自定义周起始日。

提示

客户端触发式任务由客户端 SDK 执行计算，仅支持计算客户端采集的事件。若您的用户在多设备登陆，将在每个终端设备独立计算触发和频控。

4.3 目标用户​

您可以自定义目标人群或选择面向全部满足触发条件的用户推送。

4.3.1 自定义人群​

用户行为触发后，您需要判断其是否属于目标用户群，并对满足目标用户条件的人群进行推送。根据时效性不同，分为实时计算的目标用户群，或小时级更新的目标用户群。

实时计算目标用户群

  • 触发后，实时计算是否属于目标用户

  • 以下条件支持实时计算：

    • 目标用户条件中仅使用了支持实时计算的用户属性和分群
    • 支持实时计算的用户属性：定义中不包含用户标签、实时不可用的维度表的属性
    • 支持实时计算的用户分群：分群大小不超出规定限制的分群（默认200w用户）

  • 若目标用户条件使用了支持实时计算的用户分群，您可以点击「修改规则」修改该分群的更新计算频率（默认每12小时更新）

定时计算目标用户群

  • 「定时计算」是指按指定的计算频率定时更新计算目标用户群。行为触发后，根据最近一次计算的结果判断用户是否属于该目标用户群。
  • 当目标用户群条件涉及事件、标签、不支持实时计算的维度表、超过规定限制的分群时，仅支持定时计算。
  • 您可以点击「修改规则」修改目标用户群的更新频率（默认每12小时更新）

分群更新占用一定的计算资源，请结合业务场景选择适当的更新频率，避免不必要的计算资源开销。

4.3.2 全部用户​

满足触发条件后，不再对用户进行精细化筛选，只要满足触发条件即执行推送。

4.3.3 进行人数预估​

设置人群圈选条件后您可以点击 预估 估算目标用户数量，以评估运营任务可能覆盖的人群范围。

为保证预估人数尽量趋于实际值，预估人群计算满足目标用户条件 且 使用的触达通道发送ID不为空（即能正常推送）的目标用户数。

4.4 客户端条件​

不同于服务端触发式任务，客户端触发式任务在使用AE数据资产外，还可通过客户端获取时效性更高的客户端参数。客户端参数包括数数 SDK 可获取的环境参数，此外，您还可以使用 TDRemoteConfig SDK 开放的SET参数接口，将游戏内的业务参数SET到SDK本地（详见 客户端触发式 SDK 接入文档 ），此类参数可用于触发任务的本地条件判断。使用流程如下：

  • 使用SDK开放的接口SET自定义参数，然后将自定义客户端参数添加到AE后台（详见 客户端参数 ）
  • 使用客户端参数在运营任务中配置「客户端条件」，该条件将直接下发至客户端SDK，当用户行为满足触发规则时，即时判断当前客户端持有参数是否满足限制条件，以此实现更加实时的条件判断。

4.5 推送配置​

4.5.1 设置 A/B 实验​

触发式任务支持 A/B 分流实验和赛马实验，更多内容可参考章节：A/B实验

且客户端触发式支持选择 “用户ID(客户端)” 或者 “账户ID” 作为分流主体。

4.5.2 疲劳控制​

当多个运营任务使用同样的触达方式（通道）时，您可以设置单用户在一定时间段内接收同类通道最大推送次数的限制，以减少对用户的过度打扰。

4.6 推送内容​

客户端触发式暂不支持多语言，若需要多语言推送可联系 ThinkingAI CSM 获取解决方案。

根据已选触达通道，您可以根据运营策略填入合适的触达信息内容，支持插入用户属性实现个性化文案，同时还可以即时进行发送测试预览和确认推送效果，此外还可以按需开启疲劳控制或设置任务白名单。

4.6.1 个性化内容​

支持在触达内容中插入用户属性 或 客户端参数，您可以根据触达的内容按需插入用户属性或者您设置的客户端参数以达到个性化内容的推送，比如在触达内容中插入用户昵称属性，则用户实际收到的消息中将携带他的昵称。

4.6.2 发送测试​

在任务提审前您可以通过 发送测试 预览并确保本次运营任务的推送内容无误。

客户端触发式发送测试需要使用测试设备，您可选择测试设备，并开启Debug模式。Debug模式开启方式见客户端触发式SDK接入文档。

您可对 触发规则、频率控制、客户端条件、推送内容进行测试，请在完成测试内容设置后选择测试设备并点击 发送

4.6.3 使用触发值​

选择推送类型为「触发-完成A」时，可将触发条件统计值或触发时的事件属性值定义为推送内容字段值，可实现更加精细化的运营策略。

使用场景如：

  • 关卡连续失败的情况下，可以带出对应关卡ID，动态下发对应关卡难度（如上图示意）
  • 游戏场景中，基于玩家点击商城的商品类型情况，推送对应商品类型的折扣券（如：偏好于皮肤、英雄、宠物或者武器等道具类型，推送对应道具类型的折扣券，皮肤折扣券、武器折扣券之类）
  • 统计玩家累计消耗某资源的数量，基于消耗的数量，动态下发资源礼包内容
  • 直播类产品场景中，基于玩家关注的主播，主播上线后带出主播的 id，推送的内容中基于主播 id 组装成最终的主页地址，便于玩家直接进到对应主播页面

4.7 目标设置​

设置用户被触达后完成指定事件行为即为转化，用于运营任务的效果评估。

支持同时设置一个主要目标，和两个次要目标。

4.8 指标设置​

支持设置任意触达节点后的指标表现，帮助判断运营效果。

具体使用方法可参考章节：任务效果分析

5. 功能 FAQ​

  1. 客户端触发式运营任务是否有数量上限？

    规格：单项目支持200个定时任务，30个服务端触发式任务， 30 个客户端触发式任务

    目前单项目最多支持 30 个客户端触发式运营任务，若需要提高数量上限可以联系运维修改。

  2. 触发规则中起止时间的含义是什么？

    起止时间是针对完成 A 事件的时间范围限制，可以理解为不在起止时间内发生的 A 事件不计入触发规则计算。

  3. 运营任务周期为什么无法手动选择？

    任务周期 代表任务的开始与结束时间，触发式任务下由于延迟推送设置的存在，任务周期 = 事件 A 的起止时间 + 事件 A、B 间隔时间 + 延迟推送时间，属于自动计算得出。

  4. 延迟推送 和 事件 A、B 间隔时长中的天是自然天还是 24 小时？

    天、小时和分钟都是以秒为单位参与计算，延迟 1 天是指延迟 24 小时也就是延迟86400秒。

  5. 客户端参数通道里的「消息类型」是什么？

6. SDK版本支持能力说明​

功能特性最小TDstrategySDK支持版本
  • 每完成支持多个或条件触发
  • 每完成支持基于事件属性值触发
  • 触发事件筛选支持属性类型列表/对象/对象组
  • 触发事件筛选条件支持双层嵌套

1.2.0

  • 依次完成
  • 完成A后未完成B
1.3.0

7. 可用数据资产说明​

关键步骤可用资产
推送时机
  • 事件：SDK采集事件
  • 事件属性：SDK采集属性
目标用户
  • 事件：数据状态为「正常」
  • 事件属性：数据状态为「正常」
  • 用户属性：全部
  • 分群：分群计算时区需与任务时区一致；计算主体为用户ID（#user_id）
  • 标签：标签计算时区需与任务时区一致；计算主体为用户ID（#user_id）
推送内容
  • 插入用户属性：仅实时可用
这篇文档对你有帮助吗？
本页内容