analytics-tracking

概览

analytics-tracking 技能的作用

analytics-tracking 技能帮助你设计、实施和审计 analytics tracking，让数据更可信，从而做出更好的营销和产品决策。它主要聚焦于：

• 将业务问题转化为可衡量的 events
• 设计清晰的事件命名和参数规范
• 在 Google Analytics 4 (GA4) 和 Google Tag Manager (GTM) 中实现 tracking
• 设计结构化的 UTM parameters 和 campaign，确保归因清晰
• 搭建能够支持报表和效果分析的 tracking plan

与其胡乱收集 clicks 和 page views，analytics-tracking 会让你专注于那些能回答“这东西到底有用吗？”的关键 events，覆盖你的网站、产品和营销活动。

适合使用这个技能的人群

在以下情况下，你可以使用 analytics-tracking：

• 你是需要可靠 campaign 转化追踪的 市场负责人
• 你是想了解功能使用和激活情况的 产品经理
• 你是想判断实验是否有效的 创始人 或 增长负责人
• 你是负责前端或通过 tag manager 实现 events 的 开发者
• 你是需要干净、统一 event 数据来做 dashboard 和报表的 分析师

如果你主要使用 Google 相关工具，这个技能尤其实用：GA4、GTM、Google Ads，以及用 Google Sheets 或 Google Docs 写的 tracking plan。

analytics-tracking 技能要解决的问题

这个技能适用于你或团队经常会说出下面这些话的场景：

• “我们搭了 GA4，但根本不敢信这些数字。”
• “我们的 events 很乱，也不统一。”
• “这个新功能或 funnel 应该追踪什么，我们完全没概念。”
• “UTM 用得乱七八糟，根本看不出哪个渠道真正有效。”
• “GTM 在触发，但我们不确定 events 配置是不是对的。”

基于仓库中的参考内容，这个技能可以帮你：

• 做一次 现有 tracking 方案的初始评估
• 落地 “为决策而追踪，而不是为数据而追踪” 的原则
• 创建或优化一个带有清晰事件名称、触发条件和参数的 tracking plan
• 使用 gtag.js 或 GTM 在 GA4 中实现 events
• 使用适配你的业务模型（营销官网、SaaS、电商等）的 event library

什么时候适合（或不适合）用 analytics-tracking

在以下情况时适合使用 analytics-tracking：

• 你需要 搭建或优化 GA4 + GTM tracking
• 你在设计或审计 event tracking、conversion 或 attribution
• 你在定义 UTM 策略 或统一 campaign 命名规范
• 你在梳理 产品分析 events（例如注册、功能使用、升级等）

在以下情况，它 不是 首选工具：

• 你只需要 A/B test 设计和衡量 的帮助（可使用单独的 ab-test-setup 技能）
• 你主要在做高级数据仓库建模或只涉及 BI 的问题（本技能聚焦在埋点与实现，不做 SQL 建模）

如果你的核心问题是“我们要怎么衡量这个？”或“我们怎么知道它有没有效果？”，那 analytics-tracking 就是合适的选择。

仓库中的关键参考文件

analytics-tracking 技能依托于几个重点参考文件：

• SKILL.md – 核心行为定义，包括初始评估步骤和核心原则
• references/event-library.md – 按场景结构化的 event library（营销官网、产品、变现、电商、B2B/SaaS）
• references/ga4-implementation.md – 详细的 GA4 搭建与实现指南
• references/gtm-implementation.md – 详细的 Google Tag Manager 结构与实现指南
• evals/evals.json – 示例场景及预期的最佳实践回答（如 SaaS tracking plan、UTM 规范等）

这些文件让技能从泛泛而谈升级为可以真正落地实施的具体指导。

使用方法

安装与初始化

1. 安装 analytics-tracking 技能

使用 Skills CLI 从 coreyhaines31/marketingskills 仓库添加技能：

npx skills add https://github.com/coreyhaines31/marketingskills --skill analytics-tracking

这会拉取 analytics-tracking 的配置、评估 prompts 和参考文档，让你的 agent 能提供细致且偏落地实现的回答。

2. 查看随技能附带的参考文件

安装完成后，在你的环境中打开这些文件以获取上下文：

• SKILL.md – 了解技能范围、假设前提和核心原则
• references/event-library.md – 浏览推荐的 events 和参数
• references/ga4-implementation.md – 看看如何配置 GA4、自定义 events、conversions 和调试
• references/gtm-implementation.md – 学习 container 结构、triggers、variables 和 data layer 用法
• evals/evals.json – 查看示例 prompts 和期望输出格式（如 tracking plan）

