在线调试

一、为什么需要『在线调试』

开发者集成SDK的过程中,需要进行一系列的测试,以确认SDK的集成情况。但往往在调试过程中,会因为无法及时地看到前端报表的数据变化,甚至不确认数据是否发送成功等原因,从而对SDK中对于事件或页面的配置是否成功产生疑虑。只得继续耐心等待服务器反馈,或重复检查埋点。

为了解决这一问题,提高开发者集成SDK的效率和成功率,我们针对性的推出了『在线调试』功能。

二、『在线调试』包含哪些功能

『在线调试』是指: 在完成测试机与测试APP的注册绑定后,将需要测试的APP安装到测试设备上,并完成一些列有目的性的APP操作,随后能马上在『在线调试』功能的『调试数据』报表中,查看到刚刚完成的一系列操作的详情日志,包含具体的事件和页面的点击情况,以此来确认SDK的整体集成状态。

为实现上述操作,『在线调试』为开发者提供了两个新的功能

  • 在『测试设备』报告中,对测试设备进行管理,包括新增、删除等;
  • 在『调试数据』报告中,查看近24小时内测试设备发回的测试数据;

三、『在线调试』的优势

  • 秒级响应。在测试设备完成APP操作后,即刻能在『调试数据』中看到测试数据,秒级响应,无延迟。
  • 日志详尽。每一份日志的详尽数据按照操作时间流,展示被点击事件和页面的详细情况,以确保能与操作流匹配上,验证每一个控件或页面的埋点是否成功。
  • 数据无污染。绑定测试设备后才可进行操作。测试设备产生的对应数据单独存储,不进入正常用户的数据报表中,确保数据不被污染。

四、如何使用『在线调试』

1. 在线调试的入口

1.1 常规入口:在左侧导航栏新增『在线调试』tab,如图所示:

常规入口

1.2 新增APP页面的最后一步,点击『测试集成效果』可进入该功能,如图:

新增app入口

2. 在线调试的使用

2.1 整体使用流程与注意点

整体流程

1)确保使用包含在线调试功能的最新版的SDK,下载前往:https://mtj.baidu.com/web/sdk/index

2)确保在测试APP前,先将测试设备与对应APP进行绑定,否则产生数据无法在『调试数据』模块中看到

3)确保完成操作后,按照常规测试发送数据,即:完全关闭APP,而后再次启动APP,即完成数据发送

4)确保在3)之后,进入『调试数据』模块,或打开『实时更新』按钮,即可看到发送给过来的日志数据了。

2.2 测试设备的绑定

2.2.1 入口:在『测试设备』页,点击“添加设备”进入到设备绑定页面

添加设备入口

2.2.2 生成设备专用设备ID

IOS和安卓分别参考如下方法(详见添加设备的页面),获取设备专业ID,并填入“设备ID”一栏。请注意,同一个设备可以与多个APP绑定,故每次生成的设备ID是与APP相关的不同编号,不可重复使用

设备绑定说明

2.2.3 同一个APP最多允许绑定20个测试设备;而同一个测试设备允许与任意多个APP绑定。

2.3 查看调试数据(秒级更新数据)

调试数据

2.3.1图示①:显示目前收到的日志的摘要信息。每一条测试日志为用户一次启动的完成操作信息。且只展现24小时内的测试数据。

2.3.2图示②与③:点击摘要信息左侧『加号』展开日志详情,区域②为设备相关信息;区域③为该次启动的详细事件和页面信息流

2.3.3图示③中,支持对已配置的事件和页面直接修改或添加备注名;支持直接配置在前端未配置的事件。

2.3.4 图示④:打开实时更新,每隔10s自动更新一次最新的数据。

2.3.5 如使用模拟测试系统,请控制每台设备对APP测试频次,每台设备5分钟内最大接受150条日志数据,超出部分不再展示。