抖音经营任务
能力介绍
抖音经营任务系统支持在取得用户授权的前提下获取用户特定事件完成状态的信息。例如,开发者可设定关注小程序官号事件,若用户在任务时限内完成了关注操作,开发者可查询并感知该结果,发放小程序内奖励。
该能力可支持开发者在抖音场景内开展激励任务类活动。
活动示意
事件类型
当前支持的常规事件类型如下:
任务类型 | 细分事件 | 依赖条件 | 限制说明 | 完成条件 |
账号任务 | 关注抖音号 | 指定抖音号 | 仅支持1个账号 仅支持选择主体有关联关系的账号(以下简称「主体关联账号」) 包括:当前开放平台主体绑定的新B号、员工号、合作号、品牌号,及其他可获取主体关联关系的账号 | 用户自主关注此抖音号,视为事件完成 |
短视频任务 | 分享视频 | 指定视频 | | 用户分享该视频 |
完播视频 | •指定抖音号发布的视频 •指定视频 •指定挂载小手柄的视频 game id | 仅支持1个视频 视频筛选配置: 1.支持指定具体某个视频,仅支持选择归属于当前主体关联账号的视频 2.支持指定某个账号,将选中该账号下所有公开视频,仅支持选择当前主体关联账号 3.支持配置挂载特定组件(如具体到某个游戏的小手柄组件)的视频 | 用户完播指定视频 | |
点赞视频 | 指定视频 | | 用户点赞该视频 | |
收藏视频 | 指定视频 | | 用户收藏该视频 | |
评论视频 | 指定视频 | | 用户评论该视频 | |
直播任务 | 点赞直播间 | 主播账号 | | 用户点赞对应直播间 |
观看直播间 | •主播账号 •挂载此小手柄的直播间(时长满足) | 支持配置观看时长要求(上限2小时) 直播间筛选配置: 1.支持指定某个账号的直播间,仅支持选择当前主体关联账号 2.支持配置挂载特定组件(如具体到某个游戏的小手柄组件)的直播间 | 用户观看对应直播间并达到相应时长 | |
直播间分享 | 主播账号 | | 用户分享该直播间 | |
评论直播间 | 主播账号 | | 用户评论该直播间 |
当前支持的投稿SDK相关事件如下:
任务类型 | 细分事件 | 事件说明 | 查询事件完成情况时返回的参数 |
投稿SDK事件 | 通过投稿SDK发布作品到抖音 (仅通过投稿SDK发布的内容可被经营任务识别) | 仅识别通过投稿SDK发布到抖音的作品,要求如下: 1.需要当前申请权限的小程序已接入抖音投稿SDK 2.仅支持识别在任务时间内,作者通过当前小程序的投稿SDK发布的作品,包括视频、图文作品 3.最多统计用户符合条件的前10个作品,作品删除后无法参与统计 | 是否发布成功并审核通过 |
投稿的作品达到对应点赞数 (关联任务,依赖前置的投稿SDK发布作品任务) | 在配置「投稿SDK」任务的基础上,可叠加互动要求。叠加后,分别判定前置任务是否完成、前置任务的内容是否满足后续任务。 支持配置前置任务中的作品,是否满足最多5个点赞数要求。 1.可配置1~5个点赞数阶段 2.每个阶段分别返回完成情况 例如,可配置 5 个阶段分别为 1、10、100、1000、10000 点赞,则在达到对应点赞数时返回该阶段完成。 若「投稿SDK」任务中作者创作了多个满足条件的作品,则计算点赞数最多的作品。 | 是否达到阶段1、2、3、4、5点赞数 | |
投稿的作品达到对应播放数 (关联任务,依赖前置的投稿SDK发布作品任务) | 在配置「投稿SDK」任务的基础上,可叠加互动要求。叠加后,分别判定前置任务是否完成、前置任务的内容是否满足后续任务。 支持配置前置任务中的作品,是否满足最多5个播放数要求。 1.可配置1~5个vv数阶段 2.每个阶段分别返回完成情况 例如,可配置 5 个阶段分别为 1、10、100、1000、10000 个 vv,则在达到对应 vv 数时返回该阶段完成。 若「投稿SDK」任务中作者创作了多个满足条件的作品,则计算播放数最多的作品。 | 是否达到阶段1、2、3、4、5的vv数 | |
创作的作品达到对应评论数 (关联任务,依赖前置的投稿SDK发布作品任务) | 在配置「投稿SDK」任务的基础上,可叠加互动要求。叠加后,分别判定前置任务是否完成、前置任务的内容是否满足后续任务。 支持配置前置任务中的作品,是否满足最多5个评论数要求。 1.可配置1~5个评论数阶段 2.每个阶段分别返回完成情况 例如,可配置 5 个阶段分别为 1、10、100、1000、10000 评论,则在达到对应 评论数时返回该阶段完成。 若「投稿SDK」任务中作者创作了多个满足条件的作品,则计算评论数最多的作品。 | 是否达到阶段1、2、3、4、5评论数 |
请开发者知悉:
1.经营任务仅返回用户是否完成指定事件的结果,不会为用户自动执行上述事件操作。
2.同一时间生效的事件数量有限制,请避免创建大量测试任务导致无法创建真实任务。
接入流程
可通过「控制台-小程序详情-能力管理-互动能力-系统能力」目录,找到「经营任务系统能力合集」并申请抖音经营任务能力。
申请时,请填写预期使用的事件类型,并附带活动或任务示意图。请在活动示意图中明确展示预期让用户完成的操作及对应的奖励。
准入条件
能力的准入条件如下:
1.账号主体需为企业主体
2.小程序主营类目符合以下准入类目:
一级类目 | 二级类目 | 三级类目 |
电商 | 商家工具 | 3C数码 |
电商 | 商家工具 | 服装鞋包 |
电商 | 商家工具 | 个护家清 |
电商 | 商家工具 | 家居家电 |
电商 | 商家工具 | 美妆 |
电商 | 商家工具 | 食品饮料 |
电商 | 商家工具 | 生鲜 |
电商 | 商家工具 | 滋补保健 |
电商 | 商家工具 | 母婴图书 |
电商 | 商家工具 | 本地生活及虚拟 |
电商 | 商家工具 | 酒类 |
电商 | 商家工具 | 汽车类 |
电商 | 商家工具 | 美容美体医疗器械 |
电商 | 达人工具 | 电商达人工具 |
电商 | 品牌商家 | 店铺定制 |
技术文档:接入文档