跳到正文
Boardmix博思白板 logo boardmix 白板
产品
AI工具
企业服务

埋点验收通过,意味着能用这批数据回答原定业务问题:该触发时触发、不该触发时不触发,属性准确,重复和延迟按约定处理,最终统计与业务记录能对上。开发工具里看到一条请求,最多说明请求发出了,不能单独证明订单转化率已经可信。

验收前先画出“用户动作—业务结果—事件—入库”的对应关系。用流程图梳理业务分支时,将点击付款、发起请求、支付确认和订单状态更新画成不同节点,就能发现哪些事件测的是意图,哪些测的是结果。以下以一次商品订购为例,给出可直接填写的事件表、测试用例和对账方法。

支付漏斗的埋点怎么验收?事件契约、异常用例与订单对账

先定分析问题,再决定要验收哪些事件

假设团队要回答:“到达结算页的订单,为什么没有支付成功?”需要至少识别结算开始、支付尝试和支付结果,另外保留商品、金额、渠道、订单及尝试次数等必要上下文。不要从“页面里有几个按钮”反推事件清单:按钮多不代表数据完整,关键结果也可能发生在服务端。

漏斗单位先选订单还是用户。一个用户可能同时提交两笔订单,同一订单可能付款失败后重试。用用户数做分母、支付事件次数做分子,会算出没有业务含义的比例。本例要求结算页加载成功时已生成订单ID,按订单ID分析转化,按支付尝试ID排查失败;二者分开,避免把合法重试误删,也避免把重复回调计成两笔支付。如果系统到提交时才生成订单ID,应改用结算实例ID追踪前段并保存其与订单的对应关系,不能把未生成订单的结算直接排除。

Twilio Segment 的 Tracking Plan 文档将事件与属性作为数据规格管理,并支持对实际到达的数据进行规则校验。无论采用哪种采集系统,都应先让产品、开发、测试和分析对同一份事件定义达成一致,再进入联调。

写出能判对错的事件契约,不只列英文名称

事件触发时机与来源关键属性不应触发的情况
checkout_started结算内容加载成功且可交互;客户端checkout_id、order_id(本例必填)、商品数、币种、应付金额页面加载失败;只有预加载而未展示
payment_attempted通过校验并接受一次支付请求;约定由服务端记录order_id、payment_attempt_id、支付渠道、应付金额按钮校验未通过;快速重复点击被拦截
payment_succeeded订单服务确认有效支付成功;服务端order_id、payment_attempt_id、交易标识、实付金额、币种只点击付款;前端跳回成功页但结果尚未确认
payment_failed一次支付尝试被明确判定失败;服务端order_id、payment_attempt_id、约定枚举的失败原因网络等待中、结果未知,或没有明确失败结果

事件名只是本案例的命名约定,接入具体平台时应遵循平台支持的名称和字段。金额需要写清单位:采用“分”的整数就不能把19.90作为同一字段值;不同币种不能默认具有相同最小单位。日期需记录时区或统一的时间表示,并区分业务发生时间与采集接收时间。

每个属性再标记类型、是否必填、允许值和空值处理。例如 payment_attempt_id 为必填字符串,缺失时不能假装用 user_id 顶替;失败原因用固定枚举,同时保留受控的诊断记录,避免将错误堆栈、姓名、手机号或支付敏感信息直接放进分析属性。

去重规则也属于契约。一次业务事件因网络重发,应使用稳定的事件标识去重;同一订单第二次合法支付尝试,必须有新的尝试标识。成功结果可以再按业务交易标识或订单约定核对唯一性。不能简单将“同一用户一分钟内的事件”全部合并,这会误删连续操作。

正常、重复、失败与结果未知,要分开测

测试用例至少包含操作、预期事件、次数与关键属性。下面的数量指经过约定去重后的业务事件;底层传输可能重试,传输次数应另查,不能与业务次数混为一谈。

场景与操作预期结果重点核对
完成一次正常支付1次支付尝试、1次成功;同一订单和尝试关联金额、币种、渠道与业务订单一致
连续快速点击付款按产品防重复规则只接受1次请求,不凭点击次数增加尝试客户端操作与服务端接受结果能区分
第一次明确失败,用户再试并成功2次尝试、1次失败、1次成功同一订单、两个不同尝试ID;失败和成功各指向正确尝试
支付成功后刷新结果页不新增一笔支付成功业务事件页面浏览可以增加,支付结果不能重复
请求后断网,结果暂时未知不把等待超时直接记成确定失败;恢复后按真实结果处理补报时间、实际发生时间与原尝试关联
同一成功回调重复到达去重后成功记录仍为1条消息重试不会把一笔订单收入翻倍
未获相应采集授权按产品的隐私与同意配置处理,不能为测试强行绕过应采与不应采边界,业务记录和分析采集区别

