来源：自如质量效能
作者：张茹

一、什么是埋点

数据埋点是数据采集的一种重要方式，主要用来记录和收集终端用户的操作行为，当用户的行为满足某种条件的时候，会自动触发记录和存储，然后这些数据会被收集并被传输到终端提供商。通过埋点收集到的信息，可以进行汇总分析，推动产品优化或指导运营。

二、埋点测试现状

我们在工作过程中一般遇到的都是手动埋点方式的客户端埋点：
即：产品经理在提出需求，将埋点需要上传的参数告知前端开发，开发明确需求后就会进行埋点。

这种埋点方式优点如下：

埋点方式简单灵活，埋点代码实现过程对开发来说也较为简单，不会占用太多时间。
可对埋点中需要上传信息的字段进行个性化选择，满足复杂业务场景。

手动埋点的缺点也是显而易见的：

埋点过多时，大量重复性操作较为枯燥且容易出错。
沟通成本较高。
容易发生遗漏。

正是因为有这些问题，我们在使用过程中经常会遇到一些困难：

1.在埋点管理上

同一个 APP 版本中，埋点需求分布于不同的需求文档，不好管理。
在每一次的迭代过程中，难以找到历史版本已经存在哪些埋点，容易有重复的需求。
当前需求的埋点如果有修改，如果沟通不及时，也容易发生遗漏。

2.在测试过程中

每次都会在功能测试后再进行埋点测试，埋点测试占用时间也比较多。
神策数据会有滞后的情况，不能及时验证触发埋点的正确性。

因此我们需要将埋点事件统一管理起来，并且能够提高埋点测试的效率和准确性，及早发现问题。

三、埋点测试工具整体设计

埋点工具分为两个部分：埋点信息管理配置平台、埋点测试工具。

配置平台：埋点信息的管理和维护，给客户端提供埋点信息。
埋点测试工具：对埋点信息进行校验，提供埋点日志、测试报告功能。
交互逻辑：

在埋点信息配置平台添加埋点事件和属性等信息。
配置平台提供后端接口，测试在埋点测试工具中开启埋点测试。
测试输入版本号，查询出此版本的所有埋点信息。
测试点击元素或浏览页面，触发埋点。
埋点工具根据已获取的埋点信息，进行简单的预期值校验。
校验结果显示在测试报告中。

四、埋点信息管理

将每个版本和需求中的埋点信息维护到埋点平台，以便埋点信息的管理。

1.设计思路

埋点信息管理系统主要功能：
提供埋点信息的录入功能。
展示并可查询某埋点的详细信息。
修改埋点信息

2.实现方式

2.1.数据库

直接选用 mysql 数据库。分为埋点表和埋点属性表两个表。目前这两个表可以满足我们根据版本需求来管理埋点事件和属性的需求。

表结构如下：

埋点事件表：

CREATE TABLE t_event_tracking (
id bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键id',
event_version varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '事件版本号',
event_name varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '事件英文名',
event_description varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL COMMENT '事件中文名',
status int(2) NOT NULL COMMENT '状态，0有效，1删除',
is_delete int(2) NOT NULL COMMENT '是否删除，0不删除，1删除',
create_user varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL COMMENT '创建人',
modify_user varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL COMMENT '修改人',
create_time datetime(0) NULL DEFAULT NULL COMMENT '创建时间',
modify_time datetime(0) NULL DEFAULT NULL COMMENT '修改时间',
PRIMARY KEY (id) USING BTREE,
INDEX IDX_EVENTVERSION(event_version) USING BTREE,
INDEX IDX_EVENTNAME(event_name) USING BTREE
)

埋点属性表

CREATE TABLE t_event_attribute (
id bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键id',
event_name varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '事件英文名',
attribute_name varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL COMMENT '属性英文变量',
attribute_value varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '属性值',
attribute_description varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL COMMENT '属性名称描述',
status int(2) NOT NULL COMMENT '状态:0有效，1删除',
create_user varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL COMMENT '创建人',
modify_user varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL COMMENT '修改人',
create_time datetime(0) NULL DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP(0) COMMENT '创建时间',
modify_time datetime(0) NULL DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP(0) COMMENT '修改时间',
PRIMARY KEY (id) USING BTREE,
INDEX IDX_EVENTNAME(event_name) USING BTREE
)

2.2 后端代码实现

（1）框架选择：springboot 框架
（2）实现方式：

在 pom.xml 文件中导入 springboot,mybatis-plus 等需要的包。

连接数据库：用 mybatis-plus 方式连接数据库，在 application.yaml 中配置数据库链接

与数据库对应的实体类 TEventTracking
DAO 层 TEventTrackingMapper。注解引用数据源，继承了 mybatis-plus 的 BaseMapper 类，简单的单表操作可以直接调用 base 类中的方法，不需要自己再去实现。
DAO 层 TEventTrackingMapper.xml。简单的单表操作可以不再写 sql。
service 层的接口 IEventTrackingService，继承了 mybatisplus 的接口，单表操作可以直接调用父类的接口，如果有其他业务逻辑的操作，可在接口中新增。
service 层的实现类 EventTrackingServiceImpl。同样继承了 mybatisplus 的实现类，并实现 IEventTrackingService 接口中自定义的方法。
controller 层 EventTrackingController。对外暴露接口，如：api/jf/tracking/event/add
启动服务，后端就可以提供服务了。