把这些当作模版和“护栏”，而不是死板的 copy‑paste 清单。需要根据你的产品、合规要求和技术栈进行调整。

典型使用流程

1. 从零开始设计 tracking plan

当你向 agent 提问类似：

“帮我在 GA4 和 GTM 里为我们的 B2B SaaS 产品搭建 analytics tracking。我们需要追踪 signups、feature usage 和 upgrade events。”

analytics-tracking 技能会：

1. 检查产品/营销上下文

   • 如果存在 .agents/product-marketing-context.md（或旧版的 .claude/product-marketing-context.md），会先读取它，避免重复问问题。

2. 应用“为决策而追踪，而不是为数据而追踪”的原则

   • 先澄清你想支持哪些决策（例如“哪些功能驱动升级？”或“哪些渠道带来试用注册？”）。

3. 定义核心 events 和命名规范

   • 使用 object_action 的事件命名规范（如 signup_completed、feature_used、plan_upgraded）。
   • 从 references/event-library.md 中调用适合 SaaS 的 events，比如：
     • signup_completed
     • trial_started
     • feature_used
     • plan_upgraded
     • subscription_canceled

4. 产出结构化 tracking plan

   • 以类似表格的格式输出（方便粘贴到 Google Sheets 或 Docs），包括：
     • Event name
     • Trigger（触发这个 event 的用户行为）
     • Parameters（如 plan_name、feature_name、pricing_page_variant）
     • 该 event 支持的目的/决策

5. 提供 GA4 实现细节

   • 建议 GA4 中的 event 配置，包括推荐的参数，以及哪些 event 应标记为 conversions。

6. 提供 GTM data layer 方案

   • 给出前端可用的 dataLayer.push 示例代码片段，便于交付给开发，同时说明如何在 GTM 中将其连接到 GA4 Event tags。

这个流程非常适合在新产品发布、漏斗重构，或清理历史 tracking 时使用。

2. 审计现有的 GA4 和 GTM 实现

如果你这样问：

“我们的 GA4 数据看起来不太对。你能帮忙审计一下 tracking 吗？”

技能会引导你去：

• 检查当前的 data streams 和 enhanced measurement（参考 references/ga4-implementation.md）
• 查看 conversion 设置、custom dimensions 和 audiences 是否有配置错误
• 检查 GTM 的 container 结构、tag 命名、triggers 和 variables（参考 references/gtm-implementation.md）
• 在 GA4 DebugView 和 GTM Preview 模式中验证 events
• 将现有 event 列表与 event library 对比，找出缺失和重复

之后你就可以排定修复优先级，例如合并 events、重命名参数，或统一触发条件。

3. 搭建 UTM 参数与归因结构

当你提问：

“我们在 Google Ads、Meta、LinkedIn 和 newsletter 上应该用哪些 UTM 参数？”

基于 evals/evals.json 中的评估指南，analytics-tracking 会：

• 推荐一个 一致的 UTM 策略（例如 utm_source、utm_medium、utm_campaign、utm_term、utm_content）
• 为不同渠道建议合适取值，例如：
  • utm_source: google、meta、linkedin、newsletter
  • utm_medium: cpc、paid_social、email、social
• 帮你在各平台统一 campaign 命名，以便在 GA4 中获得干净的报表
• 展示如何检查 UTM 是否被 GA4 正确采集

随后你可以把这些规范整理到 Google Sheet 或内部 playbook 中，方便团队执行。

4. 文档化 tracking，方便交付给开发

当你需要把策略转化为具体实施说明时，analytics-tracking 可以：

• 基于你的 tracking plan 生成：
  • GTM data layer 规范（如 dataLayer.push({ event: 'feature_used', feature_name: 'bulk_import' })）
  • 在你的 frontend code 中应该在哪里加入这些调用的说明
  • 在 GTM 中创建对应 GA4 Event tags 和 triggers 的指引

这对前端开发非常有帮助，他们能拿到精确的 event 名称、参数和触发条件。

获得优质结果的使用建议

• 先提供上下文：说明你的产品类型（SaaS、电商、平台等）、主要目标，以及当前工具（只用 GA4、GA4 + GTM、Segment 等）。
• 明确决策问题：具体写出你想回答的问题（例如“哪个渠道带来的 signup 最多？”或“功能 X 是否提升留存？”）。
• 说明约束条件：如果有隐私或合规方面的要求，请提前告知，以便 tracking plan 保持现实可行。
• 渐进迭代：从一小组核心 events 开始，然后在实施过程中逐步请技能帮忙优化或扩展。

