reportScene: 游戏场景上报

更新时间：2025/03/05 访问次数：1756

功能描述

用于游戏运行阶段的自定义场景上报。包括启动阶段的重点节点，以及关键用户行为。

接入该能力时，可根据文档最后章节“功能自检”，检查是否上报成功。

const SDK = my.tb.getInteractiveSDK()
SDK.reportScene({
  sceneId: 100,
  timestamp: Date.now(),
  costTime: 2000,
})

图1.：对应场景ID 301，游戏首帧渲染完成，用户用户看到首帧游戏画面的时间

图2：对应场景ID 302，资源开始加载，loading界面开始

图3：对应场景ID 303，资源加载完毕，此处以loading条走完，loading结束为标准

图4：对应场景ID 304，游戏可交互场景，用户可以进行交互（包括玩家可点击游戏开始键的场景）

场景ID	场景名称	场景说明	接入说明
301	游戏首帧渲染	用户看到首帧游戏画面的时间，具体见上方图示	建议接入
302	资源开始加载	loading界面开始，具体见上方图示	建议接入
303	资源加载完毕	loading界面完成，具体见上方图示	建议接入
304	游戏可交互	首场景上屏，用户可交互，真实到达率，具体见上方图示	建议接入
311	用户首次打开游戏		买量游戏建议接入，自动对接广告平台
312	用户注册		买量游戏建议接入，自动对接广告平台
313	用户创建角色		买量游戏建议接入，自动对接广告平台
321	用户点击广告		iaa游戏建议接入，自动对接广告平台
322	用户付费	用户完成内购付费	iap游戏建议接入，并传入付费金额
401	用户关键活跃行为Lv1	上报用户在游戏内进行的重点活跃行为，由游戏根据玩法自定义设计：如每完成1局、每合成3次等。	建议接入，并结合具体玩法设计上报时机；典型应用场景：平台通过权益任务吸引用户进入游戏，任务的门槛会关联游戏内定义的活跃行为（如打3局获得奖励），进游戏后根据行为上报推进任务进度，并发放权益奖励。

目前（2025年2月26日）已针对301～304添加埋点结果打印，开发者可以通过升级重装最新手淘客户端，扫描调试码在真机调试的Console面板查看埋点日志，自检是否上报成功。

关于此文档暂时还没有FAQ

有用(0) 我要提问