抖音开放平台Logo
开发者文档
控制台

订阅消息能力

收藏
我的收藏
基于抖音的通知渠道,我们为开发者提供了可以高效触达用户的订阅消息能力,以便实现服务的闭环并提供更佳的体验。​
开发者在游戏内,可通过 tt.requestSubscribeMessage向用户发起消息订阅请求,开发者需后台自行记录用户是否订阅成功及订阅成功的次数。​
用户在小游戏中订阅指定的消息内容后,开发者可以在后台通过下发消息服务把一条模版消息发送给用户,用户最终在抖音的 “消息-游戏通知” 中收到​
用户成功订阅一次,开发者可在游戏认为场景合适的时机,向该用户发下一条模版消息。​

一、功能介绍​

本能力支持抖音、抖音极速版

1.一次性订阅消息​

一次性订阅消息用于解决用户使用小游戏后,后续服务环节的通知问题。用户自主订阅后,开发者可不限时间地下发一条对应的服务消息;每条消息可单独订阅或退订。​

2.长期订阅消息​

一次性订阅消息可满足小游戏的大部分游戏场景需求,但也存在一次性订阅无法满足的场景,如长期的礼包提醒,签到等。为便于服务,我们提供了长期性订阅消息,用户订阅一次后,开发者可长期下发多条消息。​
目前长期性订阅消息内测中,暂时不对外开放,若有需要可通过运营群进行反馈(接入指南 -联系我们)​

二、订阅消息权限管理​

以下几种情况的订阅消息权限可以在【设置--订阅消息管理】页面中进行管理,包括开启与拒绝接受​
    一次性订阅消息选择“总是保持以上选择,不再询问”后
    长期性订阅消息选择“允许”后
    长期性订阅消息选择“拒绝,不再询问”后

三、推送说明​

    订阅消息下发条件:用户自主订阅
    订阅消息卡片跳转能力:点击查看详情可跳转至该小游戏
    推送位置: 【抖音 - 消息 tab - 游戏通知】

四、使用说明​

步骤一:获取消息 ID​

    登录开发者平台 手动配置获取模板 ID(路径:运营-运营能力-订阅消息)​
    找到合适的模版后,按需勾选关键字,添加后可以获得消息ID(MSG开头),此时即可发送订阅消息,目前全部模版均支持【抖音 & 抖音极速版】

步骤二:获取下发权限​

详见小游戏服务端消息订阅接口tt.requestSubscribeMessage

步骤三:调用接口下发订阅消息​

五、使用规范​

(1)使用订阅消息能力进行诱导点击、下发与用户预期不符的内容被视为违规​
(2)针对关注小游戏的用户可以发送 push 与气泡,对恶意诱导关注的行为将视为违规​
    第一次违规,封禁接口 7 天
    第二次违规,封禁接口 14 天
    第三次违规,封禁接口 30 天
    第四次违规,永久封禁接口
(3)开发者平台暂不支持新增模板、新增关键字的申请,后期将逐步开放​
(4)如有定制模版需求,但当前模板库里不存在,可通过运营群进行反馈(接入指南 -联系我们)​