埋点管理

1. 概述

埋点管理为数据接入测试和日常使用过程中提供的数据管理功能，包括埋点信息、上报明细 2 个子模块，各子模块功能说明如下：

埋点信息页面可查看最近 7 日项目内数据接收情况，快速了解埋点上报整体情况，以及错误上报详情与抽样示例。

上报明细页面可查看「监测开关」开启期间近 1000 条的埋点上报明细，实时查看埋点上报日志，帮助用户快速测试、验收埋点开发。

2. 适用角色与用途

角色	用途
埋点设计人员（数据产品经理/分析师）	测试与验收新埋点需求开发的上报结果，日常了解埋点整体运行情况，及时发现埋点错误
埋点开发人员（前端开发/客户端开发/测试工程师）	实时查看埋点上报日志，测试埋点效果，快速定位埋点开发环节中的错误（建议在测试项目中启用）

3. 埋点信息

埋点信息由「埋点信息主页」、「错误详情页」2 部分构成。

埋点信息主页

错误详情页

3.1. 埋点信息主页

埋点信息支持查看最近 7 日项目内数据接收情况。

埋点信息主页由查询设置、区间数据、数据详情区域构成。

3.1.1. 查询设置

查询时间筛选：查询时间指数据的接收时间。支持自定义查看最近 7 日任一时间段的数据接收情况，默认统计今日的数据。

属性名、显示名搜索：根据关键词对属性名、显示名进行过滤展示。

3.1.2. 区间数据

展示所筛选时间段内所有数据的已接收、已入库、错误入库和入库失败数。

3.1.3. 数据详情

数据名称：事件的埋点上报为相应的事件名，设置用户属性的埋点上报为「用户属性」，无法识别为以上两类的则为「未知数据」；

显示名：数据名称对应的显示名；

已接收：系统接收的数据；

已入库：包括正确入库和错误入库数据；

错误入库：包含如事件属性名不合法、属性类型不合法等属性级别错误的数据，该类数据可正常入库，错误属性置空；

入库失败：因数据格式不合法、数据名不合法导致无法入库的数据。

错误详情：点击进入该数据的错误详情页，查看按照错误原因展示的错误详情。

3.2. 错误详情页

数据详情页展示各事件或用户属性下的错误入库和入库失败数据，错误信息按照错误原因展示。

错误详情页由查询设置、区间数据、数据详情区域构成。

3.2.1. 数据详情

错误条数：指含有该错误原因的数据条数。

错误类型、处理结果：指该错误的所属错误类型与 TapDB 对其处理的结果，便于用户对具体错误原因进行筛选。

查看抽样：查看符合该错误原因的上报数据的详细内容，每条上报数据均可选择格式化查看与一键复制。

3.2.2. 错误条数的计算原理

「错误条数」是对触发该错误原因的上报数据进行计数得到的结果，而埋点管理中的「错误原因」，是发生在「属性」层面的。

当仅上报 1 条某事件的日志时，其中字段 1 属性名不合法，字段 2 属性类型不合法，则该日志会同时触发 2 个错误原因，分别在两类错误原因下计算错误条数，因而数据详情汇总的错误条数的加和存在大于错误日志条数的可能。

4. 上报明细

上报明细展示最近 1000 条「监测开关」开启期间的上报日志明细，并展示其入库的处理结果。

「监测开关」开启时，系统接收的埋点日志将实时展示在上报明细中，开启时长达到 1 小时，则自动关闭，不再对数据进行实时展示，任何时候重新开启开关都将重置 1 小时的时间进度。建议在测试、验收埋点开发前，手动开启「监测开关」。

点击刷新按钮，可刷新页面获取最新数据。

每行上报日志明细都可进行格式化查看、复制操作。

5. 使用埋点管理

5.1. 及时发现埋点错误

使用埋点信息页面，掌握埋点整体运行情况，当出现未知数据，或部分数据错误入库、入库失败时，可在错误详情页定位错误，防止数据资产流失。

5.2. 使用上报日志对埋点需求进行测试、验收

在埋点开发人员完成开发后，埋点设计人员可模拟用户在游戏中的各类点击行为，而后在「上报日志」中查看实时上报日志，检查上报时机与日志明细是否符合埋点设计方案，从而对埋点需求进行测试、验收。