# 侧边栏复访能力接入技术指南——仅备案游戏

更新时间：2025-03-11 21:15:29

# 能力介绍

为养成用户打开快手->打开首页侧边栏->快速访问小游戏的心智，有效提升用户次留、七留率，平台侧推荐开发者接入快手首页侧边栏复访组件，引导用户养成从首页侧边栏进入游戏的习惯。

适配宿主：快手、快手极速版

适配操作系统：安卓、ios均可

适配游戏：备案游戏

版本：快手安卓版本>=12.11.10，iOS版本>=12.11.10

# 应用实例

开发者在游戏内接入礼包引导复访的能力——>游戏版本发布——>用户在游戏主界面看到引导礼包——>用户根据指引，从侧边栏进入游戏——>进入礼包界面获取复访奖品。

第一步

第二步

第三步

第四步

# 方案示意

# 接口说明「未备案游戏别接」

语法

ks.checkSliderBarIsAvailable (opens new window)(Options)

Options参数说明

属性名

类型

必填

说明

success

function

是

接口调用成功的回调函数

fail

function

是

接口调用失败的回调函数

回调成功参数

属性名	类型	说明
available	Boolean	侧边栏是否可用

回调失败参数

属性名	类型	说明
code	int	状态码
msg	string	错误信息

调用Demo:

  ks.checkSliderBarIsAvailable({
        success: (result) => {
            this.content.string =
                "侧边栏调用成功: " + JSON.stringify(result);
        },
        fail: (result) => {
            this.content.string =
                "侧边栏调用失败: " + JSON.stringify(result);
        },
    })

# 技术方案流程：

参考流程图：

详细路径：

步骤

解释

判断是否展示礼包入口

1.游戏启动时ks.onshow拿到进入游戏的from是否是sidebar_new（侧边栏外漏小程序），根据from判断是否由侧边栏进入，从侧边栏进入说明侧边栏可用，展示入口。

2.ks.checkSliderBarIsAvaliable判断侧边栏是否可用。若不可用，不展示礼包入口，可用即展示礼包入口

2.奖励展示

若侧边栏可用，并且侧边栏进入，可直接领取奖励

若侧边栏可用，但不是侧边栏进入，引导用户从侧边栏进入。

# 设计物料参考：

游戏需要根据本游戏整体风格及定位，设计相关图片素材，包括不限于礼包领取入口、点击礼包后引导弹窗及内容，可根据基础版动图引导，替换成自己游戏的icon。不建议放在游戏首页，建议放置于小游戏主页面显眼位置，方便玩家玩游戏时快速添加。

	建议文案及内容
类型	内容	建议文案	建议设计
有游戏奖励	任务入口	文案需直观，快速让用户理解，建议为「限定福利」「入口有奖」等	1.建议设计成动态图标，吸引用户点击 2.不建议放在游戏首页，建议放置于小游戏主页面显眼位置，方便玩家玩游戏时快速添加。
	任务界面	建议包含以下内容顶部标题：「入口奖励」步骤文案： a.「点击侧边栏图标」 b.点击「XXXXX」（游戏名） c.领取奖励按钮文案：我知道了（未完成态）/ 立即领奖（完成态）需注意设计关闭弹窗的按钮接入tips：接入的奖励最好是和游戏强相关，比如合成消除类的游戏给吸铁石，体力类游戏给体力更能激发用户的复访。	可使用平台提供的GIF动图，也可自行设计静态图
	任务频次	因复访习惯需要逐步养成，建议奖励设置为「每日」可领取，加强用户感知及留存

# 常见问题QA

Q1：侧边栏接入是否一定要备案？

游戏需要快手平台备案通过，否则无法展示在侧边栏-常用小程序中。

Q2：是否需要激励用户每天从侧边栏复访进来都给奖励？

可自定义发奖频次和奖励内容，建议设置为【每日访问奖励】，激励用户复访行为。

Q3：当前是否支持游戏中弹窗，点击拉起侧边栏页面？

暂不支持，敬请期待。

Q4：怎样算是接入成功？

用户层面：用户从侧边栏-常用小程序进入游戏时获得奖励，视为成功。

接入层面：成功监听到用户从侧边栏进入，游戏内发奖，视为成功。

Q5：侧边栏接口回调false是什么原因？

游戏未成功在快手平台备案。

其他问题，请提供appid，对接官方运营人员。

# 侧边栏复访能力接入技术指南——仅备案游戏

# 能力介绍​

# 应用实例​

# 方案示意​