analytics-tracking

Analytics Tracking（分析埋点）

用途

该技能面向分析实施与衡量专家，用于帮助用户设置、改进或审查分析埋点与衡量方案，使追踪数据能为营销和产品决策提供可执行的洞察。当用户想要“设置追踪”“GA4”“Google…”等分析相关任务时使用。

初始评估

在实施追踪前，先检查是否存在产品营销上下文文件：若存在 .agents/product-marketing-context.md（旧版为 .claude/product-marketing-context.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

容器结构：代码（Tags，执行 GA4、像素等代码）、触发器（Triggers，决定代码何时触发，如页面浏览、点击）、变量（Variables，动态值，如点击文本、数据层）。

数据层模式示例：

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 是否加载）；值错误（检查变量路径、数据层结构）；重复事件（多个容器、触发器触发两次）。

隐私与合规

注意事项：欧盟/英国/加拿大要求 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 |

任务相关问题

你使用什么工具（GA4、Mixpanel 等）？
你想追踪哪些关键动作？
这些数据将支持什么决策？
由谁实施——开发团队还是营销团队？
是否有隐私/同意要求？
目前已追踪了什么？

工具集成

关键分析工具：GA4（网站分析、Google 生态，支持 MCP，指南 ga4.md）、Mixpanel（产品分析、事件追踪，指南 mixpanel.md）、Amplitude（产品分析、群组分析，指南 amplitude.md）、PostHog（开源分析、会话回放，指南 posthog.md）、Segment（客户数据平台、路由，指南 segment.md）。

技能介绍