用途
Analytics Tracking 是一个专注于分析追踪实现的技能,目标是确保客户旅程中每个有意义的动作都被准确、一致地捕获,并且能够真正用于决策,而不仅仅是为了拥有数据。它强调:糟糕的追踪比没有追踪更糟——重复事件、缺失参数、未经同意的数据和损坏的转化会导致基于错误数据的决策。该技能旨在帮助用户第一次就正确构建追踪,或者发现并修复已损坏的部分。
主要能力
该技能覆盖以下核心领域:
- 事件分类法设计:定义事件命名规范(object_action,snake_case,动词在后),提供标准参数(如 page_location、user_id、plan_name、value、currency 等),并给出 SaaS 核心漏斗事件(如 signup_started、signup_completed、trial_started、checkout_completed 等)和微转化事件(如 pricing_viewed、demo_requested、form_submitted 等)的完整目录。
- GA4 设置:包括数据流配置、增强测量审查、自定义事件创建(通过 gtag 或 GTM 数据层)、关键事件配置(最多 30 个,且具有追溯性)。
- Google Tag Manager 设置:提供容器结构(标签、触发器、变量),以及两种标签模式:数据层推送(最可靠)和 CSS 选择器点击。
- 转化追踪:针对 Google Ads 和 Meta Pixel 的配置建议,包括转化操作创建、归因模型、转化窗口,以及 Meta Conversions API(CAPI)的推荐。
- 跨平台追踪:UTM 策略(严格约定)、归因窗口(GA4、Google Ads、Meta、LinkedIn)、跨域追踪配置。
- 数据质量:去重(常见原因与修复)、机器人过滤、同意管理影响(高级同意模式推荐)。
- 主动触发:识别常见问题,如事件在每次页面加载时触发、未传递 user_id、转化不匹配、未配置同意模式、SPA 路由未处理、UTM 缺失等。
- 输出产物:根据请求生成追踪计划、审计报告、GTM 配置、调试步骤、转化追踪配置,或通过脚本生成追踪计划。
使用方式
该技能以对话式工作流运行,首先检查是否存在 .claude/product-marketing-context.md 上下文文件,然后收集当前状态、业务背景和目标。它支持三种模式:
- 从零搭建:没有分析工具时,构建追踪计划、实施 GA4 和 GTM、定义事件分类法、配置关键事件。可使用脚本
python3 scripts/tracking_plan_generator.py生成追踪计划草稿。 - 审计现有追踪:追踪已存在但数据不可信、覆盖不完整或需要添加新目标时,进行审计、填补缺口和清理。
- 调试追踪问题:特定事件缺失、转化数字不匹配或 GTM 预览显示事件触发但 GA4 未记录时,使用结构化调试工作流。
用户可以通过自然语言请求,如“构建追踪计划”、“审计我的追踪”、“设置 GTM”、“调试缺失事件”、“设置转化追踪”或“生成追踪计划”,获得相应的输出产物。
适用场景
该技能适用于以下场景:
- SaaS 产品需要建立或优化分析追踪体系。
- 营销团队需要确保转化追踪准确,以支持广告投放优化。
- 开发人员需要调试 GA4 或 GTM 中的追踪问题。
- 数据团队需要审计现有追踪的数据质量。
- 需要遵守 GDPR 等隐私法规,实施同意管理模式。
限制
该技能主要关注追踪设置,不涉及仪表板和报告分析(应使用 campaign-analytics 技能)。它也不涵盖 A/B 测试设计(应使用 ab-test-setup 技能)或技术 SEO(应使用 seo-audit 技能)。对于完整的 GDPR 合规框架,应参考 gdpr-dsgvo-expert 技能。该技能提供的建议基于通用最佳实践,具体实施需根据实际技术栈和业务需求调整。