开发指南
一、能力介绍
淘宝二楼回访路径较短，是淘宝小游戏主要的回访路径之一。平台推荐开发者申请接入轻应用后，引导用户从淘宝首页下拉进入二楼-最近使用中进入游戏。
二楼是轻应用框架的一部分，接入二楼前，请先跟对接运营（@卿识 @樱诺）确认已通过轻应用入驻申请，才可在二楼搜索到游戏或出现在最近使用游戏中。
为此，需要ISV在游戏中设计任务、首页icon等形式，培养核心用户从二楼返回的习惯。平台方将提供二楼回访教育的弹窗设计与回访渠道识别API，游戏方针对从二楼回访的游戏发放奖励，针对未从二楼进入的用户进行回访教育。
二、应用实例
开发者在游戏内设计引导二楼回访的活动或任务，点位可参考表格。
游戏根据渠道判断API（具体见下文第四章节），非二楼渠道玩家在游戏主界面看到引导礼包后展示回访教育弹窗（具体见下文第三章节），二楼渠道玩家看到引导礼包后发放复访奖品。
类型 |
示例 |
任务列表 |
|
桌面礼包 |
|
三、回访教育弹窗
引导教育弹窗样式如下，开发者可下载sketch文件，对弹窗中最近访问的游戏icon与游戏名进行替换。
平台提供sketch与psd两种格式，可供选择。
sketch格式（含横屏与竖屏）： ?二楼回访弹窗.sketch
psd格式（横屏）： ?横版.psd?
psd格式（竖屏）： ?竖版.psd
四、渠道识别能力
玩家回访游戏时，游戏方可通过渠道识别API识别用户来源。
若识别用户从二楼回访，判断该「二楼」回访任务、活动完成，发放游戏对应奖励。
API文档 |
备注 |
二楼的tag值为：ceiling，同时，extra.raw的值为mini_ceiling。 实践中，请使用extra.raw进行取值，因为其他渠道可能没有tag值。 |
游戏上线前可通过调试码链接或预览码的链接，拼接上参数hdkf_from=mini_ceiling来mock 二楼回访链路，测试发奖。
注：添加参数时请按照URL拼接参数的技术规范，根据实际情况使用?或者&符号进行拼接。
