ga4-limitations
Skill244 starsChanged 43 days agoMITView on GitHub
What this MCP **cannot** do via the GA4 Data API, and where to go instead. Attempting these will either fail or produce meaningless aggregate data.
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 29
Attribution modeling comparisons: not directly queryable — data-driven vs last-click is set at the property level, not a query-time …
≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
GA4 API Limitations
What this MCP cannot do via the GA4 Data API, and where to go instead. Attempting these will either fail or produce meaningless aggregate data.
Not available via this MCP
| Analysis type | Why not available | Where to do it instead |
| Funnel analysis (drop-off by step) | runFunnelReport exists in the API but is not exposed by this MCP | GA4 UI → Explore → Funnel Exploration |
| Cohort retention (week N return rate) | runCohortReport not exposed | GA4 UI → Explore → Cohort Exploration |
| User path / flow analysis | Not available in aggregate API | GA4 UI → Explore → Path Exploration |
| Per-user event sequences | API returns aggregate rows only — no individual user journeys | BigQuery export (raw events) |
| Real-time custom breakdowns | Realtime API is limited to last 30 minutes, basic dimensions | GA4 UI → Realtime report |
| Raw event-level data | Data API aggregates; no row-level access | BigQuery export |
| Segment overlap / Venn analysis | Not a native API feature | BigQuery or GA4 Explore comparisons |
| Custom channel group definitions | Read-only via API; custom groups must be created in UI | GA4 UI → Admin → Custom Channel Groups |
What IS available (and often underused)
- Period-over-period in one call: pass two
date_ranges— GA4 returns both periods in a single response (usedate_range_start/date_range_endfor each; call twice if two-range isn't supported) - Ecommerce metrics: full purchase funnel metrics (
itemsViewed,itemsAddedToCart,itemsPurchased,purchaseRevenue,cartToViewRate) — aggregate only, not per-session funnel - Search Console integration: available as a linked report in GA4 UI but the Search Console data is on a separate API — not queryable via this MCP (use Google Search Console API directly)
- Custom dimensions and metrics: available if defined in the property — they appear in the schema alongside standard fields
- Attribution modeling comparisons: not directly queryable — data-driven vs last-click is set at the property level, not a query-time parameter
When a user asks for funnel or cohort analysis
Tell them: the GA4 Data API returns aggregate metrics, not event sequences. For funnel drop-off between specific steps, use GA4 Explore → Funnel Exploration. For cohort retention (week 1 / week 2 return), use GA4 Explore → Cohort Exploration. These analyses require the GA4 UI or a BigQuery export, not the Data API.
In this repository21 other files it gives its agents.
- AGENTS.mdAGENTS.md
- docs/llms-full.txtllms.txt
- docs/llms.txtllms.txt
- llms.txtllms.txt
- ga4-analyticsSkill
- ai-referral-analysisSkill
- attribution-scopeSkill
- bot-traffic-detectionSkill
- channel-acquisitionSkill
- common-metric-namesSkill
- compatible-combinationsSkill
- content-performanceSkill
- custom-dimensionsSkill
- date-rangesSkill
- ecommerce-analysisSkill
- filter-structuresSkill
- gcp-setupSkill
- geo-device-segmentationSkill
- gcp-setupSkill
- traffic-diagnosisSkill
- ua-to-ga4Skill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.