第3章 埋点类型与触发时机：曝光埋点、点击埋点、停留时长埋点、自定义事件埋点的选择标准

3.1 适用场景

四种埋点类型对应不同的用户行为阶段和数据诉求。选择错误将导致数据失真或资源浪费。下表从 行为阶段、典型场景、数据产出 三个维度对齐选择依据。

3.2 前置条件

在进入埋点类型选择决策前，团队需完成以下准备工作：

1. PRD 与交互稿已评审通过 —— 明确页面结构、元素状态（默认/加载/空态/异常态）、用户操作路径。
2. 核心指标已定义 —— 确定产品阶段目标（如：DAU、CTR、转化率、留存率），拆解为可量化的事件指标。
3. 数据采集协议已确定 —— 统一事件命名规范（例如：page_exposure / btn_click / video_duration），避免名称歧义。
4. 技术可行性评估完成 —— 确认前端/客户端是否具备 IntersectionObserver、TimeTracker 等底层能力，以及服务端日志采集通道是否就绪。
5. 埋点管理系统已就绪 —— 能够登记、同步、版本管理埋点定义，支持后续的数据校验和异常监控。

3.3 操作步骤

按以下 5 步决策法 完成埋点类型选择，每一步对应一个输入输出检查点。

// ========== 曝光埋点 - 基于 IntersectionObserver ==========
const observer = new IntersectionObserver(
    (entries) => {
        entries.forEach(entry => {
            if (entry.isIntersecting && entry.intersectionRatio >= 0.5) {
                // 元素在视口中且可见比例 ≥ 50% 时触发上报
                trackEvent('card_exposure', {
                    elementId: entry.target.dataset.id,
                    visibleRatio: entry.intersectionRatio,
                    timestamp: Date.now()
                });
                // 如需仅曝光一次，在此处 observer.unobserve(entry.target)
            }
        });
    },
    { threshold: [0.5] }  // 曝光阈值：可见比例 ≥ 50%
);
observer.observe(document.getElementById('card-123'));

// ========== 点击埋点 - 基于 addEventListener ==========
document.getElementById('btn-submit').addEventListener('click', function(e) {
    // 点击事件通常无需阈值，但需处理防抖
    trackEvent('btn_submit_click', {
        pageId: window.location.pathname,
        timestamp: Date.now()
    });
});

3.4 输入输出物

3.5 责任边界

四种埋点类型的选择与实施涉及多角色协作，边界清晰是避免“埋点遗漏或重复”的关键。

3.6 记录材料

每次埋点类型选择决策必须记录到《埋点类型选择决策表》中，至少包含以下字段：

3.7 异常处理

埋点类型选择不当或实施偏差会导致以下典型异常，需按标准流程处理：

3.8 验收标准

完成埋点类型选择和实施后，按以下维度逐条验收，全部通过方可进入下一阶段：

• 类型匹配正确性： 随机抽取 20% 的埋点，对照“行为主体 → 触发时机 → 埋点类型”路径复核，错误率为 0%。
• 触发时机准确性：
  • 曝光埋点：元素在视口中且达到设定阈值（如 50%）时上报，漏报率 < 1%。
  • 点击埋点：每次用户点击均产生事件，重复上报率 < 0.5%（防抖有效）。
  • 停留时长埋点：手动计时与埋点上报时长的偏差 ≤ 200ms。
  • 自定义事件埋点：事件触发条件与业务逻辑一致，参数完整率 100%。
• 数据一致性： 客户端埋点数据与服务端日志在相同时间窗口内的同名事件数量偏差 ≤ 5%（网络延迟导致的差异上限）。
• 文档完整性： 《埋点类型选择决策表》和《埋点详细定义文档》已归档，包含版本号、决策人、时间戳，无缺失字段。
• 异常记录闭环： 所有异常处理流程已记录，并附有修复验证截图或日志，关闭率 100%。

第3章 · 埋点类型与触发时机 · 选择标准 · 完