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

推荐流直出游戏全局订阅能力指引

收藏
我的收藏
抖音小游戏为开发者提供可直接引导「全局直出游戏订阅」的 API 能力。开发者可通过调用该 API ,使用游戏内相关道具资源,激励用户主动订阅「直出游戏提醒」。

前置条件

开发者需要先完成推荐流直出游戏能力的整体接入,接入流程可参考:推荐流直出游戏能力接入指引

接入指引

1. 用户链路示意

游戏内新增福利引导入口
游戏内给予明确指引
主动订阅授权
校验用户订阅状态告知CP可发奖
用户已订阅,活动引导入口退场

2. 技术方案流程

相关文档:

参考流程图

详细路径

步骤
解释
步骤一:
判断是否展示奖励入口
游戏启动时,判断是否满足奖励分发条件:
    1.如果用户已经领取过奖励,不展示奖励入口;
    2.通过tt.canIuse("checkFeedSubscribeStatus.object.allScene")判断用户当前的抖音版本是否支持全局订阅能力:
    若返回值为 false ,不展示奖励入口;
    若返回值为 true ,展示奖励入口。
步骤二:
奖励展示
    1.用户点击奖励入口时,展示奖励界面并调用 tt.checkFeedSubscribeStatus | TT.checkFeedSubscribeStatus,入参 allScene 设置为 true,用于查询用户的全场景订阅状态:
    若返回字段 status = true,奖励按钮展示「领取奖励」,进行奖励分发;
    若返回字段 status = false,奖励按钮展示「去订阅」,进入第 2 步。
    2.用户点击「去订阅」按钮时,调用 tt.requestFeedSubscribe | TT.requestFeedSubscribe,入参 allScene 设置为 true,用于拉起全局订阅面板:
    若用户点击面板上的「允许」按钮完成订阅,平台侧回调订阅结果 success = true,奖励按钮更新为「领取奖励」,进行奖励分发;
    若用户点击面板上的「拒绝」按钮,未完成订阅,平台侧回调订阅结果 success = false,游戏侧不分发奖励。