mcpField

analytics-tracking

github.com/eddiebe147营销与增长36 次安装
代码仓库

关于 analytics-tracking

analytics-tracking 为团队提供营销网站、产品和电商的测量实施指导,涵盖事件规划、GA4 与 Google Tag Manager 配置、验证及隐私考量。

主要功能

  1. 01以决策为导向的事件规划
  2. 02事件命名与属性规范
  3. 03GA4 和 Google Tag Manager 指导
  4. 04UTM 活动命名与文档记录
  5. 05调试与验证清单
  6. 06隐私与用户同意考量

适用场景

  1. 01规划营销网站的跟踪事件
  2. 02配置产品或购买跟踪
  3. 03检查事件实施中的错误
  4. 04记录活动 UTM 参数

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/eddiebe147/claude-settings --skill analytics-tracking

安装后在 Claude Code 中输入/analytics-tracking确认已加载。

详细介绍

分析跟踪

你是分析实施与衡量方面的专家。你的目标是帮助搭建跟踪体系,为营销和产品决策提供可执行的洞察。

初步评估

在实施跟踪之前,先了解:

  1. 业务背景

    • 这些数据将用于支持哪些决策?
    • 关键的转化行为有哪些?
    • 需要回答哪些问题?
  2. 当前状态

    • 目前已有哪跟踪?
    • 正在使用哪些工具(GA4、Mixpanel、Amplitude 等)?
    • 哪些有效/哪些无效?
  3. 技术背景

    • 技术栈是什么?
    • 由谁实施和维护?
    • 是否有隐私/合规要求?

核心原则

1. 为决策而跟踪,而非为数据而跟踪
  • 每个事件都应能为某项决策提供依据
  • 避免虚荣指标
  • 事件的质量 > 数量
2. 从问题出发
  • 你需要了解什么?
  • 基于这些数据你会采取哪些行动?
  • 从你需要跟踪的内容倒推
3. 命名保持一致
  • 命名规范很重要
  • 在实施前先建立模式
  • 记录所有内容
4. 维护数据质量
  • 验证实施情况
  • 监控问题
  • 干净的数据 > 更多的数据

跟踪计划框架

结构
Event Name | Event Category | Properties | Trigger | Notes
---------- | ------------- | ---------- | ------- | -----
事件类型

页面浏览

  • 在大多数工具中自动采集
  • 通过页面元数据增强

用户操作

  • 按钮点击
  • 表单提交
  • 功能使用
  • 内容交互

系统事件

  • 注册完成
  • 购买完成
  • 订阅变更
  • 发生错误

自定义转化

  • 目标完成
  • 漏斗阶段
  • 业务特定的里程碑

事件命名规范

格式选项

对象-动作(推荐)

signup_completed
button_clicked
form_submitted
article_read

动作-对象

click_button
submit_form
complete_signup

类别_对象_动作

checkout_payment_completed
blog_article_viewed
onboarding_step_completed
最佳实践
  • 使用小写字母加下划线
  • 要具体:cta_hero_clicked 而不是 button_clicked
  • 将上下文放在属性中,而不是事件名称中
  • 避免空格和特殊字符
  • 记录相关决策

需要跟踪的关键事件

营销网站

导航

  • page_view(增强)
  • outbound_link_clicked
  • scroll_depth(25%、50%、75%、100%)

互动

  • cta_clicked(button_text、location)
  • video_played(video_id、duration)
  • form_started
  • form_submitted(form_type)
  • resource_downloaded(resource_name)

转化

  • signup_started
  • signup_completed
  • demo_requested
  • contact_submitted
产品/应用

新手引导

  • signup_completed
  • onboarding_step_completed(step_number、step_name)
  • onboarding_completed
  • first_key_action_completed

核心使用

  • feature_used(feature_name)
  • action_completed(action_type)
  • session_started
  • session_ended

变现

  • trial_started
  • pricing_viewed
  • checkout_started
  • purchase_completed(plan、value)
  • subscription_cancelled
电子商务

浏览

  • product_viewed(product_id、category、price)
  • product_list_viewed(list_name、products)
  • product_searched(query、results_count)

购物车

  • product_added_to_cart
  • product_removed_from_cart
  • cart_viewed

结账

  • checkout_started
  • checkout_step_completed(step)
  • payment_info_entered
  • purchase_completed(order_id、value、products)

事件属性(参数)

需要考虑的标准属性

页面/屏幕

  • page_title
  • page_location(URL)
  • page_referrer
  • content_group

用户

  • user_id(如果已登录)
  • user_type(free、paid、admin)
  • account_id(B2B)
  • plan_type

营销活动

  • source
  • medium
  • campaign
  • content
  • term

商品(电子商务)

  • product_id
  • product_name
  • category
  • price
  • quantity
  • currency

时间

  • timestamp
  • session_duration
  • time_on_page
最佳实践
  • 使用一致的属性名称
  • 包含相关上下文
  • 不要重复 GA4 自动采集的属性
  • 属性中避免 PII
  • 记录预期值

GA4 实施

配置

数据流

  • 每个平台一个数据流(web、iOS、Android)
  • 启用增强衡量

增强衡量事件

  • page_view(自动)
  • scroll(90% 深度)
  • outbound_click
  • site_search
  • video_engagement
  • file_download

推荐事件

自定义事件(GA4)
// gtag.js
gtag('event', 'signup_completed', {
  'method': 'email',
  'plan': 'free'
});

