推荐流直出小游戏-获客版能力接入指引
收藏一、能力简介
抖音小游戏基于「推荐流直出游戏能力」开启「获客拉新」的应用：
（1）将大盘游戏用户的产品偏好等数据接入推荐机制
（2）为接入直玩获客能力的游戏推荐更多适配的新用户，帮助更多小游戏厂商在抖音开拓更广阔的流量池
二、技术接入流程
若您的游戏有服务器注册创角、联网：
2.1 对于「无服务器注册创角、联网的游戏」
按照接入工具，依次完成各环节步骤即可：
接入入口
示意图 | 说明 |
1、进入单款游戏的「工作台」 2、在运营能力板块中，找到「推荐流直出游戏能力」 3、进入后选择「获客能力」tab 4、了解相关内容后，点击「开始接入」，即开始获客接入流程 |
接入申请
示意图 | 说明 |
为了保证接入后的获客效果 1、需要开发者上传用于获客拉新的游戏首帧画面UI及文案，用于平台审核方案 2、相关UI的设计并非封面素材，需要在游戏中同样有相关的UI元素（即用户看到的预览流UI，与进入游戏后的UI保持一致） Tips：建议直接用游戏新手引导即可，但需注意在预览流中的设计规范 （设计时，开发者需按启动渠道为用户选服/创建角色/屏蔽相关弹窗） 3、完成方案上传后，点击「提交审核」，整体的图片与文案将会进入审核 4、审核通过后点击「下一步」 |
API接入
示意图 | 说明 |
1、接入前请先阅读API接入说明（本文第3部分） 2、依次按照相关API文档完成API的接入功能开发 2、接入完成后，点击「下一步」 |
联调测试
示意图 | 说明 |
1、点击「添加设备」，将游戏测试同学的抖音账号信息绑定至开放平台 2、使用该抖音账号，在抖音上进行测试验证 3、刷到游戏的获客版，并且UI正常渲染、可正常进入游戏并开始游玩，即为测试通过，可点击「下一步」 4、针对长时间无法刷到游戏，可使用不出卡问题排查工具，查询相关报错信息 |
测试报告验证
示意图 | 说明 |
1、如若在上一步测试时：刷到游戏的获客版，并且UI正常渲染、可正常进入游戏并开始游玩，即为测试通过 2、测试通过后，点击「下一步」 |
小流量验证
示意图 | 说明 |
| 1、测试通过后，点击「小流量验证」按钮，可发起小流量验证 2、抖音小游戏将会提供小流量为其验证游戏在抖音内的用户反馈 3、验证数据主要验证：用户对与当前游戏获客的体验指标 CTR=点击进入游戏UV / 游戏的曝光UV Dislike=点击不感兴趣UV / 游戏的曝光UV 4、通过标准： IAA游戏：CTR不低于9%，Dislike不高于2% IAAP/IAP游戏：CTR不低于5%，Dislike不高于2% 5、小流量验证通过后，即可点击【下一步】按钮申请全量发布，审核通过后能力将全量开放 6、若小流量验证未通过，优化获客的首帧UI，再重新发起验证 说明： 首次发起验证，需等待7天，通过后可点击【下一步】发起申请推全 若首次验证未通过，再次发起需等待1天，并重新计算CTR和Dislike数据 |
2.2 对于「有服务器注册创角、联网的游戏」需前置完成游戏侧改造
由于直玩游戏使用的是预加载技术，获客游戏还没有在抖音队列展现前（甚至用户未点击进入直玩容器前），对应的用户为潜在游戏用户，若游戏侧在用户还未点击进入游戏前做游戏角色创建等相关操作，会为游戏服务器带来大量无效用户请求，可能会破坏游戏生态，因此，正确的游戏角色创建等操作需要在用户点击进入直玩容器后进行。
第 一步：游戏侧实现无效用户过滤拦截逻辑
- 1.开发者侧对于直玩容器预加载的用户暂不做注册创角
- 2.用户feed流所见的游戏是：与本体一致的单机版本游玩模式
- 3.用户通过直玩进入后，游戏侧应静默完成用户注册，并实现游戏进程的继承和延续
方案总结：
- 1.开发者需要承担一定的工作量
- 2.可完全解决由于预加载导致的大量无效注册用户问题以及服务器并发压力问题
- 3.保证直玩-获客：所见即所得以及游戏进程资产连续性的良好体验
三、API接入说明
总共包括3个部分：
- 1.上报加载完成时机--所有游戏必接
- 2.按启动渠道为用户选服/创建角色/屏蔽相关弹窗--游戏内存在选服和创建角色的部分+存在默认弹窗时需接入
- 3.转化数据统计能力--所有游戏必接，帮助游戏识别和统计点击直玩的真实活跃用户的数据
3.1 上报加载完成时机——必接
- •API接口：
- •案例示意
BadCase | GoodCase | 描述 | ||
预览流 | 进入游戏 | 预览流 | 进入游戏 | |
1、当游戏加载完成时，通过专门的API，回传加载完成信号至抖音 2、抖音根据该信号，将加载完成游戏本体包插入直玩容器 | ||||
3.2 按启动渠道默认选服/创建角色/屏蔽相关弹窗
- •API接口：
- •案例示意
BadCase | GoodCase | 描述 | ||
预览流 | 进入游戏 | 预览流 | 进入游戏 | |
1、抖音将通过API告知开发者，即将启动游戏的用户来自「直玩获客渠道」（详细见本文4.2的说明） 2、针对该用户： ◦ 新手引导教程：在场景加载完成到用户游玩前，插入一段单机版本的游玩模式（推荐为新手引导教程） ◦ 选服/创建角色：在用户进入游戏完成新手引导后，为该用户分配服务器/创建角色 ◦ 游戏内的默认弹窗：针对「直玩渠道」启动的用户，暂时屏蔽相关弹窗，用户进入后3s再重新走游戏的默认弹窗逻辑 | ||||
3.3 转化数据统计能力——必接
四、Q&A
4.1 直玩场景下的场景加载完成时机上报，为什么要区分复访版和获客版？
直玩场景的出卡依赖游戏侧的加载完成时机上报。复访版和获客版的加载完成时机定义并不完全一致：
- •复访版（详见推荐流直出小游戏能力接入指引）的触达人群为玩过该游戏并且满足一定游戏条件的复访用户，目标是留存。复访版的场景加载完成时机是：游戏侧帮用户加载到奖励领取/重大事件的场景。
- •获客版的触达人群为从未玩过该游戏的潜在用户（用户需实名认证过），目标是拉新。获客版的场景加载完成时机是：游戏侧资源加载完成，达到用户可进行游戏交互的状态。
因为reportScene是一个通用的数据上报接口，为了防止直玩场景和其他入口场景、直玩场景中的复访版和获客版相互影响，需要在API调用前判断区分直玩复访版和直玩获 客版。
4.2 如何区分复访版和获客版？
- •首先通过判断scene为xx3041（后四位为3041，前两位为可变的数字）明确为直玩场景；
- •再通过feed_game_channel的取值区分复访版和获客版：1表示复访版，2表示获客版。
4.3 负CTR的判定方式是什么？如何降低负CTR？
Dislike（负CTR）=点击不感兴趣UV / 游戏的曝光UV
当用户点击「不感兴趣」按钮会导负CTR上升，建议在方案设计的前1-3秒快速抓住用户眼球（例如使用手势引导教学、吸睛新手动画等），吸引点击进入游戏游玩。
4.4 CTR腰斩式下跌是什么原因？
CTR=点击进入游戏UV / 游戏的曝光UV
当点击进入游戏UV没有增加，但游戏的曝光UV大幅增加导致CTR下降，可能与同期的平台扩量实验相关。
4.5 获客版推全上线后，想修改新方案重新上线，如何操作？
第一步，在【获客能力-文案配置】模块，上传新方案的游戏首帧画面UI及文案
第二步，审核通过后，修改新方案对应的游戏实现代码
第三步，完成联调测试，刷到新方案的获客版，并且UI正常渲染、可正常进入游戏并开始游玩，即为修改成功
4.6 联调测试过程的相关问题
1）测试时刷到的为什么不是提报方案时提供的图片？
提报方案时提供的图片是为了审核方案合理性，而游戏加载到什么位置在Feed流展示是由开发者调用reportScene决定，请开发者仔细查看客户端API文档。
同时提报方案时请上传reportScene对应位置的图片，否则推全审核时可能无法通过。
2）测试时刷不到我的游戏，不出卡问题排查工具也查询不到报错信息，怎么办？
需要解除绑定当前设备，再重新绑定设备并点击绑定游戏，等待一段时间即可刷到。若还是长时间刷不出，可向平台客服反馈（ 反馈/咨询路径：开发者平台-右下角「开发者助手」-「在线客服」-描述问题或输入两次「人工客服」- 进入「在线人工客服」-根据问题类型选择【小游戏-技术问题】并描述问题）
3）测试时在抖音显示了【预启动】，但提示【直玩游戏首帧没有渲染完成】，为什么？
需要在显示【预启动】后等待一段时间，再往下刷，避免刷的速度过快。
4）测试时提示【直玩游戏场景没有加载完成】，为什么？
加载失败是游戏加载太慢导致，或没有上报reportScene导致，非server接口问题。
5）测试时抖音侧的请求多长时间一次？
测试设备都是豁免频控的，因此请求频率会更高。一般冷启后向下刷10个视频左右就会请求。
6）测试完成后点击下一步提示报错，怎么办？
刷新页面即可。
若有其他任何疑问，可向平台客服反馈或咨询，Oncall解答更及时～（ 反馈/咨询路径：开发者平台-右下角「开发者助手」-「在线客服」-描述问题或输入两次「人工客服」- 进入「在线人工客服」-根据问题类型选择【小游戏-技术问题】或【小游戏-非技术问题】）
