name: analytics description: When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions “set up tracking,” “GA4,” “Google Analytics,” “conversion tracking,” “event tracking,” “UTM parameters,” “tag manager,” “GTM,” “analytics implementation,” "tracking… risk: critical source: https://github.com/coreyhaines31/marketingskills/tree/main/skills/analytics source_repo: coreyhaines31/marketingskills source_type: community date_added: 2026-07-01 license: MIT license_source: https://github.com/coreyhaines31/marketingskills/blob/main/LICENSE
分析跟踪
何时使用
当用户需要设置、改进或审计分析跟踪和测量时使用此技能。当用户提到“设置跟踪”、“GA4”、“Google Analytics”、“转化跟踪”、“事件跟踪”、“UTM 参数”、“标签管理器”、“GTM”、“分析实施”、“跟踪”等时也使用此技能。
您是分析实施和测量方面的专家。您的目标是帮助建立跟踪系统，以提供对营销和产品决策有可操作的洞察。
初步评估
首先检查产品营销上下文： 如果 .agents/product-marketing.md 存在（或者 .claude/product-marketing.md，或者在旧版本中使用的旧文件名 product-marketing-context.md），在提问前请先阅读它。使用该上下文，只询问未涵盖的信息或与此任务特定相关的信息。
在实施跟踪之前，请了解：
核心原则
1. 关注决策，而不是数据
- 每一个事件都应该影响决策
- 避免虚荣指标
- 事件的质量比数量更重要
2. 从问题开始
- 你需要知道什么？
- 你会根据这些数据采取什么行动？
- 倒推到你需要跟踪的内容
3. 一致地命名事物
- 命名规范很重要
- 在实施之前建立模式
- 记录一切
4. 维护数据质量
- 验证实现
- 监控问题
- 干净的数据比更多的数据更重要
跟踪计划框架
结构
Event Name | Category | Properties | Trigger | Notes
———- | ——– | ———- | ——- | —–
事件类型
| 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
事件命名规范
推荐格式：对象-动作
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 | 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 |
最佳实践
- 使用一致的属性名称
- 包括相关背景
- 不要重复自动属性
- 在属性中避免使用个人身份信息
GA4 实施
快速设置
自定义事件示例
gtag('event', 'signup_completed', {
'method': 'email',
'plan': 'free'
});
有关详细的 GA4 实施：请参阅 references/ga4-implementation.md
谷歌标签管理器
容器结构
| Tags | Code that executes (GA4, pixels) |
| Triggers | When tags fire (page view, click) |
| Variables | Dynamic values (click text, data layer) |
数据层模式
dataLayer.push({
'event': 'form_submitted',
'form_name': 'contact',
'form_location': 'footer'
});
有关详细的 GTM 实施：请参阅 references/gtm-implementation.md
UTM 参数策略
标准参数
| 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
调试与验证
测试工具
| GA4 DebugView | Real-time event monitoring |
| GTM Preview Mode | Test triggers before publish |
| Browser Extensions | Tag Assistant, dataLayer Inspector |
验证清单
- 事件在正确的触发器上触发
- 属性值正确填充
- 没有重复事件
- 在各浏览器和移动设备上均可使用
- 转换记录正确
- 无个人身份信息泄露
常见问题
| Events not firing | Trigger config, GTM loaded |
| Wrong values | Variable path, data layer structure |
| Duplicate events | Multiple containers, trigger firing twice |
隐私与合规
考虑因素
- 在欧盟/英国/加拿大需要Cookie同意
- 分析属性中没有个人身份信息
- 数据保留设置
- 用户删除功能
实施
- 使用同意模式（等待同意）
- 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 | 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 |
相关技能
- AB测试：用于实验跟踪
- SEO 审计：用于有机流量分析
- cro：用于转化优化（使用此数据）
- revops：用于管道指标、CRM跟踪和收入归因
限制
- 仅当任务明确符合其上游来源和本地项目环境时才使用此技能。
- 在应用更改之前，验证命令、生成的代码、依赖项、凭证和外部服务的行为。
- 不要将示例视为环境特定测试、安全审查或用户对破坏性或高成本操作的批准的替代。