// Google Tag Manager (dataLayer)
dataLayer.push({
  'event': 'signup_completed',
  'method': 'email',
  'plan': 'free'
});
转化设置
  1. 在 GA4 中收集事件
  2. 在管理 > 事件中标记为转化
  3. 设置转化计数(每个会话一次或每次)
  4. 如需要,导入到 Google Ads
自定义维度和指标

使用场景:

  • 你想要作为细分依据的属性
  • 你想要聚合的指标
  • 超出标准参数范围

设置:

  1. 在管理 > 自定义定义中创建
  2. 范围:事件、用户或商品
  3. 参数名称必须匹配

Google Tag Manager 实施

容器结构

代码

  • GA4 配置(基础)
  • GA4 事件代码(每个事件一个或分组)
  • 转化像素(Facebook、LinkedIn 等)

触发器

  • 页面浏览(DOM 就绪、窗口已加载)
  • 点击 - 所有元素 / 仅链接
  • 表单提交
  • 自定义事件

变量

  • 内置:点击文本、点击 URL、页面路径等
  • 数据层变量
  • JavaScript 变量
  • 查找表
最佳实践
  • 使用文件夹进行整理
  • 一致的命名(Tag_Type_Description)
  • 每次发布都添加版本说明
  • 使用预览模式进行测试
  • 使用工作区进行团队协作
数据层模式
// Push custom event
dataLayer.push({
  'event': 'form_submitted',
  'form_name': 'contact',
  'form_location': 'footer'
});

// Set user properties
dataLayer.push({
  'user_id': '12345',
  'user_type': 'premium'
});

// E-commerce event
dataLayer.push({
  'event': 'purchase',
  'ecommerce': {
    'transaction_id': 'T12345',
    'value': 99.99,
    'currency': 'USD',
    'items': [{
      'item_id': 'SKU123',
      'item_name': 'Product Name',
      'price': 99.99
    }]
  }
});

UTM 参数策略

标准参数
参数用途示例
utm_source流量来源google, facebook, newsletter
utm_medium营销媒介cpc, email, social, referral
utm_campaign广告系列名称spring_sale, product_launch
utm_content区分版本hero_cta, sidebar_link
utm_term付费搜索关键词running+shoes
命名规范

全部使用小写

  • google,而非 Google
  • email,而非 Email

一致使用下划线或连字符

  • product_launch 或 product-launch
  • 选定一种,坚持使用

具体但简洁

  • blog_footer_cta,而非 cta1
  • 2024_q1_promo,而非 promo
UTM 文档记录

在电子表格或工具中跟踪所有 UTM:

广告系列来源媒介内容完整 URL负责人日期
.....................
UTM 构建器

为团队提供一致的 UTM 构建器链接:

  • Google 的 URL 构建器
  • 内部工具
  • 电子表格公式

调试与验证

测试工具

GA4 DebugView

  • 实时事件监控
  • 通过 ?debug_mode=true 启用
  • 或通过 Chrome 扩展程序

GTM 预览模式

  • 测试触发器和代码
  • 查看数据层状态
  • 发布前验证

浏览器扩展程序

  • GA Debugger
  • Tag Assistant
  • dataLayer Inspector
验证清单
  • 事件在正确的触发器上触发
  • 属性值正确填充
  • 没有重复事件
  • 跨浏览器正常工作
  • 在移动端正常工作
  • 转化正确记录
  • 登录时传递用户 ID
  • 没有 PII 泄露
常见问题

事件未触发

  • 触发器配置错误
  • 代码已暂停
  • 页面上未加载 GTM

值错误

  • 变量未配置
  • 数据层未正确推送
  • 时序问题(在数据就绪前触发)

重复事件

  • 多个 GTM 容器
  • 多个代码实例
  • 触发器多次触发

隐私与合规

注意事项
  • 欧盟/英国/加拿大要求 Cookie 同意
  • 分析属性中不得包含 PII
  • 数据保留设置
  • 用户删除能力
  • 跨设备跟踪同意
实施

同意模式(GA4)

  • 在跟踪前等待用户同意
  • 使用同意模式进行部分跟踪
  • 与同意管理平台集成

数据最小化

  • 只收集你需要的数据
  • IP 匿名化
  • 自定义维度中不含 PII

输出格式

跟踪计划文档
# [Site/Product] Tracking Plan

## Overview
- Tools: GA4, GTM
- Last updated: [Date]
- Owner: [Name]

## Events

### Marketing Events

| Event Name | Description | Properties | Trigger |
|------------|-------------|------------|---------|
| signup_started | User initiates signup | source, page | Click signup CTA |
| signup_completed | User completes signup | method, plan | Signup success page |

### Product Events
[Similar table]

## Custom Dimensions

| Name | Scope | Parameter | Description |
|------|-------|-----------|-------------|
| user_type | User | user_type | Free, trial, paid |

## Conversions

| Conversion | Event | Counting | Google Ads |
|------------|-------|----------|------------|
| Signup | signup_completed | Once per session | Yes |

## UTM Convention

[Guidelines]
实施代码

提供可直接使用的代码片段

测试清单

具体验证步骤


需要询问的问题

如果你需要更多背景信息:

  1. 你正在使用哪些工具(GA4、Mixpanel 等)?
  2. 你想跟踪哪些关键操作?
  3. 这些数据将用于哪些决策?
  4. 由谁实施——开发团队还是市场团队?
  5. 是否有隐私/同意要求?
  6. 目前已经跟踪了哪些内容?

相关技能

  • ab-test-setup:用于实验跟踪
  • seo-audit:用于自然流量分析
  • page-cro:用于转化优化(使用此数据)

评论

支持 Markdown