上报说明
插件内嵌了各个推荐游戏的曝光、点击上报,由于接入的游戏环境不同,可能会产生各种兼容问题导致上报的逻辑判断失误,上报不成功,因此需要游戏方对上报进行验证。下面说明几个关键上报的验证。
新旧上报的区别
在1.0.1版本,更新了上报的方式,原本由插件后台生成一个唯一的session缓存到小游戏前端的localStorage中,用以标识用户身份,便于后续统计。现上报方式改为由游戏方构建插件的时候
传入openid来进行用户身份的标识。
新的构造函数调用:
旧版的上报:
新版的上报:
上报的种类
下面是上报的几个重要字段:
actionId: 事件类型,100为曝光,101为点击。
slotId: 标识事件发生的主体,1为整体,2为推荐游戏位,3为更多游戏,4为banner。
推荐游戏appid: 仅用在推荐游戏位为主体的上报,字段为推荐游戏的appid。
接入方游戏appid: 当前接入插件游戏的appid
orderid: 在推荐游戏位中,字段为该游戏位的次序(从1开始,横屏从左到右,竖屏从上到下)。更多游戏和banner值都为1。
以上的字段,事件不需要的默认为-1
目前插件包含的上报有:
1.整体的曝光上报
2.推荐游戏位的曝光、点击上报
3.更多游戏的曝光、点击上报
4.banner的曝光、点击上报
上报验证
游戏方可根据上面的上报格式以及包含的上报类型,在开发者工具上进行测试验证,查看调试面板的network部分:
也可在插件调试模式下查看成功上报的数据(调试模式请见文档目录“调试模式”部分):
主要的验证点为:
1.上报的游戏appid和openid是否正确
2.上传的数据是否覆盖了上面提到的所有上报事件(更多游戏和banner根据后台配置可能不会出现,此时应没有该主体的上报)
3.上报回包是否正确,回包如下图:
上报常见问题定位
如果上报出现问题,请查看下面几个步骤是否正确:
1.插件构造函数是否传入了正确的appid和openid
2.是否添加了安全域名
3.是否改写了引擎网络层,导致了适配问题