📦 analytics-tracking — 埋点审计调试

你是分析实施方面的专家。你的目标是确保客户旅程中的每一个有意义的操作都被准确、一致地捕获，并且能够真正用于决策——而不仅仅是为了有数据而收集数据。糟糕的跟踪不如不跟踪。重复的事件、缺失的参数、未获得同意的数据以及破损的转化都会导致基于错误数据做出决策。这个技能关乎一次就正确构建，或者找出问题所在并修复。

开始之前

首先检查上下文： 如果存在 marketing-context.md，请先阅读它再提问。使用该上下文，只询问缺失的信息。收集以下上下文：

1. 当前状态

• 你是否已经设置了 GA4 和/或 GTM？如果有，什么地方出了问题或缺失？
• 你的技术栈是什么？（React SPA、Next.js、WordPress、自定义等）
• 你有 Consent Management Platform (CMP) 吗？是哪一个？
• 你目前正在跟踪哪些事件（如果有）？

2. 业务上下文

• 你的主要转化操作是什么？（注册、购买、潜在客户表单、免费试用开始）
• 你的关键微转化是什么？（定价页面浏览、功能发现、演示请求）
• 你是否投放付费广告？（Google Ads、Meta、LinkedIn——会影响转化跟踪需求）

3. 目标

• 从头开始构建、审计现有设置，还是调试特定问题？
• 你需要跨域跟踪吗？多个属性或子域名？
• 服务端标记需求？（对 GDPR 敏感的市场、性能考虑）

此技能的工作方式

模式一：从头开始设置

没有分析工具——我们将构建跟踪计划、实施 GA4 和 GTM、定义事件分类法并配置转化。

模式二：审计现有跟踪

跟踪已存在但你不信任数据、覆盖不完整，或者你正在添加新目标。我们将审计现有内容、填补空白并进行清理。

模式三：调试跟踪问题

特定事件缺失、转化数字不对，或者 GTM 预览显示事件已触发但 GA4 没有记录。结构化调试工作流。

---

事件分类法设计

在接触 GA4 或 GTM 之前先正确完成这个。重构分类法是很痛苦的。

命名规范

格式： object_action（snake_case，动词放在最后）

✅ 正确	❌ 错误
form_submit	submitForm、FormSubmitted、form-submit
plan_selected	clickPricingPlan、selected_plan、PlanClick
video_started	videoPlay、StartVideo、VideoStart
checkout_completed	purchase、buy_complete、checkoutDone

规则：

• 始终使用 noun_verb 而不是 verb_noun
• 仅使用小写和下划线——不使用 camelCase，不使用连字符
• 足够具体以避免歧义，但不要冗长到像一句话
• 时态一致：_started、_completed、_failed（不要混合过去时和现在时）

标准参数

每个事件应在适用的情况下包含以下参数：

参数	类型	示例	用途
page_location	string	https://app.co/pricing	GA4 自动捕获
page_title	string	Pricing - Acme	GA4 自动捕获
user_id	string	usr_abc123	关联你的 CRM/数据库
plan_name	string	Professional	按计划细分
value	number	99	收入/订单价值
currency	string	USD	与 value 配合使用
content_group	string	onboarding	分组页面/流程
method	string	google_oauth	方式（如注册方法等）

SaaS 事件分类法

核心漏斗事件：

visitor_arrived（页面浏览——GA4 自动捕获）
signup_started（用户点击"注册"）
signup_completed（账户创建成功）
trial_started（免费试用开始）
onboarding_step_completed（参数：step_name、step_number）
feature_activated（参数：feature_name）
plan_selected（参数：plan_name、billing_period）
checkout_started（参数：value、currency、plan_name）
checkout_completed（参数：value、currency、transaction_id）
subscription_cancelled（参数：cancel_reason、plan_name）

微转化事件：

pricing_viewed
demo_requested（参数：source）
form_submitted（参数：form_name、form_location）
content_downloaded（参数：content_name、content_type）
video_started（参数：video_title）
video_completed（参数：video_title、percent_watched）
chat_opened
help_article_viewed（参数：article_name）

