文章目录
本文主要介绍星云开放平台“抖音小游戏SDK”封装的抖音小游戏登录、支付、客服服务,以及侧边栏复访、创建桌面快捷方式、推荐流直出小游戏、公会群等抖音生态拓展能力的业务表现及对接要点。
使用前提
- 登录星云开放平台 → 游戏中心 → 选择游戏 → 对接中心 → 渠道打包 → 渠道配置,添加抖音小游戏渠道,完成渠道参数配置。
- 而后“下载配置文件”,根据 抖音小游戏SDK对接文档 、抖音小游戏服务端对接文档 完成对接。
- 同时,您还需根据“抖音配置信息”或 抖音小游戏渠道配置指引 完成抖音开放平台的参数配置。
- 至此,即可使用抖音小游戏的登录、支付服务。
登录服务
- 已登录字节系APP的状态下,登录游戏为所在字节系APP的账号静默授权登录;即无需玩家输入账号密码或同意授权、直接进入游戏。
- 因字节系APP可在未登录状态下浏览,故未登录时启动抖音小游戏,需先完成所在字节系APP的登录;即抖音小游戏强制登录。
- 若需使用登录服务,需完成抖音小游戏SDK的
“登录”接口
对接。
支付服务
前言
- 星云封装的抖音小游戏支付服务,已升级抖音虚拟支付2.0 、接入 抖音钻石兑换功能 ,包含Android/iOS双端支付能力。
- 若需使用支付服务,需完成抖音小游戏SDK的
“支付”接口
对接。 - 因抖音渠道政策要求,
内购游戏必须完成IM客服能力接入
;故,请于 抖音开放平台 → 运营 → 功能 → 客服管理,开启IM客服能力。
支付流程
iOS移动端设备
- 支付流程
- 特殊说明
- iOS移动端设备,默认使用抖音钻石兑换进行支付。
3. 由于iOS渠道相关服务商自身运营策略,在玩家付费时将收取渠道服务费,可能导致玩家充值钻石购买游戏道具时价格与游戏页面价格有所差异。
请确保游戏内虚拟道具标价,调整为“抖音钻石”标价,避免玩家产生误解。
详见 抖音钻石素材及使用规范 。
- iOS移动端设备,默认使用抖音钻石兑换进行支付。
Android移动端设备
-
支付流程
- 支付示意
关闭支付
-
可通过 对接中心 → 渠道打包 → 渠道配置 → 抖音小游戏渠道参数配置 自助开关支付模式,提交后将即时生效。
-
若于星云关闭支付,即渠道参数配置中对应终端支付模式(xxx_pay_mode)选0,则玩家选中商品准备支付时,将出现提示无法支付。
客服服务
-
推荐使用抖音自带的IM客服或抖音客服平台消息能力。
-
建议通过抖音客服平台中设置自动回复,引导至接入星云客服WEB的工具(如微信公众号客服等)进行客服服务。
步骤一:通过 抖音开放平台 → 客服 → 抖音客服平台 → 前往客服工作台
步骤二:通过 运营管理 → 自动回复 设置问题,如点击联系客服;当用户点击该推送卡片时,将跳转至星云客服WEB工具
-
游戏若内置客服入口,预期点击打开抖音客服会话(可选进入抖音IM客服或抖音客服平台),请调用
V3.3.96及以上版本
的抖音小游戏SDK的“打开客服会话”接口
。
侧边栏复访服务
- 星云封装的抖音小游戏侧边栏复访服务,对接 抖音侧边栏复访能力 ,引导玩家从首页侧边栏进入游戏,带动小游戏留存提升;此能力在抖音新游首发及版本更新时已开启必接审核,请务必接入。
- 若需使用侧边栏复访服务,需完成
V3.3.66及以上版本
的抖音小游戏SDK的“侧边栏复访”接口
对接。 - 若需判断是否从侧边栏进入而进行入口有礼等活动奖励,需完成
V3.3.66及以上版本
的抖音小游戏SDK的“绑定进入前台事件”接口
对接。
创建桌面快捷方式服务
若期望支持玩家将小游戏快捷方式添加到手机桌面上、或游戏内计划设置创建桌面快捷方式的相关奖励活动便于复访提升留存,则需使用创建桌面快捷方式服务,需完成 V3.3.69及以上版本
的抖音小游戏SDK的 “创建桌面快捷方式”接口
对接。
推荐流直出小游戏服务
- 星云封装的抖音推荐流直出小游戏服务,对接 推荐流直出小游戏能力 。以游戏内的高价值信息为深度玩家的召回抓手,使用游戏进程中的不同场景掉落的重点信息进行触达召回;通过预加载能力,实现抖音推荐预览流无缝进入游戏的体验,将预加载完成的游戏在推荐流中分发给符合条件的用户。
- 若需使用推荐流直出小游戏服务,需完成
V3.3.80及以上版本
的抖音小游戏SDK的“直玩订阅”及“启动场景上报”接口
对接;且需登录星云开放平台 → 游戏中心 → 选择游戏 → 对接中心 → GM接口管理,完成GM预置接口“获取抖音用户已就绪场景列表”
的配置及上线。
- 若需判断是否从推荐流直出场景进入游戏,需完成
V3.3.80及以上版本
的抖音小游戏SDK的“绑定进入前台事件”接口
对接。
注意:
1、抖音直出要求总接口耗时控制在300毫秒以内,其中平台预留100毫秒,游戏接口需确保耗时控制在200毫秒以内。
2、建议初始配置为100 QPS,后续可根据抖音直出的实际访问情况进行动态调整。如需更高 QPS,需提前与平台确认后再进行调整。
公会群服务
- 星云封装的公会群服务,对接 小游戏公会群能力 。提供公会长绑定抖音公开群、公会成员加入抖音公开群的便捷入口,打通玩家互助交流通道,便于游戏的社群运营,助力游戏的长期留存。
- 公会,为游戏自行维护的群体,可以是帮派、群组等。面向公会长、公会成员,操作流程不同。
- 若需使用公会群服务,需完成
V3.3.82及以上版本
的抖音小游戏SDK的“查询公会是否绑定公开群”、“绑定公会的公开群”、“解绑公会的公开群”及“加入公会的公开群”接口
对接。
抖音小游戏站
前言
- 星云封装的小游戏站跳转服务,实现的是游戏内跳转抖音小游戏站,且默认跳转至小游戏站首页。
- 若需使用小游戏站跳转服务,需完成 V3.3.89及以上版本 的抖音小游戏SDK的 “跳转到抖音小游戏站”接口 对接。
游戏站演示
- 目前需要抖音客户端3.3.40以上版本才支持此功能
直播福袋礼包
前言
- 星云封装的直播福袋礼包能力,实现的是在抖音后台进行福袋礼包的配置,主播开播推广游戏的过程中,可以将游戏中的道具/礼包作为福袋发给观众,观众领取福袋进入游戏,即可核销道具/礼包。
- 若需使用直播福袋礼包能力,需完成3.3.94及以上版本的抖音小游戏SDK的 “领取礼包奖励”接口 对接。同时需完成GM系统“发送角色邮件”“获取角色信息”接口配置
- 发送角色邮件接口对接文档
- 获取角色信息接口对接文档
直播福袋礼包领取演示
- 用户参与福袋流程
- 用户领取福袋后进入游戏
- 用户领取福袋后主动兑换
广告服务
前言
- 星云封装的广告服务,覆盖抖音小游戏支持的“激励视频广告”形态。游戏内提供广告展示位,玩家通过观看广告获得游戏奖励,以实现流量变现。
- 若需使用广告服务,需完成
V3.3.96及以上版本
的抖音小游戏SDK的“激励视频广告”接口
对接。
广告配置
需于抖音开放平台,创建广告,获取广告位ID,创建路径:抖音开放平台->商业化->流量主->广告管理 完成广告位等信息配置,而后通知游戏研发处理游戏内广告展示位、抖音广告位&游戏内展示位的映射关系、广告观看任务设计及奖励发放等
广告演示
订阅消息服务
前言
- 星云封装的订阅消息服务,目前仅覆盖抖音小游戏的“一次性订阅消息”。玩家在游戏中订阅指定的消息内容,游戏开发者可在对应游戏场景向玩家下发一条模版消息。3.3.96
- 若需使用订阅消息服务,需完成
V3.3.96及以上版本
的抖音小游戏SDK的“订阅消息”接口
对接。
使用说明
步骤一:获取消息 ID
- 登录开发者平台 手动配置获取模板 ID(路径:运营-运营能力-订阅消息)
- 找到合适的模板后,按需勾选关键字,添加后可以获得消息ID(MSG开头),此时即可发送订阅消息,目前全部模板均支持【抖音 & 抖音极速版】
步骤二:获取下发权限
- 通过
tt.requestSubscribeMessage
向用户发起消息订阅请求,当订阅成功后星云将记录对应用户订阅的消息模板和订阅成功次数。
步骤三:调用接口下发订阅消息
- 当游戏通过对应模板发送订阅消息时,有该模板订阅成功次数的用户将收到推送。详见发送订阅消息
内容转发分享服务
前言
- 星云封装的内容转发分享服务,支持针对不同场景进行站内或站外的转发
- 若需于小游戏右上角“…”使用转发服务,需完成
V3.3.96及以上版本
的抖音小游戏SDK的“被动分享”接口
对接; 若需于小游戏内自定义转发入口使用转发服务,需完成V3.3.96及以上版本
的抖音小游戏SDK的“主动分享”接口
对接。
分享内容配置
支持两种形式来指定转发的内容(图片、标题、文案)最终按照优先级规则进行选择
1.代码指定分享内容(title、desc、imageUrl)
2.指定审核通过的模板素材 templateId
场景优先级端内分享代码指定分享内容 > 指定模板 > 抖音平台默认端外分享指定模板 > 抖音平台默认
转发演示
-
社交好友邀请
-
常规分享