# 数据监控

您可以使用以下方法，上报给我们需要监控的指标，这样未来如果遇到数据异常，可以及时获得通知。

# 一、美团游戏埋点接口

LXAnalytics(eventType, valBid, valLab, options)

埋点接口如上，一共四个参数

eventType：事件类型
valBid：bid，根据场景传入固定值
valLab：业务参数，根据埋点方案传入
options：事件参数，包含 cid、通道等信息

# 二、概述

本次埋点接入 + 上报一共需要上报 4 个埋点

PV（页面展示，必须上报）
PD（页面消失，必须上报）
MV（创角成功，根据场景上报）
MV（等级变更，根据场景上报）

业务方可以直接使用下文「使用示例」中的代码，准确填充相关参数，进行埋点上报

# 三、使用示例

# 1. PV

游戏 PV 上报，标识游戏页面显示，建议在 onShow 中调用

LXAnalytics('pageView', {'custom': { 'inner_source': xxx }}, {}, 'c_game_4zk2nelx');

字段名称	参数类型	参数名称	说明	是否必报
inner_source	string	站内入口	可以通过 getLaunchOptionsSync API 获取	是

# 2. PD

游戏 PD 上报，标识游戏页面关闭，建议在 onHide 中调用

LXAnalytics('pageDisappear', {}, 'c_game_4zk2nelx');

# 3. MV（创角成功）

每次创角动作结束之后进行一次上报

注：该事件埋点必须在 PV 之后，PD 之前上报

LXAnalytics(
  'moduleView', 
  'b_game_tg6t1x6t_mv', 
  {
    'page_id': 'c_game_4zk2nelx',
    'inner_source': '',
    'game_id': ,
    'create_time': '',
    'level': ,
    'role_id': '',
    'service_id': ''
  }, 
  { 
    cid: 'c_game_4zk2nelx' 
  })

字段名称	参数类型	参数名称	说明	是否必报
page_id	string	页面id	cid，固定上报 c_game_4zk2nelx	是
inner_source	string	站内入口	可以通过 getLaunchOptionsSync API 获取	是
game_id	string	appId	即游戏 ID，mgcxxxxxx	是
create_time	string	创建时间	时间戳，eg: Date.now()	是
level	string	等级	查看等级时，level正常上报，点击其他button，level上报-999	否，角色无等级可以不报
service_id	string	服务区id	服务区 id	否，角色无服务区可以不报
role_id	string	角色 id		是

# 4. MV（等级变更）

每次切换服务区时，上报当前服务区的角色等级信息；退出游戏时，上报当前服务区的角色等级信息（PD 上报之前）

注：该事件埋点必须在 PV 之后，PD 之前上报

LXAnalytics(
  'moduleView', 
  'b_game_fa7pxwns_mv', 
  {
    'page_id': 'c_game_4zk2nelx',
    'inner_source': '',
    'game_id': ,
    'level': ,
    'role_id': ''
  }, 
  { 
    cid: 'c_game_4zk2nelx' 
  })

字段名称	参数类型	参数名称	说明	是否必报
inner_source	string	站内入口	可以通过 getLaunchOptionsSync API 获取	是
game_id	string	game_id	游戏 ID	是
level	string	等级	查看等级时，level正常上报，点击其他button，level上报-999	是
page_id	string	页面id	cid，固定上报 c_game_4zk2nelx	是
role_id	string	角色 id		是

# 五、其他监控上报

# 登录成功率

const { reportPerformance } = mt.mta;

// 登录成功
reportPerformance('game.login', 1, { success: 1})
// 登录失败
reportPerformance('game.login', 1)

# 首屏渲染

const { reportPerformance } = mt.mta;

reportPerformance('game.firstscreen',100 /* 100ms*/)

# pike 网络成功率

const { addRequest } = mt.mta;

const reqOption = {
  reqType: 'pike',       // 请求类型    pike | http
ajaxUrl: 'xxx',      // pike 请求类型，用于标识请求
httpStatus: 200,    // 如果请求成功，统一传 200 如果请求失败 统一传 400 后续优化表述
duration: 300,     // 耗时 
};
addRequest(reqOption);

# fmp 渲染耗时

const { reportPerformance } = mt.mta;

reportPerformance(
'game.fmp', 
300   // ms
)

# 登录页退出

const { reportPerformance } = mt.mta;

reportPerformance('game.loginExit', 1)

# 异常弹窗

const { reportPerformance } = mt.mta;

reportPerformance('game.errorDialog', 1, {
  errorReason: 'xxx'   // 异常弹窗原因
})

# 六、常见问题和说明

inner_source 的获取方式

mt.getLaunchOptionsSync().query.inner_source

PV、PD、MV、MC 埋点中的 cid: 'c_game_4zk2nelx' 参数为固定值，直接使用即可
按照示例接入即可，上报结果可以联系对接人员查看