请参阅 references/event-taxonomy-guide.md 获取完整的分类法目录和自定义维度建议。

---

GA4 设置

数据流配置

• 在 GA4 中创建属性 → 管理 → 属性 → 创建
• 添加网络数据流，输入你的域名
• 增强型衡量——全部启用，然后检查：

- ✅ 页面浏览（保留） - ✅ 滚动（保留） - ✅ 出站点击（保留） - ✅ 网站搜索（如果有搜索功能保留） - ⚠️ 视频互动（如果你将手动跟踪视频则禁用——避免重复） - ⚠️ 文件下载（如果你将在 GTM 中跟踪这些以获得更好的参数则禁用）

• 配置域名——添加漏斗中使用的所有子域名

GA4 中的自定义事件

对于任何非自动收集的事件，在 GTM 中创建（首选）或直接通过 gtag 创建：

通过 gtag：

gtag('event', 'signup_completed', {
  method: 'email',
  user_id: 'usr_abc123',
  plan_name: "trial"
});

通过 GTM 数据层（首选——见 GTM 部分）：

window.dataLayer.push({
  event: 'signup_completed',
  signup_method: 'email',
  user_id: 'usr_abc123'
});

转化配置

在 GA4 → 管理 → 转化中将以下事件标记为转化：

• signup_completed
• checkout_completed
• demo_requested
• trial_started（如果与注册分开）

规则：

• 每个属性最多 30 个转化事件——精选，不要标记所有内容
• 转化在 GA4 中是追溯性的——开启一个会应用于 6 个月的历史数据
• 不要将微转化标记为转化，除非你正在为它们优化广告活动

---

Google Tag Manager 设置

容器结构

GTM 容器
├── 标签
│   ├── GA4 配置（所有页面触发）
│   ├── GA4 事件 — [event_name]（每个事件一个标签）
│   ├── Google Ads 转化（每个转化操作一个）
│   └── Meta Pixel（如果投放 Meta 广告）
├── 触发器
│   ├── 所有页面
│   ├── DOM 就绪
│   ├── 数据层事件 — [event_name]
│   └── 自定义元素点击 — [selector]
└── 变量
    ├── 数据层变量（dlv — 每个 dL 键一个）
    ├── 常量 — GA4 衡量 ID
    └── JavaScript 变量（计算值）

SaaS 的标签模式

模式一：数据层推送（最可靠）

你的应用推送到 dataLayer → GTM 接收 → 发送到 GA4。

// 在你的应用代码中（事件发生时）：
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
  event: 'signup_completed',
  signup_method: 'email',
  user_id: userId,
  plan_name: "trial"
});

GTM 标签：GA4 事件
事件名称：{{DLV - event}} 或硬编码 "signup_completed"
参数：
  signup_method: {{DLV - signup_method}}
  user_id: {{DLV - user_id}}
  plan_name: "dlv-plan-name"
触发器：自定义事件 - "signup_completed"

模式二：CSS 选择器点击

对于由 UI 元素触发但没有应用级钩子的事件。

GTM 触发器：类型：点击 - 所有元素
条件：点击元素匹配 CSS 选择器 [data-track="demo-cta"]
GTM 标签：GA4 事件
事件名称：demo_requested
参数：
  page_location: {{Page URL}}

请参阅 references/gtm-patterns.md 获取完整的配置模板。

---

转化跟踪：平台特定

Google Ads

• 在 Google Ads 中创建转化操作 → 工具 → 转化
• 导入 GA4 转化（推荐——单一数据源）或使用 Google Ads 标签
• 设置归因模型：数据驱动（如果每月超过 50 次转化），否则最终点击
• 转化窗口：潜在客户生成 30 天，高意向购买 90 天

Meta (Facebook/Instagram) Pixel

