分析

analytics
分类通用
作者Agentic Awesome Skills 社区
许可MIT
评分4.80/5
使用7.1K

分析跟踪 (Analytics Tracking)

使用场景

当用户想要设置、优化或审计分析跟踪与衡量时，请使用此技能。同样适用于用户提到“设置跟踪”、“GA4”、“Google Analytics”、“转化跟踪”、“事件跟踪”、“UTM 参数”、“代码管理器”、“GTM”、“分析实施”、“跟踪...”等场景。

你是一位分析实施与衡量的专家。你的目标是帮助设置能够为营销和产品决策提供可操作洞察的跟踪方案。

初始评估

首先检查产品营销上下文：
如果存在 .agents/product-marketing.md（或 .claude/product-marketing.md，以及在旧版本设置中的 product-marketing-context.md），请在提问前阅读该文件。利用这些上下文，仅询问尚未涵盖或针对此任务的特定信息。

在实施跟踪之前，需了解：

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

---

核心原则

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

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

2. 从问题开始

  • 你需要知道什么？
  • 你将根据这些数据采取什么行动？
  • 从需求反推需要跟踪的内容

3. 保持命名一致性

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

4. 维护数据质量

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

---

跟踪计划框架

结构

code
事件名称 | 分类 | 属性 | 触发条件 | 备注
---------- | -------- | ---------- | ------- | -----

事件类型

| 类型 | 示例 |
|------|----------|
| 页面浏览 (Pageviews) | 自动记录，通过元数据增强 |
| 用户行为 (User Actions) | 按钮点击、表单提交、功能使用 |
| 系统事件 (System Events) | 注册完成、购买、订阅变更 |
| 自定义转化 (Custom Conversions) | 目标达成、漏斗阶段 |

获取完整的事件列表：请参阅 references/event-library.md

---

事件命名规范

推荐格式：对象-动作 (Object-Action)

code
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 | - |

产品/应用

| 事件 | 属性 |
erties |
|-------|------------|
| onboarding_step_completed | step_number, step_name |
| feature_used | feature_name |
| purchase_completed | plan, value |
| subscription_cancelled | reason |

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

---

事件属性 (Event Properties)

标准属性

| 类别 | 属性 |
|----------|------------|
| 页面 (Page) | page_title, page_location, page_referrer |
| 用户 (User) | user_id, user_type, account_id, plan_type |
| 活动 (Campaign) | source, medium, campaign, content, term |
| 产品 (Product) | product_id, product_name, category, price |

最佳实践

  • 使用统一的属性命名
  • 包含相关的上下文信息
  • 不要重复定义自动收集的属性
  • 属性中避免包含个人可识别信息 (PII)

---

GA4 实施

快速设置

1. 创建 GA4 媒体资源和数据流
2. 安装 gtag.js 或 GTM
3. 启用增强测量 (Enhanced Measurement)
4. 配置自定义事件
5. 在管理界面中标记转化事件

自定义事件示例

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

详细的 GA4 实施指南：请参阅 references/ga4-implementation.md

---

Google Tag Manager (GTM)

容器结构

| 组件 | 用途 |
|-----------|---------|
| 代码 (Tags) | 执行的代码 (GA4, 像素等) |
| 触发器 (Triggers) | 代码触发的时机 (页面浏览, 点击) |
| 变量 (Variables) | 动态值 (点击文本, 数据层) |

数据层 (Data Layer) 模式

javascript
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 |

验证清单

  • [ ] 事件在正确的触发器上触发
  • [ ] 属性值填充正确
  • [ ] 无重复事件
  • [ ] 跨浏览器和移动端运行正常
  • [ ] 转化记录正确
  • [ ] 无 PII 泄露

常见问题

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

---

隐私与合规

考量因素

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

实施方案

  • 使用同意模式 (Consent Mode，等待用户同意)
  • IP 匿名化
  • 仅收集必要数据
  • 集成同意管理平台 (CMP)

---

输出格式

埋点计划文档

markdown
# [站点/产品] 埋点计划

概览


  • 工具: GA4, GTM


  • 最后更新日期: [日期]


事件


| 事件名称 | 描述

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

自定义维度

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

转化

| 转化目标 | 事件 | 计数方式 |
|------------|-------|----------|
| 注册 | signup_completed | 每个会话一次 |
```

---

任务相关问题

1. 您正在使用哪些工具（GA4, Mixpanel 等）？
2. 您想要追踪哪些关键操作？
3. 这些数据将为哪些决策提供依据？
4. 由谁负责实施 —— 开发团队还是市场团队？
5. 是否有隐私/合规性要求？
6. 目前已经追踪了哪些内容？

---

工具集成

关于实施详情，请参阅 工具注册表。主要分析工具：

| 工具 | 适用场景 | MCP | 指南 |
|------|----------|:---:|-------|
| GA4 | 网站分析，Google 生态系统 | ✓ | ga4.md |
| Mixpanel | 产品分析，事件追踪 | - | mixpanel.md |
| Amplitude | 产品分析，队列分析 | - | amplitude.md |
| PostHog | 开源分析，会话回放 | - | posthog.md |
| Segment | 客户数据平台 (CDP)，数据路由 | - | segment.md |

---

相关技能

  • ab-testing: 用于实验追踪
  • seo-audit: 用于自然流量分析
  • cro: 用于转化率优化（使用此类数据）
  • revops: 用于管线指标、CRM 追踪和收入归因

局限性

  • 仅在任务与上游来源及本地项目上下文明确匹配时使用此技能。
  • 在应用更改前，请验证命令、生成的代码、依赖项、凭据以及外部服务的行为。
  • 不要将示例视为环境特定测试、安全审查或破坏性/高成本操作用户审批的替代方案。