抖音开放平台Logo
开发者文档
小游戏
控制台
  • 体验抖音小游戏
  • 游戏引擎
  • 基础功能
  • 开放能力
  • 商业化激励再得能力介绍
  • 游戏群聊能力接入介绍
  • 关注抖音号能力介绍
  • 游戏推荐组件能力介绍
  • 游戏排行榜功能介绍
  • 订阅消息能力介绍
  • 开放数据域基础能力
  • 多端支持
  • 「必接」侧边栏复访能力技术指南
  • 道具礼包营销能力指南
  • PC 端小游戏接入指南
  • 支付
  • 推荐流直出小游戏能力接入指引
  • 性能优化

    • 推荐流直出小游戏能力接入指引

    收藏
    我的收藏

    推荐流直出小游戏能力简介

      1.以游戏内的高价值信息为深度玩家的召回抓手，使用游戏进程中的不同场景掉落的重点信息进行触达召回；
      2.通过预加载能力，实现抖音推荐预览流无缝进入游戏的体验，将预加载完成的游戏在推荐流中分发给符合条件的用户。

    应用实例

    全链路动态实机演示
    （百炼英雄）
    广告锚点启动
    玩游戏
    体力耗尽后退出，刷抖音
    体力恢复后刷到游戏本体
    通过游戏原生组件透传信息
    直接进入游戏游玩
    ​
    ​

    数据效果

      •LT 及收入：
      ◦AB 实验下：人均游戏时长+3.17%、人均总收入+12.49%；
      ◦从推荐流直出游戏进入 VS 游戏整体：付费率高 1.79pp，总 arpu 高55%。
      •留存：活跃留存仅次于添加桌面、首页侧边栏
      ◦次日留存 +3.44%、7日留存 +2.08%；
      ◦从推荐流直出游戏进入 VS 游戏整体：次日留存高 36pp、7日留存高 21pp；
      •ROI 7 收益：良好适配游戏 ROI7 增益达+3.5pp 以上。
    ​

    推荐流直出小游戏能力自助接入指引

    开放平台中的自助接入入口

    示意图
    描述
    开始接入：
      •Step 1：点击「运营」板块-「运营能力」
      •Step 2：找到「用户留存」模块-点击「推荐流直出游戏能力」即可开始接入

    自助接入流程指引

    自助接入全流程简述

    ​

    自助接入全流程视频指引

    ​

    Step 1：接入申请-方案提报

    步骤
    示意图
    描述
    方案提报
    操作流程：
      •选择需要通过「直出游戏」能力提醒的信息场景
      •在对应场景下，配置文案信息和上传 UI图片
      ◦游戏内的订阅文案及订阅授权弹窗 UI图片
      ◦在抖音推荐流展示的文案+UI（含游戏内的气泡提醒）
      •配置完成后，可提交审核
    订阅 ID 生成
    操作流程：
      •方案审核通过后，平台将会自动生成 Content_id
      •**重要** ：Content_id 在接入 API 开发时需要
      •点击「下一步」进入下一流程

    Step 2：API 接入-API 指引

    步骤
    示意图
    描述
    按照 API 指引进行接入开发
    操作流程：
      •Step 1：按照「API 接入」模块的相关链接查看对应 API 指引
      •Step 2：按照 API 指引进行接入开发
      •开发者可以通过以下 API 能力，获取具体的启动场景和自定义的游戏信息字段，以实现加载时跳转到对应场景。
    能力名称
    场景信息字段
    类型
    字段值
    字段描述
    ​
    JS API：tt.getLaunchOptionsSync
    C# API：​TT.GetLaunchOptionsSync​
    scene
    string
    固定为：xx3041
    标识推荐流直出场景（xx表示为可变的数字，只需要判断后四位）
    {
    "scene": "xx3041"
    "query": {
        "feed_game_scene": enum{1,2,3}
        "feed_game_extra": ""
    }
}
    ​
    query
    ​
    ​
    feed_game_scene
    number
    1
    离线收益场景
    2
    体力恢复场景
    3
    重要事件掉落
    feed_game_extra
    string
    自定义
    ​
    开发者自定义字段，可通过 推荐流直出能力 OpenAPI 接入文档 接口的 extra 字段进行赋值
      •开发者需要通过以下 API 能力，向平台侧传达游戏场景加载完成、达到可交互状态的时机，同时也便于开发者进行场景加载耗时统计和分析。
    能力名称
    场景信息字段
    类型
    字段值
    字段描述
    JS API：tt.reportScene
    C# API：​TT.ReportScene​
    sceneId
    ​
    number
    固定为：7001
    标识游戏场景加载完成，达到用户可交互状态
      •其他 API 文档
    文档
    链接
    订阅接口
    JS 订阅接口
    JS 检查订阅接口
    C# 订阅&查询订阅状态接口
    服务端接口
    推荐流直出游戏能力签名计算方式
    推荐流直出游戏能力 OpenAPI 接入文档
    FAQ
    推荐流直出游戏能力 FAQ
    ​

    Step 3：完成服务器信息配置和接口功能性能检测

    步骤
    示意图
    描述
    服务器信息配置
    操作流程：
      •Step 1：完成服务器：「Domain」、「Path」及「测试用户 OpenID」
      •Step 2：点击「功能测试」，将会自动校验服务器功能是否完备
      •Step 3：填写自身接口可承载的 QPS 上限
      •Step 4；点击「性能测试」，将会自动进行接口压测
    接口功能及性能检测
    操作流程：
      •按上述流程进行测试后，将会在 2min 内自动生成测试结果
      •仅当「功能测试」及「性能测试」均通过时，才可进行下一步

    Step 4：完成测试设备信息配置及问题排查工具

    步骤
    示意图
    描述
    测试设备信息配置
    ​
    操作流程：
      •Step 1：点击「添加设备」按钮即可添加测试设备
      •Step 2：使用抖音扫描屏幕二维码完成设备信息的添加
    问题排查工具（遇到问题时使用）
    操作流程：
      •在实际测试过程中，遇到无法刷到游戏的情况下，可使用「问题排查工具」进行问题排查
      •Step 1：输入无法刷到游戏的测试账号 UID、DID 等信息
      •Step 2：选择测试时的时间段（注意选择精确到秒，问题定位会更加清晰）
      •Step 3：点击「问题分析」，将会直接输出无法刷到游戏的问题定位和解决建议

    Step 5：完成测试报告检查及确认

    步骤
    示意图
    描述
    测试报告检查及确认
    操作流程：
      •完成测试验证后，平台将会自动生成测试用例报告
      •开发者需根据实际的测试情况，勾选确认已完成该测试项的测试
      •测试报告检查确认完成后，可进入下一步

    Step 6：发布线上小流量验证

    步骤
    示意图
    描述
    发布线上小流量验证
    ​
    操作流程：
      •测试报告确认完成后，可自助发起进行「线上小流量验证」
      •小流量验证期为 7 个自然日
      •小流量验证主要检查上线后用户对游戏的实际反馈，当前仅当用户的正点击率和负点击率达到准入要求后可全量上线
    小流量验证结果
    小流量验证通过
    小流量验证未通过
    ​
      •验证信息：正点击率、负点击率
      •标准：正点击率高于及格线，负点击率低于及格线

    Step 7：功能全量上线

    步骤
    示意图
    描述
    发布线上小流量验证
    操作流程：
      •小流量验证通过后，可点击「申请推全」按钮，发起全量上线申请
      •审核通过后，将自动全量，后续可直接查看该游戏的直出数据效果
    ​
    ​