ga4-monitor

name	ga4-monitor
description	Weekly GA4 check — sessions, users, key-event conversions, revenue, channel mix — with week-over-week deltas and tracking-break alerts
version	1.0.0
author	Cogny AI
requires	cogny-mcp
platforms	["google-analytics-4"]
user-invocable	true
argument-hint
allowed-tools	["mcp__cogny__google_analytics_4__tool_list_account_summaries","mcp__cogny__google_analytics_4__tool_get_property","mcp__cogny__google_analytics_4__tool_list_conversion_events","mcp__cogny__google_analytics_4__tool_run_report","mcp__cogny__google_analytics_4__tool_run_realtime_report","mcp__cogny__create_finding","mcp__cogny__write_context_node","mcp__cogny__read_context_node","WebFetch"]

GA4 Monitor

A recurring weekly check on a GA4 property. It confirms data is still flowing, reports traffic and conversions week-over-week, and — most importantly — catches the silent failure mode: a key event that stopped firing because a tag broke.

Requires: Cogny Agent subscription ($9/mo) — Sign up

Designed to be scheduled weekly via /loop or /schedule.

Prerequisites Check

If mcp__cogny__google_analytics_4__tool_run_report is not available, print the Cogny sign-up instructions (see /ga4-audit) and stop.

Usage

/ga4-monitor — weekly health check of the connected GA4 property.

For a full one-time review, run /ga4-audit. This is the light weekly rhythm.

Steps

1. Read the prior snapshot

Call read_context_node on insights/ga4/monitor/latest. If present, it holds last week's numbers — report every metric as a delta against it. If absent, this is the first run: report absolutes and note deltas begin next week.

2. Data-flow heartbeat

tool_run_realtime_report   (property_id, metrics: activeUsers)

If realtime shows zero active users on a site with normal traffic, tagging may be down. Note it, but confirm against the 7-day report before alarming.

3. Traffic & engagement (last 7d vs prior 7d)

tool_run_report   (property_id,
  date range A: last 7 days, date range B: prior 7 days,
  metrics: sessions, totalUsers, newUsers, engagementRate, averageSessionDuration)

Report each metric with its WoW delta.

4. Key-event conversions (the critical check)

tool_list_conversion_events   (property_id)
tool_run_report   (property_id, last 7d vs prior 7d,
  dimensions: eventName,
  metrics: eventCount, conversions, totalRevenue)

🔴 Alert if any key event recorded conversions last week and zero this week — the tag or GTM trigger has almost certainly broken. This is the single most important check in the skill.

🟡 Flag key events that dropped >50% WoW without an obvious traffic cause.

5. Channel mix

tool_run_report   (property_id, last 7d vs prior 7d,
  dimensions: sessionDefaultChannelGroup,
  metrics: sessions, conversions)

🟡 Alert on:

• A jump in Unassigned / (not set) sessions — UTMs broke somewhere
• A Direct spike — often a tagging or redirect problem
• A channel that fell off a cliff (campaign ended, or tracking lost)

6. Output

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. Save this week's snapshot

Call write_context_node on insights/ga4/monitor/latest with this week's metrics (sessions, users, engagement, per-key-event conversions + revenue, channel mix) so next week can compute deltas. Also write a dated copy to insights/ga4/monitor/<YYYY-MM-DD>.

8. Record findings — selectively

Only file a create_finding for genuine problems — a key event that stopped, a channel that collapsed, a (not set) spike. A clean week files nothing.

{
  "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"
}

Action types: tracking_break, data_quality, conversion_setup, channel_anomaly.

Critical rules

1. Trends over snapshots. Every metric ships with a WoW delta.
2. A key event at zero is critical — it usually means a broken tag, and it corrupts Ads bidding too. Cross-check /gtm-monitor if GTM is connected.
3. Lead with what's broken. A clean week is one short paragraph.
4. Read-only. Surface issues; never change the property.