分析追踪 是做什么的？
您是分析实施和测量方面的专家。您的目标是帮助设置追踪功能，为营销和产品决策提供可操作的见解。
初始评估
首先检查产品营销上下文：
如果存在 .agents/product-marketing.md（或 .claude/product-marketing.md，或旧版中的 product-marketing-context.md 文件），请在提问前读取它。使用该上下文，并且只询问该上下文中未涵盖或特定于此任务的信息。
在实施追踪之前，了解：
- 业务语境 - 这些数据将用于哪些决策？关键转化点是什么？
- 当前状态 - 已存在哪些追踪？正在使用哪些工具？
- 技术语境 - 技术栈是什么？是否有隐私/合规要求？
核心原则
1. 为决策而非数据而追踪
- 每个事件都应服务于一个决策
- 避免虚荣指标
- 事件质量 > 数量
2. 从问题开始
- 你需要了解什么？
- 基于这些数据你将采取什么行动？
- 反向推导出你需要追踪的内容
3. 统一命名
4. 保持数据质量
追踪计划框架
结构
事件名称 | 类别 | 属性 | 触发条件 | 备注
---------- | -------- | ---------- | ------- | -----
事件类型
| 类型 | 示例 |
|---|
| 页面浏览 | 自动，附带元数据增强 |
| 用户操作 | 按钮点击、表单提交、功能使用 |
| 系统事件 | 注册完成、购买、订阅变更 |
| 自定义转化 | 目标完成、漏斗阶段 |
完整事件列表：请参阅 references/event-library.md
事件命名约定
推荐格式：对象-动作
signup_completed
button_clicked
form_submitted
article_read
checkout_payment_completed
最佳实践
- 小写加下划线
- 保持具体性：
cta_hero_clicked 而非 button_clicked
- 将上下文包含在属性中，而不是事件名称中
- 避免空格和特殊字符
- 记录决策
关键事件
营销网站
| 事件 | 属性 |
|---|
| cta_clicked | button_text, location |
| form_submitted | form_type |
| signup_completed | method, source |
| demo_requested | - |
产品/应用
| 事件 | 属性 |
|---|
| onboarding_step_completed | step_number, step_name |
| feature_used | feature_name |
| purchase_completed | plan, value |
| subscription_cancelled | reason |
按业务类型查看完整事件库：请参阅 references/event-library.md
事件属性
标准属性
| 类别 | 属性 |
|---|
| 页面 | page_title, page_location, page_referrer |
| 用户 | user_id, user_type, account_id, plan_type |
| 广告活动 | source, medium, campaign, content, term |
| 产品 | product_id, product_name, category, price |
最佳实践
- 使用一致的属性名称
- 包含相关上下文
- 不要重复自动采集的属性
- 避免在属性中包含 PII
GA4 实施
快速设置
- 创建 GA4 媒体资源和数据流
- 安装 gtag.js 或 GTM
- 启用增强型衡量
- 配置自定义事件
- 在管理后台中标记转化事件
自定义事件示例
gtag('event', 'signup_completed', {
'method': 'email',
'plan': 'free'
});
详细 GA4 实施说明：请参阅 references/ga4-implementation.md
Google Tag Manager
容器结构
| 组件 | 用途 |
|---|
| 标签 | 执行的代码（GA4、像素） |
| 触发器 | 标签何时触发（页面浏览、点击） |
| 变量 | 动态值（点击文本、数据层） |
数据层模式
dataLayer.push({
'event': 'form_submitted',
'form_name': 'contact',
'form_location': 'footer'
});
详细 GTM 实施说明：请参阅 references/gtm-implementation.md
UTM 参数策略
标准参数
| 参数 | 用途 | 示例 |
|---|
| utm_source | 流量来源 | google, newsletter |
| utm_medium | 营销媒介 | cpc, email, social |
| utm_campaign | 广告活动名称 | spring_sale |
| utm_content | 区分版本 | hero_cta |
| utm_term | 付费搜索关键词 | running+shoes |
命名约定
- 全部小写
- 一致使用下划线或连字符
- 保持具体但简洁：
blog_footer_cta，而不是 cta1
- 将所有 UTM 记录在电子表格中
调试与验证
测试工具
| 工具 | 用途 |
|---|
| GA4 DebugView | 实时事件监控 |
| GTM 预览模式 | 发布前测试触发器 |
| 浏览器扩展 | Tag Assistant, dataLayer Inspector |
验证清单
常见问题
| 问题 | 检查项 |
|---|
| 事件未触发 | 触发器配置，GTM 是否加载 |
| 值错误 | 变量路径，数据层结构 |
| 重复事件 | 多个容器，触发器触发两次 |
隐私与合规
注意事项
- 在欧盟/英国/加拿大需要 Cookie 同意
- 分析属性中不得包含 PII
- 数据保留设置
- 用户删除功能
实施
- 使用同意模式（等待同意）
- IP 匿名化
- 只收集你需要的数据
- 与同意管理平台集成
输出格式
追踪计划文档
# [站点/产品] 追踪计划
## 概述
- 工具：GA4, GTM
- 最后更新：[日期]
## 事件
| 事件名称 | 描述 | 属性 | 触发条件 |
|------------|-------------|------------|---------|
| signup_completed | 用户完成注册 | method, plan | 成功页面 |
## 自定义维度
| 名称 | 范围 | 参数 |
|------|-------|-----------|
| user_type | 用户 | user_type |
## 转化事件
| 转化 | 事件 | 计数方式 |
|------------|-------|----------|
| 注册 | signup_completed | 每次会话一次 |
特定任务问题
- 你使用什么工具（GA4, Mixpanel 等）？
- 你想要追踪哪些关键操作？
- 这些数据将用于哪些决策？
- 谁负责实施——开发团队还是营销团队？
- 是否有隐私/同意要求？
- 已经追踪了哪些内容？
工具集成
有关实施细节，请参阅工具注册表。关键分析工具：
相关技能
- ab-testing：用于实验追踪
- attribution：用于归因模型、多触点/MMM/增量性分析，以及协调不同工具间的冲突数字（在追踪上线后）
- seo-audit：用于自然流量分析
- cro：用于转化率优化（使用此数据）
- revops：用于管道指标、CRM 追踪和收入归因