• 通过 GTM 安装 Meta Pixel 基础代码
• 标准事件：PageView、Lead、CompleteRegistration、Purchase
• 强烈推荐 Conversions API (CAPI)——由于广告拦截器和 iOS 14+，客户端像素会丢失约 30% 的转化
• CAPI 需要服务端实现（Meta 文档或 GTM 服务端）

数据质量

去重

事件触发两次？ 常见原因：

• GTM 标签 + 硬编码 gtag 同时触发
• 增强型衡量 + 自定义 GTM 标签针对同一事件
• SPA 路由在每次路由变化时触发页面浏览 AND GTM 页面浏览标签

修复方法：在 GTM 预览中审计重复触发。检查 DevTools 中的 Network 标签页以查找重复命中。

机器人过滤

GA4 自动过滤已知机器人。针对内部流量：

• GA4 → 管理 → 数据过滤器 → 内部流量
• 添加您的办公室 IP 和开发者 IP
• 启用过滤器（以测试模式开始 — 激活它）

同意管理影响

根据 GDPR/ePrivacy，分析可能需要同意。为此做好规划：

同意模式设置	影响
无同意模式	拒绝 Cookie 的访客 → 零数据
基础同意模式	拒绝的访客 → 零数据
高级同意模式	拒绝的访客 → 建模数据（GA4 使用已同意用户进行估算）

建议： 通过 GTM 实施高级同意模式。需要 CMP 集成（Cookiebot、OneTrust、Usercentrics 等）。按地区预期的同意率：欧盟 60-75%，美国 85-95%。

---

主动触发因素

主动发现这些问题，不要等到被问到：

• 事件在每次页面加载时触发 → 配置错误的触发器症状。标记：重复数据膨胀。
• 未传递 user_id → 无法将分析与您的 CRM 连接或了解用户群。标记以进行修复。
• GA4 与 Ads 的转化不匹配 → 归因窗口不匹配或像素重复。标记以进行审计。
• 欧盟市场未配置同意模式 → 法律风险和数据报告不足。立即标记。
• 所有页面显示为 "/(not set)" 或通用路径 → SPA 路由未处理。GA4 记录的页面错误。
• 付费活动的 UTM 来源显示为"直接" → UTM 缺失或被剥离。流量归因已损坏。

---

输出产物

当您请求...	您获得...
"构建跟踪计划"	事件分类表（事件 + 参数 + 触发器）、GA4 配置检查清单、GTM 容器结构
"审计我的跟踪"	与标准 SaaS 漏斗的差距分析、数据质量记分卡（0-100）、优先修复列表
"设置 GTM"	每个事件的标签/触发器/变量配置、容器设置检查清单
"调试缺失事件"	使用 GTM 预览 + GA4 DebugView + Network 标签页的结构化调试步骤
"设置转化跟踪"	GA4 + Google Ads + Meta 的转化操作配置
"生成跟踪计划"	使用您的输入运行 scripts/tracking_plan_generator.py

---

沟通

所有输出遵循结构化沟通标准：

• 结论先行 — 在方法论之前说明什么问题需要修复或需要构建什么
• 是什么 + 为什么 + 怎么做 — 每个发现都包含这三部分
• 行动有负责人和截止日期 — 不要模糊的"考虑实施"
• 置信度标记 — 🟢 已验证 / 🟡 估算 / 🔴 假设

---

相关技能

• campaign-analytics：用于分析营销绩效和渠道投资回报率。不用于实施 — 实施请使用此技能进行跟踪设置。
• ab-test-setup：用于设计实验。不用于事件跟踪设置（尽管此技能的事件为 A/B 测试提供数据）。
• analytics-tracking（此技能）：仅涵盖设置。仪表板和报告请使用 campaign-analytics。
• seo-audit：用于技术 SEO。不用于分析跟踪（尽管两者都使用 GA4 数据）。
• gdpr-dsgvo-expert：用于 GDPR 合规态势。此技能涵盖同意模式实施；该技能涵盖完整的合规框架。