findscripter 何时使用
适用于以下场景：
- 从零搭建：还没有分析体系，需要建立追踪计划、实现 GA4 与 GTM、定义事件分类法、配置转化。
- 审计存量埋点：埋点已存在但数据不可信、覆盖不全，或要新增目标。审查现状、补缺、清理重复。
- 调试埋点问题：特定事件丢失、转化数对不上，或 GTM Preview 显示事件已触发但 GA4 未记录。
不该用边界：
- 分析营销活动表现、渠道 ROI → 用
campaign-analytics（本技能只管「埋点搭建」，不做报表）。 - 产品内事件分析、BI 看板 → 用
product-analytics。 - GDPR 完整合规框架 → 用
gdpr-dsgvo-expert（本技能只覆盖同意模式的实现）。
核心原则：坏埋点比没埋点更糟。重复事件、缺失参数、未授权数据、断裂的转化，会让决策建立在错误数据上。要么第一次就做对，要么找出问题并修复。
步骤
1. 开工前先收集上下文
若存在 marketing-context.md，先读它，只补问缺失项。需明确：
- 现状：是否已有 GA4/GTM？哪里坏了或缺了？技术栈（React SPA / Next.js / WordPress / 自研）？是否有 CMP（同意管理平台），用的哪个？当前已追踪哪些事件？
- 业务：主转化动作（注册、购买、留资、试用开通）？关键微转化（定价页浏览、功能发现、Demo 申请）？是否投放付费广告（Google Ads / Meta / LinkedIn，影响转化追踪需求）？
- 目标：从零建 / 审计 / 调试某个具体问题？是否需要跨域追踪、多 property/子域？是否需要服务端打标（GDPR 敏感市场、性能）？
2. 先定事件分类法（动 GA4/GTM 之前）
分类法返工极其痛苦，必须先定好。
- 命名规范：
object_action（snake_case，动词在后）。正例form_submit、plan_selected、video_started、checkout_completed；反例submitForm、FormSubmitted、form-submit、PlanClick。 - 规则：始终
名词_动词而非动词在前；全小写 + 下划线，禁 camelCase、禁连字符；具体到无歧义但不啰嗦；时态一致（统一_started/_completed/_failed）。 - 标准参数（适用即带）：
page_location、page_title（GA4 自动采集）、user_id（关联 CRM/DB）、plan_name、value（收入/订单额）、currency（与 value 必须配对）、content_group、method。 - SaaS 核心漏斗事件：
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、video_started/video_completed、chat_opened、help_article_viewed。
3. 配置 GA4
- 数据流：GA4 → 管理 → 创建 property → 添加网站数据流（填域名）。
- 增强衡量：先全开再复核。保留页面浏览、滚动、出站点击、站内搜索；若打算手动追踪视频，关闭视频互动避免重复；若用 GTM 追踪下载以获取更好参数，关闭文件下载。
- 域名：把漏斗涉及的所有子域加入配置。
- 转化标记：GA4 → 管理 → 转化，标记
signup_completed、checkout_completed、demo_requested、trial_started。规则：每 property 最多 30 个转化事件，要精选；转化是追溯生效的（开启即应用近 6 个月历史）；除非要为微转化优化广告，否则别把微转化标为转化。
4. 配置 GTM
容器结构：Tags（GA4 Configuration 全页触发 / 每事件一个 GA4 Event 标签 / Google Ads 转化 / Meta Pixel）、Triggers（All Pages / DOM Ready / Data Layer Event / Custom Element Click）、Variables（dlv 数据层变量 / Measurement ID 常量 / JS 变量）。
- 模式 1（最可靠）：dataLayer Push。应用推送到 dataLayer → GTM 拾取 → 发往 GA4。
- 模式 2：CSS 选择器点击。用于无应用层钩子的 UI 元素，触发器用
Click - All Elements+ 匹配 CSS 选择器（如[data-track="demo-cta"]）。
5. 平台转化追踪
- Google Ads：建转化动作 → 导入 GA4 转化（推荐，单一数据源）；归因模型 月转化 >50 用「数据驱动」，否则「最终点击」；转化窗口 留资 30 天、高决策成本购买 90 天。
- Meta Pixel：经 GTM 装基础码；标准事件
PageView/Lead/CompleteRegistration/Purchase；强烈建议上 Conversions API（CAPI），纯客户端 pixel 因广告拦截和 iOS 会丢约 30% 转化；CAPI 需服务端实现。
6. 跨平台与跨域
- UTM 规范：
utm_source平台名小写、utm_medium流量类型（cpc/email/social/organic）、utm_campaign活动 ID、utm_content创意变体、utm_term付费关键词。绝不给自然/直接流量打 UTM，UTM 会覆盖 GA4 自动来源归因。 - 归因窗口：GA4 30 天（按销售周期可 30–90）；Google Ads 试用 30 / 企业 90；Meta 仅 7 天点击；LinkedIn 30 天。
- 跨域（如
acme.com→app.acme.com）：① GA4 数据流 → 配置标签 → 排除自我推荐里加两个域；② GTM 的 GA4 Configuration 标签 → 跨域衡量加两个域；③ 测试：访问 A 域点链接到 B 域，看 GA4 DebugView，会话不应重启。
7. 数据质量校验
- 去重：事件触发两次的常见原因——GTM 标签与硬编码 gtag 同时触发；增强衡量与自定义 GTM 标签追同一事件；SPA 路由每次切换发 pageview 又叠 GTM 页面浏览标签。用 GTM Preview 查双触发，DevTools Network 查重复命中。
- 机器人过滤：GA4 自动过滤已知 bot；内部流量在 GA4 → 管理 → 数据过滤器 → 内部流量，加办公室/开发者 IP，从测试模式激活。
- 同意管理：GDPR/ePrivacy 下分析可能需授权。高级同意模式（Advanced Consent Mode） 对拒绝 cookie 的访客提供建模数据（推荐，经 GTM + CMP 如 Cookiebot/OneTrust/Usercentrics 集成）；无同意模式或基础同意模式则拒绝者零数据。预期同意率：EU 60–75%，US 85–95%。
指令
主动巡检，不等用户问就上报以下信号：
- 事件每次页面加载都触发 → 触发器配错，标记数据膨胀风险。
- 未传 user_id → 无法关联 CRM、无法做队列分析，标记修复。
- GA4 与 Ads 转化对不上 → 归因窗口不一致或 pixel 重复，标记审计。
- EU 市场未配同意模式 → 法律风险 + 数据低报，立即标记。
- 页面全显示
/(not set)或通用路径 → SPA 路由未处理，GA4 记错页面。 - 付费活动来源显示为 direct → UTM 缺失或被剥离，归因已断。
沟通遵循：结论先行（先说坏在哪/要建什么，再讲方法）；每条发现含 What + Why + How；行动有责任人和截止时间；置信度标记 🟢 已验证 / 🟡 估算 / 🔴 假设。
示例
输入：「帮我搭建追踪计划。」 产出：事件分类法表（事件 + 参数 + 触发条件）、GA4 配置清单、GTM 容器结构。
经 gtag 上报自定义事件：
gtag('event', 'signup_completed', {
method: 'email',
user_id: 'usr_abc123',
plan_name: 'trial'
});
经 GTM dataLayer 上报（首选）：
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
event: 'signup_completed',
signup_method: 'email',
user_id: userId,
plan_name: 'trial'
});
对应 GTM：GA4 Event 标签，Event Name 取 {{DLV - event}}，参数映射 signup_method/user_id/plan_name 到对应 dlv，触发器为 Custom Event signup_completed。
其他请求 → 产出对应物：审计埋点 → 对标 SaaS 标准漏斗的缺口分析 + 数据质量评分（0–100）+ 优先级修复清单；调试丢失事件 → 用 GTM Preview + GA4 DebugView + Network 的结构化排查步骤；配置转化 → GA4 + Google Ads + Meta 三端转化动作配置。
注意事项
- 分类法是地基，动 GA4/GTM 前必须先定好，返工成本极高。
- 转化标记在 GA4 中追溯生效且上限 30 个，谨慎精选。
value与currency必须成对出现，否则收入无法计算。- 自然/直接流量禁打 UTM，否则覆盖自动归因、污染渠道数据。
- 客户端 Meta pixel 会丢约 30% 转化，跑 Meta 广告务必上 CAPI。
- 增强衡量与手动/GTM 追踪同事件时二选一，避免重复计数。
- SPA 必须手动处理路由级 pageview，否则页面归集错误。
互见
campaign-analytics：营销表现与渠道 ROI 分析（本技能只管搭建，不做报表/看板）。product-analytics：产品内事件分析与 BI 看板。ab-test-setup：实验设计（本技能产出的事件可喂给 A/B 测试）。gdpr-dsgvo-expert：完整 GDPR 合规框架（本技能只覆盖同意模式实现）。- 源技能附带的参考资料可下钻：
references/event-taxonomy-guide.md（完整分类法目录与自定义维度建议）、references/gtm-patterns.md（GTM 配置模板）、references/debugging-playbook.md（调试手册）、scripts/tracking_plan_generator.py（追踪计划生成脚本）。
采编自 alirezarezvani/claude-skills（MIT）。