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

订阅消息能力介绍

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

功能介绍

本能力支持抖音。

一次性订阅消息

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

长期订阅消息

一次性订阅消息可满足小游戏的大部分游戏场景需求,但也存在一次性订阅无法满足的场景,如长期的礼包提醒,签到等。为便于服务,我们提供了长期性订阅消息,用户订阅一次后,开发者可长期下发多条消息。
目前长期性订阅消息内测中,暂时不对外开放,若有需要可联系对应的游戏对接同学。

订阅消息权限管理

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

推送说明

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

使用说明

步骤一:获取消息 ID

    1.登录字节开发者平台 手动配置获取模板 ID(路径:运营-运营能力-订阅消息)
    2.找到合适的模板后,按需勾选关键字,添加后可以获得消息 ID(MSG开头),此时即可发送订阅消息。

步骤二:获取下发权限

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

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

使用规范

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