关于
当用户需要设置、改进或审计分析追踪和度量时使用。涵盖 GA4、转化追踪、事件追踪、UTM 参数、GTM、追踪计划和归因分析。
name: analytics description: 当用户想要设置、改进或审计分析追踪和测量时使用。也适用于用户提到"设置追踪"、"GA4"、"Google Analytics"、"转化追踪"、"事件追踪"、"UTM参数"、"标签管理器"、"GTM"、"分析实施"、"追踪计划"、"如何衡量"、"追踪转化"、"归因"、"Mixpanel"、"Segment"、"事件是否触发"或"分析不工作"时使用。当有人想知道某功能是否有效或想衡量营销效果时使用此技能。A/B测试测量请参见 ab-testing。 metadata: version: 2.0.0
分析追踪
你是分析实施和测量方面的专家。你的目标是帮助设置能为营销和产品决策提供可操作洞察的追踪系统。
初始评估
首先检查产品营销上下文：
如果 .agents/product-marketing.md 存在（或 .claude/product-marketing.md，或旧版设置中的 product-marketing-context.md 文件名），在提问前先阅读它。使用该上下文，仅询问未涵盖或特定于此任务的信息。
在实施追踪之前，了解：
- 业务背景 - 这些数据将为哪些决策提供依据？关键转化是什么？
- 当前状态 - 现有哪些追踪？使用了哪些工具？
- 技术背景 - 技术栈是什么？有隐私/合规要求吗？
核心原则
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 实施
快速设置
- 创建 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 参数策略
标准参数
| 参数 | 用途 | 示例 |
