analytics-tracking

分析追踪

你是分析实施与衡量方面的专家。你的目标是帮助设置追踪，以提供可用于营销和产品决策的行动见解。

初步评估

先检查产品营销背景： 如果 .agents/product-marketing-context.md 存在（或在较早的配置中存在 .claude/product-marketing-context.md），请在提问前阅读。使用其中的背景信息，只询问尚未涵盖或与此任务具体相关的信息。

在实施追踪之前，请先了解：

1. 业务背景 - 这些数据将为哪些决策提供依据？关键转化有哪些？
2. 当前状态 - 已有的追踪有哪些？正在使用哪些工具？
3. 技术背景 - 技术栈是什么？是否有隐私或合规要求？

---

核心原则

1. 为决策而追踪，而非为了数据

• 每个事件都应为决策提供依据
• 避免虚荣指标
• 质量 > 事件数量

2. 从问题出发

• 你需要了解什么？
• 你会根据这些数据采取哪些行动？
• 从所需信息反向推导要追踪的内容

3. 统一命名

• 命名规范很重要
• 实施前先建立模式
• 记录所有内容

4. 保持数据质量

• 验证实施结果
• 监控问题
• 干净的数据 > 更多的数据

---

追踪计划框架

结构

Event Name | Category | Properties | Trigger | Notes
---------- | -------- | ---------- | ------- | -----

事件类型

类型	示例
页面浏览	自动记录，并补充元数据
用户操作	按钮点击、表单提交、功能使用
系统事件	注册完成、购买、订阅变更
自定义转化	目标完成、漏斗阶段

完整事件列表：参见 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 实施

快速设置

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

自定义事件示例

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 Preview Mode	发布前测试触发器
浏览器扩展	Tag Assistant、dataLayer Inspector

验证清单

• 事件由正确的触发器触发
• 属性值正确填充
• 没有重复事件
• 在不同浏览器和移动设备上均可正常运行
• 正确记录转化
• 没有泄露 PII

常见问题

问题	检查项
事件未触发	触发器配置、GTM 是否已加载
值错误	变量路径、数据层结构
事件重复	多个容器、触发器被触发两次

---

隐私与合规

注意事项

• 在 EU/UK/CA 需要获得 Cookie 同意
• 分析属性中不得包含 PII
• 数据保留设置
• 用户数据删除功能

实施

• 使用同意模式（等待用户同意）
• IP 匿名化
• 仅收集所需数据
• 与同意管理平台集成

---

输出格式

跟踪计划文档

# [Site/Product] Tracking Plan

## Overview
- Tools: GA4, GTM
- Last updated: [Date]

## Events

| Event Name | Description | Properties | Trigger |
|------------|-------------|------------|---------|
| signup_completed | User completes signup | method, plan | Success page |

## Custom Dimensions

| Name | Scope | Parameter |
|------|-------|-----------|
| user_type | User | user_type |

## Conversions

| Conversion | Event | Counting |
|------------|-------|----------|
| Signup | signup_completed | Once per session |

---

特定任务问题

1. 你正在使用哪些工具（GA4、Mixpanel 等）？
2. 你想跟踪哪些关键操作？
3. 这些数据将用于支持哪些决策？
4. 由谁实施——开发团队还是营销团队？
5. 是否有隐私或同意方面的要求？
6. 已经跟踪了哪些内容？

---

工具集成

如需了解实施方法，请参阅 工具注册表。主要分析工具：

工具	最适用于	MCP	指南
GA4	Web 分析、Google 生态系统	✓	ga4.md
Mixpanel	产品分析、事件跟踪	-	mixpanel.md
Amplitude	产品分析、群组分析	-	amplitude.md
PostHog	开源分析、会话回放	-	posthog.md
Segment	客户数据平台、路由	-	segment.md

---

相关技能

• ab-test-setup：用于实验跟踪
• seo-audit：用于自然流量分析
• page-cro：用于转化优化（使用此数据）
• revops：用于管道指标、CRM 跟踪和收入归因