analytics-tracking

帮助用户设置、审计和优化 GA4 事件跟踪与转化，提升数据分析质量。

已扫描

项目

内容

适合谁

数字营销人员、网站运营与增长团队

不适合谁

无 Google Analytics 使用经验的新手、无需数据分析的纯内容创作者

国内可用性

需网络配置。可能需要网络配置或第三方服务可访问。

安装难度

新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

复制命令安装

openclaw skills install @kostja94/analytics-tracking-analytics

官方 ZIP下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

分析：追踪

指导分析实现：GA4 设置、事件追踪、转化跟踪及数据质量。适用于跨营销渠道的网页和应用追踪。

调用时机：首次使用时，若有必要，以 1-2 句话说明本技能涵盖的内容及其重要性，然后提供主要输出；后续使用或用户要求跳过时，直接进入主要输出。

用户 ID

目的：跨设备、跨会话的用户识别
实现方式：在用户被识别后（如登录）设置 user_id，并发送至 GA4
优势：跨会话准确归因；更精准的受众构建

CTA 归因（文章投资回报率）

追踪关键文章上的 CTA 点击，以衡量内容投资回报率：

操作	目的
每个 CTA 发送事件	例如 `cta_click`，包含 `content_url`、`content_type` 参数
标记为转化	在 GA4 中标记为转化以用于归因
用途	对比表现优劣文章；优化 CTA 位置与文案

参见 seo-monitoring 了解文章数据库及基准参考信息。

基础设施要求

组件	目的
数据仓库	集中化数据存储；支持商业智能报告
事件追踪	用户行为记录；漏斗路径分析
归因	广告像素；归因模型；从曝光到成交的追踪

优化流程：清洗 UTM 参数 + 转化事件 → 生成归因报告 → 比较各渠道的归因转化数 → 调整预算分配至带来实际效果的广告/渠道。不一致的 UTM 会破坏数据完整性；多触点归因需要可靠的触点数据支持。

适用范围

GA4：网页数据流、gtag.js、配置管理
用户 ID：跨设备、跨会话识别
CTA 归因：按文章的转化追踪，用于内容 ROI 分析
事件：推荐事件与自定义事件
转化：关键事件及其参数
数据质量：命名规范、测试与验证

GA4 设置

前置条件

已创建 Google Analytics 属性及网页数据流
所有页面均已部署 Google 标签（gtag.js）
已获取测量 ID（如 G-XXXXXXXXXX）

增强测量功能

在「管理员」>「数据流」>「增强测量」中启用，可自动追踪以下行为：

页面浏览、滚动、外链点击
站内搜索、文件下载
视频互动（YouTube）

事件追踪

事件类型

类型	描述
自动收集	`page_view`、`first_visit`、`session_start`
增强测量	滚动、点击、文件下载等
推荐事件	`purchase`、`sign_up`、`search` 等
自定义事件	企业特定业务动作

命名规范

长度限制：不超过 40 个字符（GA4 硬性限制；超出将不被记录）
格式：使用 snake_case，全小写
动词优先：如 download_pdf、submit_form、video_play
上下文清晰：如 pricing_page_scroll 而非通用的 scroll

gtag.js 语法

gtag('event', '<event_name>', {
  <parameter_name>: <value>,
  // 例如：value: 99.99, currency: 'USD'
});

放置于 Google 标签代码之后。事件可在页面加载时触发，或由用户操作（如按钮点击）触发。

事件	使用场景	关键参数
`purchase`	电商交易	value, currency, items
`sign_up`	注册行为	method
`login`	登录行为	method
`search`	站内搜索	search_term
`view_item`	商品查看	items
`add_to_cart`	加入购物车	items

自定义事件

聚焦于 15-25 个与核心指标对齐的重要事件
添加参数以提供上下文（如 content_type、item_id）
避免过度追踪；优先保证质量而非数量

转化设置（关键事件）

在 GA4 管理后台将重要事件标记为转化
用于归因分析、受众构建及报告
典型转化事件包括：购买、注册、线索、联系

归因与转化优化

归因模型决定转化信用如何在各个触点间分配。利用归因数据优化广告与增长渠道。

模型	使用场景
数据驱动（GA4 默认）	机器学习根据实际贡献分配信用；适合多触点旅程
最后点击	100% 归于最终触点；简单但可能低估认知与考虑阶段的作用

优化流程：清洗 UTM（source、medium、campaign）+ 转化事件 → 查看 GA4 归因报告 → 按归因转化数比较渠道表现 → 将预算重新分配给真正带来结果的广告/渠道。不一致的 UTM 会破坏数据准确性；多触点归因依赖高质量的触点数据。

参考资料：[UTM.io – 营销归因中的 UTM](https://web.utm.io/blog/utms-for-marketing-attribution/)，[GA4 – 开始使用归因](https://support.google.com/analytics/answer/10596866)

测试与验证

工具	用途
实时报告	实时查看事件是否触发
DebugView	详细检查事件与参数；需开启调试模式
GA4 调试模式	`gtag('config', 'G-XXX', { 'debug_mode': true });` 或通过 GTM 预览模式

上线前务必测试；确认参数与命名正确
检查是否存在重复事件、缺失值等问题

输出格式

事件列表（名称、触发条件、参数）
实现说明（使用 gtag 还是 GTM）
转化映射表
测试检查清单