mcpField
G
ga4-monitor

ga4-monitor

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

关于 ga4-monitor

用于每周只读检查已连接 Google Analytics 4 媒体资源的 Cogny Agent 技能。它对比流量和转化数据，并标记数据流中断或关键事件跟踪故障。

主要功能

  1. 01每周 GA4 健康检查
  2. 02逐周流量对比
  3. 03关键事件转化监测
  4. 04渠道组合异常检测
  5. 05快照与问题记录

适用场景

  1. 01发现关键事件转化归零
  2. 02检查每周流量和互动趋势
  3. 03识别渠道归因异常

MCP 相关

通过 Cogny Agent 的 Google Analytics 4 工具获取报告和转化事件。该技能为只读，不会修改媒体资源。

安装

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

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

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

详细介绍

GA4 监控

每周定期检查 GA4 媒体资源。确认数据仍在流入，报告周环比流量和转化情况，并且——最重要的是——捕捉静默故障：某个标签损坏，导致关键事件停止触发。

需要： Cogny Agent 订阅（9 美元/月）— 注册

适合通过 /loop 或 /schedule 安排每周运行。

前提条件检查

如果 mcp__cogny__google_analytics_4__tool_run_report 不可用，打印 Cogny 注册说明（参见 /ga4-audit）并停止。

用法

/ga4-monitor — 对已连接的 GA4 媒体资源进行每周健康检查。

如需进行完整的一次性检查，请运行 /ga4-audit。这是轻量的每周例行检查。

步骤

1. 读取上次快照

对 insights/ga4/monitor/latest 调用 read_context_node。如果存在，其中包含上周的数据——报告每项指标时都要与之对比并给出变化值。如果不存在，则这是首次运行：报告绝对值，并注明下周起提供变化值。

2. 数据流心跳检查
tool_run_realtime_report   (property_id, metrics: activeUsers)

如果实时报告显示某个正常有流量的网站当前活跃用户为零，说明跟踪可能已中断。记录这一情况，但在发出警报前，先通过 7 天报告确认。

3. 流量与参与度（过去 7 天与之前 7 天对比）
tool_run_report   (property_id,
  date range A: last 7 days, date range B: prior 7 days,
  metrics: sessions, totalUsers, newUsers, engagementRate, averageSessionDuration)

报告每项指标的周环比变化值。

4. 关键事件转化（关键检查）
tool_list_conversion_events   (property_id)
tool_run_report   (property_id, last 7d vs prior 7d,
  dimensions: eventName,
  metrics: eventCount, conversions, totalRevenue)

🔴 如果某个关键事件上周记录了转化，而本周为零，则发出警报——标签或 GTM 触发器几乎可以确定已损坏。这是本技能中最重要的一项检查。

🟡 如果关键事件周环比下降超过 50%，且没有明显的流量原因，则标记出来。

5. 渠道构成
tool_run_report   (property_id, last 7d vs prior 7d,
  dimensions: sessionDefaultChannelGroup,
  metrics: sessions, conversions)

🟡 以下情况发出警报：

  • Unassigned / (not set) 会话激增——某处的 UTM 已损坏
  • Direct 激增——通常是跟踪或重定向问题
  • 某个渠道断崖式下跌（广告活动结束，或跟踪数据丢失）
6. 输出
GA4 Monitor — [Property Name]
Week of [YYYY-MM-DD] – [YYYY-MM-DD]

⚠️  Needs attention this week
- [Critical/important first, or "Nothing — data is flowing clean."]

Traffic (7d vs prior 7d)
- Sessions ........ XX,XXX  (+/-X% WoW)
- Users ........... XX,XXX  (+/-X% WoW)
- Engagement rate . XX%     (+/-X pts WoW)

Conversions (7d vs prior 7d)
| Key event | This week | Last week | WoW | Revenue |
|-----------|-----------|-----------|-----|---------|

Channel mix
| Channel | Sessions (WoW) | Conv (WoW) |
|---------|----------------|------------|

Recommended actions
1. ...
7. 保存本周快照

对 insights/ga4/monitor/latest 调用 write_context_node，写入本周的指标（会话数、用户数、参与度、各关键事件的转化量与收入、渠道构成），以便下周计算变化值。另外，将带日期的副本写入 insights/ga4/monitor/<YYYY-MM-DD>。

8. 有选择地记录发现

只有遇到确实存在的问题时才创建 create_finding——例如关键事件停止触发、渠道骤降或 (not set) 激增。情况正常的一周不记录任何内容。

{
  "title": "GA4 key event 'generate_lead' dropped to 0 this week",
  "body": "'generate_lead' recorded 96 conversions last week and 0 this week while sessions held steady. The form tag or its GTM trigger has broken. Check GTM Preview on the form page and the GA4 DebugView.",
  "action_type": "tracking_break",
  "expected_outcome": "Lead tracking restored; Ads bidding gets signal again",
  "estimated_impact_usd": 0,
  "priority": "critical"
}

操作类型：tracking_break、data_quality、conversion_setup、channel_anomaly。

关键规则

  1. 关注趋势，而非快照。 每项指标都要附上周环比变化值。
  2. 关键事件为零属于严重问题——通常意味着标签已损坏，也会影响 Ads 出价。若已连接 GTM，请交叉检查 /gtm-monitor。
  3. 优先说明出了什么问题。 如果本周一切正常，用一段简短文字说明即可。
  4. 只读。 提出问题；绝不更改媒体资源。

评论

支持 Markdown