H5 小游戏

更新时间:
复制为 MD 格式

API 对接

账号

H5 调用

window.mPaaSGameJSBridge.call('getUserInfo', (data)=>{
    data.userId // string, 用户 ID,必须
    data.name // string, 用户名,可选
});

广告

播放激励视频

// 调⽤参数
// 固定 mPaaSGameJSBridge
// ⽅法名:showRewardAd
// 回调参数:根据业务⾃定义,在webview通知回调,会将参数原样返回,⽤于区分业务
window.mPaaSGameJSBridge.call('showRewardAd', (data)=>{
    data.success // bool true表示成功,false表示失败
    data.code    // int 错误码
    data.msg     // string 错误信息
})

添加监听

window.addEventListener("mPaaSGameCallback", (event) => {
    let data = event.detail
    let action = data.action
    console.log(action)
    switch(action) {
        case 'onAdShow':
            console.log('⼴告展示')
            break
        case 'onAdReward':
            console.log('⼴告获得奖励')
            break
        case 'onAdClosed':
            console.log('⼴告关闭')
            break
    }
});

拦截返回

 document.addEventListener('back', function(e) {
       e.preventDefault();
       // 自己的逻辑
}, false);

数据上报

接入

前端请参考 H5 配置通用埋点 引入 mtracker SDK。

使用

  1. 引入 CDN 版本的 mtracker。引入 mtracker 后,会在全局 window 中注入 Tracker 对象。

    说明

    针对下载的 mtracker 埋点,可能会出现 JS 文件中文出现乱码的情况,正常使用该 JS 文件即可,不影响埋点配置。该中文乱码问题可能是由于文件编码格式与浏览器解释的编码格式不同所导致。

  2. 初始化配置。根据不同场景,在 H5 埋点 JS 文件中注入相应的信息。

    代码示例如下:

    <script>
    window._to = {
      bizScenario: 'h5game_xxx',   // h5游戏,xxxh5游戏分配的id,具体分配的id咨询对接人
      mtrDebug: true,         // 选填,默认为 false, 调试期间使用true
    };
    </script>

    参数

    描述

    bizScenario

    渠道来源,默认为空,选填。

    mtrDebug

    是否开启 mtracker 的 Debug 模式,在 Debug 模式下会打印上报的日志,默认为 false 不开启。

埋点

Tracker.expo('xxx', 									// eventId,具体见下文
             { 
               bizType: 'h5game',      // 固定值h5game
               ext: { 
                   gameId: '80000002'  // 具体游戏分配的id,具体分配的id咨询对接人
                   userId:   'xxxx'     // 用户id
                   duration:  xxx				// 停留时长,单位秒, 只有gameStayTime和gameStartCost需要,其他eventId不需要
               } 
            });

eventId

eventId

功能

备注

gameEnter

进入游戏

gameStayTime

停留时长

ext 需要 duration

gameStartCost

启动耗时

ext 需要 duration

gameAdClick

广告点击

gameAdReward

广告激励下发