data-*属性仅作静态语义锚点，不自动触发埋点；需JS监听+上报逻辑配合，且须用closest()安全获取、判空处理、避免getAttribute误用，SPA中易因框架过滤或hydration失效。
data-* 属性本身不触发任何埋点行为
加了 data-track-id="submit_btn" 的按钮，用户点十次也不会产生一条日志。浏览器不会因为这个属性自动监听、采集或上报——它只是把字符串静态挂在 DOM 上。真正起作用的是你写的 JS 监听逻辑和上报调用。常见错误现象包括：
控制台能读到 el.dataset.trackId，但点击后监控后台没数据；
多个相同 data-track-id 元素共存，JS 却只绑了一次事件监听器，结果部分点击漏报；
服务端渲染的 data-user-id="123" 在 React/Vue hydration 后被清空，后续采集拿到的是空字符串。
必须用 closest() 安全获取带 data-* 的目标元素
按钮里常嵌套 <i>、<span> 或图片，用户点图标时 event.target 是子元素，它通常没有 data-track-id。直接读 event.target.dataset.trackId 会返回 undefined。
正确做法是：
用 event.target.closest('[data-track-id]') 向上查找最近的带该属性的祖先元素；
必须判空：if (!el) return，否则后续读取 dataset 会抛错；
不要用 getAttribute('data-track-id') 替代 dataset.trackId：前者不自动转驼峰，且对 data-user-id 返回 "user-id" 而非 userId。
data-* 只存语义锚点，链路穿透靠运行时上下文补全
data-track-id 这类属性仅负责在 DOM 节点上锚定一次性的业务意图（比如“这个按钮代表结算”），它不携带时间戳、traceId、referrers 或用户会话信息。
要让行为链路可追踪，JS 必须在事件触发时主动：
从 window.__TRACE_CONTEXT 或 OpenTelemetry API 拿 traceId 和 spanId；
捕获 location.href、performance.now()、document.referrer 等动态字段；
把所有字段打包进 payload，用 navigator.sendBeacon() 上报；
注意：data-* 的值只是 payload 中的一个字段，不是链路主干——丢掉它，链路缺语义；只靠它，链路根本连不起来。
SPA 和框架场景下 data-* 容易失效的关键点
在真实项目中，data-* 的“静态锚点”特性在动态环境里极易断裂：
Vue/React 组件默认过滤非 prop 属性：<Button data-track-id="checkout"> 渲染后 DOM 根节点上可能根本没有该属性；
路由跳转后新页面未重新 hydrate：data-user-id 在 SSR 输出后被客户端激活逻辑覆盖，后续点击上报为空；
用户快速连续点击 + 页面跳转：sendBeacon() 请求还没发完就被浏览器终止，链路在客户端就断了——必须搭配 beforeunload 补漏，且 payload 要轻量（不超过 64KB）。
立即学习“前端免费学习笔记（深入）”；
