data-*属性不是埋点触发器，仅作静态数据容器；真正埋点需JS监听事件、用closest('[data-track]')安全获取元素、解析dataset并调用上报逻辑，否则无日志、无数据。
data-*属性不是埋点触发器，只负责存值
加了data-track="pay_success"不代表埋点就生效了。浏览器不会因为这个属性自动监听、采集或上报——它只是把字符串“pay_success”静态挂在 DOM 上。真正起作用的是你写的 JS 监听逻辑和上报调用。常见现象是：控制台能读到el.dataset.track，但用户点了没日志，根本原因是没配事件监听器，或者监听器没覆盖到动态插入的节点。
必须明确分离两个环节：元数据声明（HTML 里写data-track）和行为采集（JS 里监听 + 构造 payload + 调用trackSDK.send()）。混为一谈，后续漏报、错报、排查困难全是必然结果。
监听层必须用closest('[data-track]')，不能依赖event.target
按钮里套<i>、<span>、图片很常见。用户点图标时event.target是那个<i>，它没data-track，直接读event.target.dataset.track会返回undefined。
- 正确做法：用
event.target.closest('[data-track]')向上找最近的带该属性的祖先元素 - 必须判空：
if (!el) return，否则后续读dataset会报错 - 移动端优先监听
pointerdown，iOS/Android 主流 WebView 对click有延迟甚至不触发；touchstart易误触，不推荐作为主通道
data-*值全是字符串，别硬转类型
data-count="5"和data-active="true"写进 HTML 后，JS 里读出来分别是"5"和"true"，不是数字或布尔值。直接用于if (el.dataset.active)看似能过，但"false"也会被当成真值，逻辑就崩了。
立即学习“前端免费学习笔记（深入）”；
- 需要数字时显式转：
parseInt(el.dataset.count, 10)或Number(el.dataset.count) - 需要布尔时用严格比较：
el.dataset.active === 'true'，而不是== true或!!el.dataset.active -
data-track-params存 JSON 字符串，必须用JSON.parse()且加try/catch，字段名含连字符时dataset会转驼峰，但原始属性名仍是data-track-params，要用getAttribute('data-track-params')读取才准确
敏感字段绝不能塞进data-*，全局属性只能挂<html>或<body>
data-user-id="123456"、data-token="abc"这类字段明文暴露在 HTML 源码里，爬虫、插件、恶意用户都能直接拿到，安全红线。
另外，data-env="prod"写在<head>里完全无效——HTML 规范禁止，浏览器解析时直接丢弃，document.head.dataset.env永远是undefined。
- 全局上下文信息（环境、AB 分组、用户基础身份）必须挂到
<html>标签上，它是最早解析、最稳定、无动态替换风险的位置 - 组件内局部元数据（如商品 ID、模块位置）才用元素级
data-track、data-event-id - Vue/React 中
data-默认不透传，子组件要显式用v-bind="$attrs"或 spread operator 才能落到真实 DOM 上
真正卡住全链路监控落地的，从来不是 data-* 写得对不对，而是 JS 层有没有处理好 DOM 生命周期断裂、属性读取断裂、上报通道断裂这三类问题。一个closest()漏写、一个sendBeacon没 fallback、一个dataset当对象用，都足以让整条链路静默失效。