常见问题（FAQ）

什么时候该用 analytics-tracking，而不是 ab-test-setup？

在以下情况使用 analytics-tracking：

• 你在设计或修复 核心 tracking 基础（events、conversions、UTM、GA4/GTM 设置）
• 你想回答“我们怎么衡量这个功能、页面或 campaign？”这样的问题

在以下情况使用 ab-test-setup：

• 你的主要关注点是如何设计 A/B tests、test variants 和实验指标
• 你希望确保实验测量过程干净、符合统计要求

实际工作中，你通常会先用 analytics-tracking 搭好基础 tracking，再在此基础上叠加 A/B test 的测量方案。

analytics-tracking 主要支持哪些工具？

基于仓库中的参考内容，analytics-tracking 对 Google analytics stack 做了重点优化：

• Google Analytics 4 (GA4) – 配置、自定义 events、conversions、audiences、调试
• Google Tag Manager (GTM) – container 结构、triggers、variables、data layer 模式
• Google Ads 集成 – 通过 GA4 关联和 conversion 导入（详见 GA4 implementation 指南）

它在概念层面也支持更广泛的 analytics 工具，如 Mixpanel 或 Segment（events、properties、tracking plans 等），但最具体、可直接执行的实操细节还是围绕 GA4 + GTM 展开。

这个技能能帮我处理前端实现细节吗？

可以，在实际可行的范围内。该技能可以：

• 建议适合前端 tracking 的 event names 和 parameters
• 提供 dataLayer.push 的示例模式供 GTM 使用
• 解释 events 一般在什么时候触发（例如 button click、form submission、page load）

对于非常框架相关的代码（例如 React hooks、Vue components），你可能仍然需要开发配合，但 analytics-tracking 能给出清晰的 blueprint，说明需要实现哪些 events，以及它们应如何表现。

GA4 和 GTM 的指南有多详细？

GA4 和 GTM 的参考文档相当细致，涵盖：

• 关于 GA4（references/ga4-implementation.md）：

  • Data streams 和 enhanced measurement
  • 推荐 events（包括电商场景）
  • Conversions、event parameters、custom dimensions/metrics
  • Audience 创建与调试工具
  • 数据质量考虑以及与 Google Ads 的集成

• 关于 GTM（references/gtm-implementation.md）：

  • Tags、triggers 和 variables
  • Container 命名规范
  • Data layer 模式
  • 常见的 GA4 和 pixel tag 设置
  • Preview/debugging、workspaces 和版本管理

技能会基于这些内容，给出可直接实施的落地指南，而不仅仅是高层建议。

analytics-tracking 会直接告诉我业务该追踪哪些 events 吗？

它会基于 event library 和最佳实践，提供 强、有主见的起点建议，尤其适用于营销官网、SaaS 产品和电商场景。但它仍然会就以下内容向你提问以便细化：

• 业务模型和定价方式
• 核心转化动作
• 主要获客渠道
• 关键用户路径和核心功能

这样可以确保 tracking plan 真正对齐你的实际决策需求，而不是一份通用的 event 清单。

我怎么把这个技能和 Google Sheets 或 Docs 搭配使用？

很多团队会在 Google Sheets 或 Google Docs 中记录 tracking plan。使用 analytics-tracking，你可以：

• 让技能输出按表格结构组织的 tracking plan，直接粘贴到 sheet 里
• 生成参数字典和命名规范，方便做内部文档
• 在实施过程中不断和 agent 迭代这份 plan，逐步优化你的 analytics 实现

这能在市场、产品、分析和开发之间建立一份共享且可持续更新的“单一事实来源”。

如果我的 analytics “不工作”或者 events 没有触发怎么办？

你可以描述遇到的症状（例如 GA4 中缺少 events、conversion 数量对不上、GTM preview 看不到 tags 等），analytics-tracking 会一步步引导你：

• 在 GTM 中使用 Preview 检查 tag 是否触发
• 验证 dataLayer 中的 events 和 parameters
• 使用 GA4 的 DebugView 和 real-time 报表
• 确认 conversions 是否定义正确并有数据进入

接着，它会基于 GA4 和 GTM 参考指南，给出具体的排错步骤和配置检查建议。