mcpField
G
ga4-audit

ga4-audit

github.com/cognyai营销与增长11149 次安装2 周前更新
代码仓库

关于 ga4-audit

GA4 Audit 是一次性检查 Google Analytics 4 属性配置和数据质量的技能。它帮助分析人员发现设置缺口、报告问题及可能收集的个人信息，并记录只读检查结果与建议。

主要功能

  1. 01检查属性与数据流设置
  2. 02核查关键事件和自定义维度
  3. 03查看流量与数据质量信号
  4. 04标记数据中可能存在的个人信息
  5. 05只记录发现项，不修改设置

适用场景

  1. 01报告前审计 GA4 属性
  2. 02发现转化事件配置缺口
  3. 03排查较高的 `(not set)` 或 Direct 流量
  4. 04识别事件参数中可能存在的个人信息

MCP 相关

该技能需要 Cogny 的 Google Analytics 4 MCP 服务，并使用其工具检查属性、数据流、事件、维度、元数据和报告。它仅执行只读操作，不会更改属性设置。

安装

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

$npx skills add https://github.com/cognyai/claude-code-marketing-skills --skill ga4-audit

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

详细介绍

GA4 审计

对 Google Analytics 4 媒体资源进行一次性审计——涵盖配置 和 数据质量。 GA4 会在代码触发时立即收集数据，但大多数媒体资源会悄悄损害数据可信度： 未标记的关键事件、参数中的 PII、未关联 Ads、流量显示为 (not set)。此技能 会在这些问题影响一个季度的报告之前将其找出。

**要求：**Cogny Agent 订阅（$9/mo）——注册

前置条件检查

如果 mcp__cogny__google_analytics_4__tool_get_property 不可用：

This skill requires Cogny's Google Analytics 4 MCP server.

1. Sign up at https://cogny.com/agent
2. Connect your GA4 property
3. Add Cogny to your .mcp.json (see the repo README)
4. Restart Claude Code

如果缺少这些工具，请在此处停止。

用法

/ga4-audit — 完整媒体资源审计 /ga4-audit config — 仅检查媒体资源、数据流和关联设置 /ga4-audit events — 仅检查事件、关键事件和自定义维度 /ga4-audit data-quality — 仅检查 (not set)、PII 和异常

步骤

1. 发现媒体资源
tool_list_account_summaries
tool_get_property        (property_id)

记录：时区、币种、行业类别、数据保留设置和媒体资源类型。若数据保留 仍为默认的 2 个月，请标记——应设为 14 个月，才能进行同比探索。

2. 数据流
tool_list_data_streams   (property_id)

标记：

  • 一个网站存在多个 Web 数据流（会拆分数据并重复计算用户数）
  • 增强型衡量已关闭，或正在衡量团队实际上不需要的事件
  • 有应用的业务缺少 iOS/Android 数据流
3. 关键事件（转化）
tool_list_conversion_events   (property_id)

标记：

  • 未配置关键事件——Ads 出价和 GA4 报告都会失去衡量基准
  • 将嘈杂的自动事件（page_view、scroll）标记为关键事件——会抬高 转化次数并误导所有人
  • 明显的业务目标未标记为关键事件（例如 generate_lead、purchase、 sign_up）
  • 关键事件超过约 10–15 个——如果所有事情都是转化，就等于没有转化
4. 自定义维度和指标
tool_list_custom_dimensions   (property_id)
tool_list_custom_metrics      (property_id)
tool_get_metadata             (property_id)

标记：

  • 标签收集了事件参数，但从未注册为自定义维度 （这些数据在报告中不可见）——将 get_metadata 与数据流发送的内容进行对比
  • 接近事件范围维度 50 个 / 用户范围维度 25 个的上限
  • 已注册的高基数维度（时间戳、ID）——会导致出现 (other) 行
5. 流量和数据质量报告
tool_run_report   (property_id, last 30 days,
  dimensions: sessionDefaultChannelGroup, sessionSource, sessionMedium,
  metrics: sessions, conversions, totalUsers)

标记：

  • Unassigned 或 (not set) 占比很高——UTM 损坏或标记存在遗漏 （引导用户使用 /utm-builder）
  • Direct 占比超过约 40%——通常是引荐来源数据丢失或缺少标签
  • 自引荐（来源为你自己的域名）——需要添加非预期引荐过滤器
  • 报告中出现内部流量——未应用内部流量过滤器
6. PII 和政策检查

扫描 get_metadata 中的事件和参数名称，查找可能包含个人数据的内容—— 参数中的 email、phone、user_email、全名、原始地址，或页面路径/查询字符串中的 相关内容。

🔴 GA4 中包含 PII 违反 Google 的政策，且可能导致媒体资源被删除。请将其标记为 严重问题，并指出确切的参数。

7. 集成

标记：

  • 未关联 Google Ads——转化数据无法传递到 Ads 用于出价（请与用户确认；API 不一定能显示此关联）
  • 未导出到 BigQuery——任何需要分析原始数据的媒体资源都建议启用导出 （/ga4-bigquery-schema 介绍了架构）
  • 未关联 Search Console
8. 评分和报告
GA4 Audit — [Property Name]
GA4 Health Score: X/100

Score breakdown:
  Configuration ...... X/20   (streams, retention, time zone)
  Key events ......... X/25   (the reporting + bidding anchor)
  Custom dimensions .. X/15
  Data quality ....... X/25   ((not set), Direct, self-referrals)
  Compliance ......... X/15   (PII, internal traffic)

🔴 Critical   — PII collected, no key events, retention at 2 months
🟡 Important  — unregistered dimensions, high (not set), no Ads link
🟢 Optimization — BigQuery export, enhanced measurement tuning

Top 3 Actions:
1. [Highest impact]
2. ...
3. ...
9. 记录发现
{
  "title": "Email address captured in GA4 'page_location' — policy violation",
  "body": "The checkout-success URL includes ?email=… and GA4 stores it in page_location and page_path. Google policy prohibits PII in Analytics and can delete the property. Strip the parameter at the tag, or redact it before the event fires.",
  "action_type": "data_quality",
  "expected_outcome": "PII removed from collection; property compliant",
  "estimated_impact_usd": 0,
  "priority": "critical"
}

操作类型：tracking_configuration、conversion_setup、data_quality、 custom_dimension、integration、compliance。

关键规则

  1. **PII 始终属于严重问题。**醒目标记，并指出参数名称。
  2. 关键事件是衡量基准——既用于 GA4 报告，也用于 Ads 出价。请赋予其相应权重。
  3. 引用实际数字：保留月数、(not set) 占比、维度数量。
  4. **只读。**绝不更改媒体资源设置——只呈现问题并提出建议。

评论

支持 Markdown