Debug 和校验
SDK集成和代码实施后,我们当然需要对数据的正确性和是否成功上传进行校验。
校验工作分为三步完成
即时校验
GrowingIO 即时校验工具有日志输出。Android 和 iOS APP 同时也支持 Mobile Debugger、GioKit。
即时校验可以确保SDK采集数据的正确性,不能确保数据已上报到服务端数据库,数据未上报到服务端数据库排查建议。
查询验证
在平台中,平台管理--->客户数据平台--->数据校验--->事件实时查询功能,输入访问用户ID/登录用户ID 点击查询用户所有事件数据(用户属性事件除外)。
分析校验
在平台中,点击项目--->分析模型--->事件分析功能,选择需要分析的指标,添加指标和属性拆解,切换时间范围,切换数据展示样式,查看采集数据展示效果。
校验工具说明和应用场景推荐
工具/方法 | 依赖 | 功能简介 | 应用场景推荐 |
---|---|---|---|
日志输出 | 开启日志输出功能,研发开工具 | 可以查看所有采集事件日志数据 | 研发开发和排查问题 |
Mobile Debugger | 手机与电脑端在同一局域网,仅APP可用 | 可查看所有采集事件数据 | 研发、分析师数据校验 |
GioKit | 需添加GIOKit,仅 APP Debug包可用 | 可查所有采集事件数据和上报结果 | 研发、分析师数据校验 |
查询验证 | 平台中有对应功能的使用权限 | 查询除用户属性事件外的其他事件数据 | 分析师校验排查问题 |
分析校验 | 平台中有对应功能的使用权限 | 查看采集数据展示效果 | 分析师看板分析问题 |
校验时需关注字段和说明
GrowingIO SDK 支持以下事件类型的数据上报。下面将列举校验时需要关注的字段数据,其他字段数据请参考测量协议。对于埋点事件和用户属性事件,还需要关注事件的触发时机、attributes中的key和value 是否与埋点方案规划一致。
事件类型 | 事件类型标识 | 关注字段及说明 |
---|---|---|
访问事件 | VISIT | eventType:事件类型 访问事件 VISIT appVersion:应用的版本号 dataSourceId:设置的dataSourceId deviceId:访问用户ID 标识一台设备 domain: 包名或域名 platform: 应用平台类型 platformVersion:操作系统版本号 sdkVersion:GIO SDK 版本号 sessionId:访问SessionID 标识一次访问 urlScheme:设置的 URL Scheme userId:登录用户ID |
页面浏览事件 | PAGE | eventType:事件类型 页面浏览事件为 PAGE title: 页面标题 可能有的页面没有 path:页面路径 SDK 会为每个页面按页面层次生成 referralPage: 来源页面,一般为上一个页面 query: url 中的查询参数 |
元素点击事件 | VIEW_CLICK | path:页面路径 SDK 会为每个页面按页面层次生成 textValue:元素文本内容 index:列表元素序号 xpath:元素在页面中的位置,按照元素间嵌套逻辑生成 |
输入框改变内容事件 | VIEW_CHANGE | path:页面路径 SDK 会为每个页面按页面层次生成 textValue:元素文本内容 index:列表元素序号 xpath:元素在页面中的位置,按照元素间嵌套逻辑生成 |
表单提交事件 | FORM_SUBMIT | path:页面路径 SDK 会为每个页面按页面层次生成 index:列表元素序号 xpath:元素在页面中的位置,按照元素间嵌套逻辑生成 |
埋点事件 | CUSTOM | eventType:事件类型 页面浏览事件为 CUSTOM eventName:埋点事件标识符,需与埋点方案保持一致 attributes:埋点事件 的事件属性;包含 事件属性标识符和值;key value 形式展示 |
用户属性事件 | LOGIN_USER_ATTRIBUTES | eventType: 事件类型 页面浏览事件为 LOGIN_USER_ATTRIBUTES attributes:登录用户属性 包括登录用户属性的 标识符和 对应的值 |
📄️ 日志输出调试和校验
GrowingIO 各SDK均支持日志输出模式,开启后可进行调试和校验。
📄️ Mobile Debugger
GrowingIO 的移动端的SDK支持 Mobile Debugger 工具,可进行调试和校验。