如果产品允许匿名结算后登录,还需用专门用例验证身份关联:匿名访问和登录后的订单能否按既定规则连接,是否错误合并到其他账号。设备ID、用户ID和订单ID承担不同任务,不能选一个“看起来唯一”的字段替代全部标识。

从触发、接收到统计,沿同一订单核对

第一层看触发。执行用例时记录时间、测试账号、订单ID和应用版本。客户端事件在浏览器开发工具或应用调试日志中观察;本例的支付尝试与支付结果由服务端记录,应查看订单服务日志或事件发送记录,不能要求它们出现在浏览器网络请求中。逐项检查名称、类型、必填属性和次数。事件没有发送时,先查对应来源的触发条件、权限或同意状态,不必马上追查仓库。

第二层看接收。在采集平台的调试或原始事件入口找到同一订单,核对事件是否被接收、拒绝、去重或延迟。Google Analytics 的 DebugView可查看调试设备的事件与属性;它是诊断入口,具体仓库和报表仍须按所用链路另外验收。测试环境、生产环境和过滤规则也要写进记录。

第三层看统计。等到约定的数据到达时限后,检查明细、聚合结果和业务订单。此处的时限应依据本系统批处理与延迟设置确定,不凭经验固定写成“几分钟内”。同一条事件经过清洗后,金额是否换算正确、重复是否消除、时区是否改变日期归属,都要回到明细解释。

把这笔订单放到 Boardmix 画布中,按客户端、订单服务、采集系统和分析结果分成四列。结算加载成功先记录 checkout_started;用户提交付款且订单服务接受请求后,才记录 payment_attempted。打开结算页本身不会产生支付尝试。沿不同来源的事件连线核查,可以区分“没有发出”“没有接收”和“统计不对”。

支付订单从客户端和订单服务进入采集与分析,结果未知走等待核对旁支,业务订单按ID独立对账

图中成功路径必须经过支付确认,橙色旁支表示结果仍未知:此时等待核对,不记为确定失败,也不保证后来一定成功。若最终明确失败,则按前面的契约记录 payment_failed。同一订单保持 order_id 不变,第二次合法尝试使用新的 payment_attempt_id;右侧另用业务订单核对分析明细。画布用于约定链路与定位断点,触发、接收和落库证据仍需到对应系统逐项检查。

对账要解释差额,不能只比较两个总数

假设测试集有10笔应成功订单,业务系统确认10笔,分析明细却有12条 payment_succeeded。先按交易标识与订单ID检查,发现两条为重复回调;按既定规则去重后得到10笔,这才解释了差额。不能为了让总数相同随意删两条数据,也不能把12/10写成“转化率120%”。

反过来,分析侧只有9笔,应先找出缺失的那一个ID,再查它是否未触发、被拒绝、尚未到达,或被错误过滤。生产环境还会受到同意状态、拦截、跨端身份、退款以及观察窗口的影响,因此不要求所有业务订单无条件进入同一分析报表,但每类差异必须有定义和可复核原因。

验收记录可按“用例ID—订单ID—预期事件—触发证据—接收证据—统计结果—结论—缺陷编号”保存。核心支付事件缺失、重复导致金额错误、身份串号、敏感属性泄露属于应阻断的问题;非关键展示属性缺失可以在明确影响、负责人和修复期限后按团队发布规则处理。不能把所有失败都压成一个“基本通过”。

发布后保留版本边界,防止新旧数据混在一起

事件字段修改要有版本记录。尤其是移动应用,新旧版本可能同时运行;新增一个必填字段后,旧版事件不会自动获得该属性。写明事件定义、应用版本和兼容处理方式,让数据分析时能够分开识别。不要用修改后台字段名来掩盖旧客户端继续发送旧口径的问题。

上线后的首轮检查应覆盖真实发布版本,核对关键事件数量、缺失属性、重复比例和数据延迟,并与最近的业务变化一起解释。测试数据要能识别和排除,验收截图也要去除敏感信息。最终交付给分析人员的,应是一份带口径、边界和失败处理方式的数据契约,而不只是一张“抓包成功”的截图。

把想法整理成图,让讨论有据可依

用 Boardmix 梳理思路、绘制图表,与团队共同完善。

打开 Boardmix 白板 浏览模板