实时验证
建立实时验证连接
客户端

- 进入【埋点验证】模块,左侧导航确认应用,页面上选择要验证的操作系统-客户端。
- 使用客户端(手机)扫描二维码(微信、浏览器等可扫描二维码的功能都可以),在右上角选择在手机浏览器中打开,打开后点击手机端页面上的【启动实时检测】。
注意
请确保手机已安装App的正确版本(应用名称、App_name、App_id),且设置了正确的唤起Scheme,并在手机端已打开。
小程序

- 进入【埋点验证】模块,左侧导航确认应用,页面上选择要验证的操作系统-小程序。
- 扫描小程序码
- 该页面展示生成上传的小程序二维码,二维码属性中带有启动埋点验证的相关属性;
- 扫码进入小程序后,SDK根据埋点检测属性,启动实时检测的连接;
- 扫码成功后,自动进入埋点检测页面。
- 如果没有上传小程序二维码,可以根据相关属性说明生成并上传小程序码。

- 点击"上传小程序码"进入上传小程序码弹窗页面;根据提供的属性生成小程序码并上传,上传成功后,点击"完成",即上传小程序码完成。

- 如果多个用户都扫码且没有开始检测,则根据列出扫码的用户及相关信息(按扫码时间倒序排列),可以从中选择自己的手机进行扫码,成功后自动进入埋点检测页面

H5/PC网页

- 进入【埋点验证】模块,左侧导航确认应用,页面上选择要验证的操作系统-H5/PC网页,输入要测试的网页地址,点击【生成二维码】按钮。
- 如果是手机竖屏,可直接手机扫描二维码进入测试页面,扫描页面会自动跳转到到【datagovernor-埋点验证页面】。如果是网站横屏,可点击下方url后的打开,打开要测试的网站,然后电脑切回【datagovernor-埋点验证页面】。

- 在【埋点验证】页面,选择验证规则,然后点击【开始验证】按钮,最后触发网页埋点上报即可。

按需求验证
- 埋点设计方案在【需求管理】中录入评审完成,开发同学也对照着埋点方案开发完成后,为保证数据上线质量,建议测试同学在【埋点验证】进行对应的验证,保证埋点方案中的内容都有上报且数据类型和上报值等符合要求。
- 我们提供了两种验证规则来源,按需求和按筛选器,这两种本质上都是验证规则,然后用验证规则去校验客户端上报的埋点数据是否符合预期。
- 按需求就是按【需求管理】需求内录入的埋点、属性、属性类型、取值等内容。
- 按筛选器是指按“埋点管理”->“埋点检索”中的埋点信息进行验证
- 在实时验证界面验证规则中选择按需求验证,选中对应的需求,点击开始验证

- 这里举例说明一下:验证的埋点是:video_play_end。按需求验证就是指只按“埋点管理”中的需求内埋点的信息进行验证,需求内的埋点内容和验证结果如下:


- 按需求验证报错的系统规则如下:
- 需求内的埋点在本次校验中是否都已上报,否则报错
- 需求内的埋点设置的必传属性是否都上报,否则报错
- 属性上报类型是否和需求内定义的一致,否则报错
- 上报的属性值是否在设置的取值范围内,如果没设置取值,默认不校验
- 如果需求内有设置场景,校验场景是否符合预期,详情请看3.6场景管理
- 验证结果说明:因为需求内的埋点信息规定,access属性只允许4g,action_type只允许up,实际上报埋点中的属性与此不符,所以验证结果为异常
按照筛选器验证
- 这里举例说明一下按筛选器验证的规则:按筛选器是指按埋点检索列表中埋点的属性、属性类型、取值等内容。和需求的区别是,埋点列表中的埋点可能是根据3个需求迭代合并而来的,比如A需求对应a埋点有3个属性,B需求对应a埋点又新增了4个属性,则埋点列表该埋点共有7个属性需要验证。
- 在实时验证界面验证规则中选择按筛选器验证,选中对应的筛选器,点击开始验证,筛选器也可不选

- 这里举例说明一下:验证的埋点是:video_play_end。按筛选器验证就是指只按“埋点管理”中基本信息内的内容进行验证,埋点检索中的埋点内容和验证结果如下:


- 按筛选器验证报错的系统规则如下:
- 该埋点在埋点详情中的必传属性是否都上报,否则报错
- 属性上报类型是否和埋点详情中定义的一致
- 上报的属性值是否在设置的取值范围内,如果没设置取值,默认不校验
- 如果匹配到场景,校验场景下的属性和取值是否符合预期,详情请看3.6场景管理
- 验证结果说明:
- 因为埋点检索中的埋点信息规定,access属性允许4g、wifi,action_type属性允许down、up,实际上报埋点中的属性符合要求,所以验证结果为成功
高级功能
- 筛选条件:提供给用户对客户端上报的埋点数据进行过滤,让用户只关注自己关心的埋点。
- 事件名称:按照事件名称进行筛选,这里我们也支持按照正则表达式搜索。事件名称支持包含和不包含两种选项
- 事件属性:支持按照事件的属性进行筛选,选择多个属性是或的关系
- 只显示异常埋点:只过滤出校验结果异常的埋点
- **回填筛选条件:**当选择规则的时候,如果选择的是筛选器,则会把筛选器的数据回填到上述的条件选项上。如果选择的是需求,则会把需求内的事件回填到事件筛选框中
- **存为/另存为筛选器:**这里提供了将筛选条件快捷保存为筛选器的入口,方便用户将筛选条件保存下来后面重复使用。
- 如果你没有选择筛选器,则可以直接将筛选条件保存为筛选器。
- 如果你选择了筛选器,则可以选择更新或者另存为筛选器。
- 时间轴这里显示的是客户端上报的埋点,下面对时间轴上的信息做一些简单的解释
- 时间维度:默认是按时间维度展示
- 埋点维度:埋点维度方便用户查看某个埋点的上报情况
- **延迟时间:**鼠标浮动到时间上会显示出来。延迟时间=显示到埋点验证平台的时间-埋点上报到服务端时间
- **标亮param:**这个功能可以将属性以高亮的形式展示,适用于只关注确定的几个属性
- **复制:**只会复制事件名和params,并且params会以json的格式进行复制
- **完整复制;**会将客户端上报的原始日志原封不动的完全复制,当然params也就不会json格式化
- **暂停/继续:**点击“暂停”,客户端上报的埋点会直接丢弃。点击“继续”,客户端上报的埋点会继续推送到界面
- **清除埋点:**点击“清除埋点”,则会把当前所有的埋点都丢弃掉。比如app刚启动时候,会上报特别多的埋点,而这些埋点一般都不是要验证的埋点,那么就可以将这些埋点清除掉
- **保存报告:**点击“保存报告”,将此次上报的埋点进行保存,方便后续查看。点击“保存结果”后,在保存成功之前或者取消保存的过程中,客户端上报的埋点不会推送到前端也不会保存到此次结果中。
验证报告
- 验证结束后界面右上角有【存为报告】按钮,点击后可筛选自己想要保留的埋点明细,存为可再次查看的报告。

- 在埋点验证左侧菜单选择验证报告,可查看该项目保留过的所有验证报告,打开报告可以看到当时上报的明细。


验证筛选器
用户可以将经常要验证的埋点保存为验证筛选器,方便重复使用。筛选器中的条件选项可以参考实时验证中的条件选项,两者是一致的。