/ga4-audit

name: ga4-audit
description: Google Analytics 4 configuration and data-quality audit — key events, data streams, custom dimensions, attribution, retention, PII, Ads link, BigQuery export
version: "1.1.2"
author: Cogny AI
requires: cogny-mcp
platforms: [google-analytics-4, plausible, fathom-analytics, simple-analytics, shopify, woocommerce]
user-invocable: true
argument-hint: "[full|config|events|data-quality]"
allowed-tools:
  - mcp__cogny__refresh_mcp_discovery
  - mcp__cogny__mcp__Google_Analytics_4__tool_list_account_summaries
  - mcp__cogny__mcp__Google_Analytics_4__tool_get_property
  - mcp__cogny__mcp__Google_Analytics_4__tool_list_data_streams
  - mcp__cogny__mcp__Google_Analytics_4__tool_list_conversion_events
  - mcp__cogny__mcp__Google_Analytics_4__tool_list_custom_dimensions
  - mcp__cogny__mcp__Google_Analytics_4__tool_list_custom_metrics
  - mcp__cogny__mcp__Google_Analytics_4__tool_get_metadata
  - mcp__cogny__mcp__Google_Analytics_4__tool_run_report
  - mcp__cogny__mcp__Google_Analytics_4__tool_list_google_ads_links
  - mcp__cogny__mcp__Google_Tag_Manager__tool_list_accounts
  - mcp__cogny__mcp__Google_Tag_Manager__tool_list_containers
  - mcp__cogny__mcp__Google_Tag_Manager__tool_list_workspaces
  - mcp__cogny__mcp__Google_Tag_Manager__tool_list_tags
  - mcp__cogny__mcp__Plausible__aggregate
  - mcp__cogny__mcp__Fathom_Analytics__aggregate
  - mcp__cogny__mcp__Simple_Analytics__stats
  - mcp__cogny__mcp__Shopify__tool_list_orders
  - mcp__cogny__mcp__WooCommerce__get_sales_report
  - mcp__cogny__list_integrations
  - mcp__cogny__create_finding
  - mcp__cogny__create_ticket
  - WebFetch
  - WebSearch

GA4 Audit

A one-time audit of a Google Analytics 4 property — configuration *and* data quality. GA4 collects data the moment the tag fires, but most properties quietly leak trust: unmarked key events, PII in parameters, no Ads link, `(not set)` traffic. This skill finds those before they corrupt a quarter of reporting.

**Requires:** Cogny Agent subscription ($9/mo) — [Sign up](https://cogny.com)

Works with

| Job | Primary | Also answered by (enhanced when connected) | |-----|---------|---------------------------------------------| | Property config, key events, dimensions, Ads link | GA4 | — (only GA4 has a config API) | | Fix a missing / noisy key event (asks first, if exposed) | GA4 `tool_mark_key_event`, `tool_unmark_key_event` | GA4 UI (Admin → Events → Mark as key event) when the tools aren't exposed | | Parameters the tags send | GTM `tool_list_tags` | — (ask the user for the tracking plan) | | Consent / ad-blocker gap | GA4 users | Plausible `aggregate`, Fathom `aggregate`, Simple Analytics `stats` | | Purchase capture rate | GA4 `purchase` count | Shopify `tool_list_orders`, WooCommerce `get_sales_report` |

Cookieless tools (Plausible, Fathom, Simple) and the store count what GA4 misses, so they turn "data quality" from guesswork into a measured gap.

Prerequisites Check

If no `mcp__cogny__*` tools exist (no `list_integrations`, no `cogny_status`), print this and stop:

GA4 Audit needs your marketing data through Cogny's MCP gateway.

1. Sign up at https://cogny.com and connect Google Analytics 4 (Google Tag Manager optional).
2. Add Cogny to .mcp.json in your project:
   {"mcpServers": {"cogny": {"type": "http", "url": "https://app.cogny.com/mcp"}}}
3. Restart Claude Code; it opens a browser for the OAuth login on first use.

Nothing to run without Cogny: GA4's configuration is only readable through its API.

If Cogny is connected but `mcp__cogny__mcp__Google_Analytics_4__tool_get_property` isn't, say "connect Google Analytics 4 in Cogny" and stop.

**Health check:** call `list_integrations`, then `tool_list_account_summaries` as the cheap read (and GTM `tool_list_accounts` if GTM is connected). `health_status` misses revoked tokens, so a 401, Forbidden or scope error is 🔴 "reconnect <integration>"; don't retry it. If a tool named here is missing, call `refresh_mcp_discovery` once; new tools only load after the client reconnects, so use the step's fallback for this run and mark it ⚠ "needs reconnect".

Usage

`/ga4-audit` — full property audit `/ga4-audit config` — property + stream + link settings only `/ga4-audit events` — events, key events, custom dimensions only `/ga4-audit data-quality` — `(not set)`, PII, anomaly checks only

Steps

1. Property discovery

tool_list_account_summaries
tool_get_property        (property_id)

Record: time zone, currency, industry category, and property type.

**Data retention: not verifiable via API — ask the user.** `tool_get_property` has no retention field. Ask them to check Admin → Data collection and modification → Data retention, and flag it if it's at the 2-month default (it should be 14 months so year-over-year exploration works). Mark it "unverified" in the report until they confirm.

2. Data streams

tool_list_data_streams   (property_id)

Flag:

• Multiple web streams for one site (splits data, double-counts users)
• Missing iOS/Android streams for a business that has apps
• Enhanced measurement settings: **not verifiable via API — ask the user** (the stream

response has no enhanced-measurement data). Infer what you can from the event list in step 3 (`scroll`, `file_download`, `view_search_results`, `video_start`, `form_start` present or absent), and label it as inferred.

3. Key events (conversions)

tool_list_conversion_events   (property_id)
tool_run_report   (property_id,
  date_ranges: [{"startDate": "30daysAgo", "endDate": "yesterday"}],
  dimensions: ["eventName"], metrics: ["eventCount", "keyEvents"])

The report shows which events actually fire and which key events recorded anything. Step 2's enhanced-measurement inference reads from it.

Flag:

• **No key events configured** — Ads bidding and GA4 reporting both lose their anchor
• Key events marked on noisy automatic events (`page_view`, `scroll`) — inflates the

conversion count and