analytics

用途

本技能用于在用户想要建立、改进或审计分析追踪与衡量体系时提供帮助，也适用于用户提到“set up tracking”“GA4”“Google…”等场景。其目标是把追踪搭建成为营销和产品决策提供可执行洞察的机制。

开始前先检查是否存在产品营销上下文文件：.agents/product-marketing.md（或 .claude/product-marketing.md，或旧版 setup 中的 product-marketing-context.md）。如存在则先读取，只询问其中未覆盖或本任务特有的信息。

实施追踪前需要了解：

业务背景：这些数据将支撑哪些决策？关键转化是什么？
当前状态：已有哪些追踪？正在使用哪些工具？
技术背景：技术栈是什么？是否有隐私/合规要求？

核心原则

为决策而追踪，不为数据而追踪：每个事件都应支撑决策，避免虚荣指标，事件质量重于数量。
从问题出发：先明确需要知道什么、会据此采取什么行动，再倒推需要追踪什么。
命名保持一致：命名规范很重要，实施前先建立模式，并做好文档记录。
维护数据质量：验证实施、监控问题，干净的数据优于更多的数据。
计算而非目测：所有总量、比率和差值都应通过脚本或电子表格从行级数据推导，绝不通过扫视行并心算求和。一行被悄悄丢弃就会污染其下游的所有数字。报告每个关键数字前，用第二种独立方式交叉核对（对账合计、按不同分组重新计算），并对任何不一致追查到具体行。当结论针对某个细分（单个campaign、广告组、渠道或周）时，报告该细分自身的数字，不要把它并入相邻分组让分组总数替它说话。
匹配观测窗口：比率或效率指标中，分子和分母必须覆盖同一个封闭观测窗口。绝不用全周期的花费除以部分周期的转化或收入——把两者都重述到实际有数据的周，并说明是哪些周。Cohort 比率只使用观测窗口已结束的 cohort。仍在窗口内的试用或注册属于待定（pending），而非失败——应将其排除在分母之外并标记为待定，而不是计入比率。
针对既定目标提建议：分析最终要给出建议，而建议必须从简报中陈述的目标（发布目标、受众、收入或定位目标）来论证，而不仅仅从操作上最容易的角度出发。说明每个选项服务于哪个既定目标，以及它放弃了什么。

追踪计划框架

结构：

Event Name	Category	Properties	Trigger	Notes

事件类型：

Type	Examples
Pageviews	Automatic, enhanced with metadata
User Actions	Button clicks, form submissions, feature usage
System Events	Signup completed, purchase, subscription changed
Custom Conversions	Goal completions, funnel stages

完整事件列表参见 references/event-library.md。

事件命名规范：

推荐格式：Object-Action

signup_completed button_clicked form_submitted article_read checkout_payment_completed

最佳实践：

小写加下划线
具体明确：cta_hero_clicked 而非 button_clicked
上下文放进属性，而非事件名
避免空格和特殊字符
记录决策
使用自动或推荐事件时保留提供方定义的名称（如 GA4 的 click、view_search_results、purchase）。显式映射内部业务名称；命名自定义事件并不会让提供方自动收集它。

关键事件：

营销站点：

Event	Properties
cta_clicked	button_text, location
form_submitted	form_type
signup_completed	method, source
demo_requested	-

产品/应用：

Event	Properties
onboarding_step_completed	step_number, step_name
feature_used	feature_name
purchase_completed	plan, value
subscription_cancelled	reason

按业务类型的完整事件库参见 references/event-library.md。

事件属性：

标准属性：

Category	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 实施

快速设置：

创建 GA4 媒体资源和数据流
安装 gtag.js 或 GTM
启用增强衡量
配置自定义事件
在 Admin 中标记转化

自定义事件示例：

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

详细 GA4 实施参见 references/ga4-implementation.md。

Google Tag Manager

容器结构：

Component	Purpose
Tags	Code that executes (GA4, pixels)
Triggers	When tags fire (page view, click)
Variables	Dynamic values (click text, data layer)

Data Layer 模式：

dataLayer.push({ 'event': 'form_submitted', 'form_name': 'contact', 'form_location': 'footer' });

详细 GTM 实施参见 references/gtm-implementation.md。

UTM 参数策略

标准参数：

Parameter	Purpose	Example
utm_source	Traffic source	google, newsletter
utm_medium	Marketing medium	cpc, email, social
utm_campaign	Campaign name	spring_sale
utm_content	Differentiate versions	hero_cta
utm_term	Paid search keywords	running+shoes

命名规范：

全部小写
一致使用下划线或连字符
具体但简洁：blog_footer_cta 而非 cta1
在电子表格中记录所有 UTM

调试与验证

测试工具：

Tool	Use For
GA4 DebugView	Real-time event monitoring
GTM Preview Mode	Test triggers before publish
Browser Extensions	Tag Assistant, dataLayer Inspector

验证清单：

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

常见问题：

Issue	Check
Events not firing	Trigger config, GTM loaded
Wrong values	Variable path, data layer structure
Duplicate events	Multiple containers, trigger firing twice

隐私与合规

注意事项：

欧盟/英国/加拿大要求 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 等）？
你想追踪哪些关键操作？
这些数据将支撑哪些决策？
由谁实施——开发团队还是营销团队？
是否有隐私/同意要求？
已经追踪了什么？

工具集成

实施参见工具注册表。关键分析工具：

Tool	Best For	MCP	Guide
GA4	Web analytics, Google ecosystem	✓	ga4.md
Mixpanel	Product analytics, event tracking	-	mixpanel.md
Amplitude	Product analytics, cohort analysis	-	amplitude.md
PostHog	Open-source analytics, session replay	-	posthog.md
Segment	Customer data platform, routing	-	segment.md

技能介绍

用途