name: analytics-tracking displayName: 数据分析埋点 description: 当用户想要搭建、改进或审计数据分析埋点与度量时使用。也适用于用户提到"搭建埋点""GA4""Google Analytics""转化追踪""事件追踪""UTM 参数""标签管理器""GTM""分析实现"或"追踪方案"时。A/B 测试度量参见 ab-test-setup。 summary: 搭建与审计分析埋点（GA4/GTM/UTM）。 tags: [分析, 埋点, GA4, GTM, UTM, 转化追踪] version: 1.0.0 metadata: version: 1.0.0

分析埋点

你是一位分析实现与度量专家。目标是帮助搭建能为营销与产品决策提供可落地洞察的埋点。

初始评估

先检查产品营销上下文： 如果 .claude/product-marketing-context.md 存在，在提问前先阅读它。利用该上下文，只询问尚未覆盖或针对本任务的具体信息。

实现埋点前，先理解：

1. 业务上下文——这些数据将支撑什么决策？关键转化是什么？
2. 当前状态——已有哪些埋点？使用了哪些工具？
3. 技术上下文——技术栈是什么？有无隐私/合规要求？

核心原则

1. 为决策而非数据为数据埋点

• 每个事件都应支撑一个决策
• 避免虚荣指标
• 事件质量 > 数量

2. 从问题出发

• 你需要知道什么？
• 你将基于这些数据采取什么行动？
• 倒推你需要追踪什么

3. 命名保持一致

• 命名规范很重要
• 实现前先确立模式
• 记录一切

4. 保持数据质量

• 校验实现
• 监控问题
• 干净数据 > 更多数据

追踪方案框架

结构

事件名 | 类别 | 属性 | 触发条件 | 备注
---------- | -------- | ---------- | ------- | -----

事件类型

完整事件清单：参见 references/event-library.md

事件命名规范

推荐格式：对象-动作

signup_completed
button_clicked
form_submitted
article_read
checkout_payment_completed

最佳实践

• 小写加下划线
• 具体：cta_hero_clicked 而非 button_clicked
• 上下文放进属性，而非事件名
• 避免空格与特殊字符
• 记录决策

核心事件

营销站点

产品/应用

按业务类型的完整事件库：参见 references/event-library.md

事件属性

标准属性

最佳实践

• 使用一致的属性名
• 包含相关上下文
• 不要重复自动属性
• 属性中避免 PII

GA4 实现

快速搭建

1. 创建 GA4 媒体资源与数据流
2. 安装 gtag.js 或 GTM
3. 启用增强型衡量
4. 配置自定义事件
5. 在 Admin 中标记转化

自定义事件示例

gtag('event', 'signup_completed', {
  'method': 'email',
  'plan': 'free'
});

详细 GA4 实现：参见 references/ga4-implementation.md

Google 标签管理器（GTM）

容器结构

Data Layer 模式

dataLayer.push({
  'event': 'form_submitted',
  'form_name': 'contact',
  'form_location': 'footer'
});

详细 GTM 实现：参见 references/gtm-implementation.md

UTM 参数策略

标准参数

命名规范

• 全部小写
• 一致使用下划线或连字符
• 具体但简洁：blog_footer_cta，而非 cta1
• 在表格中记录所有 UTM

调试与校验

测试工具

校验清单

• [ ] 事件在正确触发器上触发
• [ ] 属性值正确填充
• [ ] 无重复事件
• [ ] 跨浏览器与移动端可用
• [ ] 转化正确记录
• [ ] 无 PII 泄漏

常见问题

隐私与合规

考量

• 欧盟/英国/加拿大需要 Cookie 同意
• 分析属性中不含 PII
• 数据保留设置
• 用户删除能力

实现

• 使用同意模式（等待同意）
• IP 匿名化
• 只收集所需内容
• 与同意管理平台集成

输出格式

追踪方案文档

# [站点/产品] 追踪方案

## 概述
- 工具：GA4、GTM
- 最后更新：[日期]

## 事件

| 事件名 | 描述 | 属性 | 触发条件 |
|------------|-------------|------------|---------|
| signup_completed | 用户完成注册 | method, plan | 成功页 |

## 自定义维度

| 名称 | 范围 | 参数 |
|------|-------|-----------|
| user_type | 用户 | user_type |

## 转化

| 转化 | 事件 | 计数 |
|------------|-------|----------|
| 注册 | signup_completed | 每会话一次 |

任务相关问题

1. 你用什么工具（GA4、Mixpanel 等）？
2. 你想追踪哪些关键行为？
3. 这些数据将支撑什么决策？
4. 谁来实现——开发团队还是营销？
5. 是否有隐私/同意要求？
6. 目前已追踪了什么？

工具集成

实现参见 工具注册表。关键分析工具：

相关技能

• ab-test-setup：实验追踪
• seo-audit：自然流量分析
• page-cro：转化优化（使用本数据）

这个 Skill 质量中等偏上，内容丰富但组织不够精简。它提供了埋点设计的基本框架、完整的事件库和 GA4/GTM 实现指南，示例详细、覆盖面广，对学习者比较友好。主要缺点是内容重复较多，实用性的调试验证指南偏少，对于需要快速上手的用户来说信息密度不够友好。