ga4-measurement-plan

GA4 衡量计划

提供网站 URL，即可获得完整的 GA4 衡量计划——要跟踪哪些事件、每个事件携带哪些参数、要注册哪些自定义维度，以及要将哪些事件标记为关键事件。交付内容是一份开发者或 GTM 搭建者可直接实施的规范。无需连接账号。

它与 /gtm-tracking-plan 配套使用，后者会将此计划转化为实际的 GTM 代码、触发器和变量。

用法

/ga4-measurement-plan example.com — 为该网站制定衡量计划 /ga4-measurement-plan example.com "drive demo bookings" — 让计划优先服务于某个目标

步骤

1. 了解网站

使用 WebFetch 获取 URL 和具有代表性的一组页面（首页、产品／类别、定价、注册／结账、联系页面）。确定：

• 网站类型 — 电商、潜在客户开发、SaaS、内容／媒体、市场
• 主要转化及任何次要转化（订阅新闻邮件、预约演示、创建账号）
• 访客转化前会经过的漏斗步骤
• 值得衡量的重要交互（搜索、筛选器、视频、下载、配置工具）

如果参数中提供了业务目标，应让计划优先服务于该目标。

2. 从 GA4 已提供的功能开始

注明哪些事件免费提供且无需实施：

• 自动收集：first_visit、session_start、page_view、 user_engagement
• 增强型衡量（如果已启用）：scroll、click（出站）、view_search_results、 video_*、file_download、form_start、form_submit

标明团队应依赖这些事件，而不是重新构建。

3. 针对网站类型推荐事件

将网站映射到 GA4 的推荐事件——使用推荐名称很重要，因为 GA4 会据此构建报告：

• 电商：view_item_list、view_item、select_item、add_to_cart、 view_cart、begin_checkout、add_shipping_info、add_payment_info、purchase、 refund
• 潜在客户开发／SaaS：generate_lead、sign_up、login、search， 以及用于漏斗的自定义事件
• 内容／媒体：search、select_content、share、join_group

对每个事件，说明触发时机和参数（例如，purchase → transaction_id、 value、currency、items[]）。

4. 为其他情况设计自定义事件

对于 GA4 没有推荐事件的交互，按照以下规则设计自定义事件：使用 snake_case，不超过 40 个字符，描述清晰，不使用保留前缀 （google_、firebase_、ga_），全部小写。示例：demo_requested、 pricing_plan_selected、quote_calculated。

保持分类简洁——通常，在共用事件上添加参数优于创建全新事件（使用带有 cta_location 参数的 cta_click，而不是创建十个单独的点击事件）。

5. 事件分类表

给出核心交付内容——每个事件占一行：

事件名称	类型	触发时机	参数	是否为关键事件？
purchase	推荐	订单确认页面加载时	transaction_id、value、currency、items[]	✅
generate_lead	推荐	联系表单提交时	form_id、lead_source、value	✅
demo_requested	自定义	演示表单提交时	plan_interest	✅
...

6. 要注册的自定义维度和指标

在注册为自定义维度之前，标准 GA4 报告中看不到事件参数。列出步骤 5 中所有需要注册的非标准参数：

参数	范围	注册为	原因
lead_source	事件	自定义维度	按来源细分潜在客户
plan_interest	事件	自定义维度	了解哪些方案能带来演示预约

提醒不要将高基数参数（ID、时间戳）用作维度，并注明事件范围上限为 50 个、用户范围上限为 25 个。

7. 关键事件（转化）

建议将哪些事件标记为关键事件。请有所选择——3–8 个较为合适。标记真正的业务成果，绝不要标记 page_view 或 scroll。注明哪些关键事件还应导入 Google Ads 用于出价。

8. 输出

以一份文档的形式交付：

GA4 Measurement Plan — [site]

Site type: ...  |  Primary conversion: ...

1. Already covered (automatic + Enhanced Measurement): ...
2. Event taxonomy table (recommended + custom)
3. Custom dimensions & metrics to register
4. Key events to mark as conversions (and which to send to Google Ads)
5. dataLayer payload examples for the 3-5 most important events
6. Implementation notes & sequencing

最后附上交接语："运行 /gtm-tracking-plan [url]，将此内容转化为 GTM 标记、触发器和变量。"

关键规则

1. 尽可能使用 GA4 推荐的事件名称——报告依赖这些名称。
2. 注册参数优先于新建事件。 保持分类体系精简。
3. 自定义事件必须遵循命名规则——snake_case，长度 ≤40 个字符，不使用保留前缀。
4. 绝不要建议收集事件或参数中的个人身份信息（PII）（电子邮件、电话号码、姓名）——这违反 Google 政策。
5. 这会生成一份计划。若要审查实时 GA4 媒体资源，请使用 /ga4-audit（需要 Cogny MCP）。