common-metric-names

common-metric-names is a skill for Claude Code from surendranb/google-analytics-mcp. It costs 39 tokens per session (1,184 once invoked), scanned A, original, MIT.

A reference for the exact metric and dimension names used by the Google Analytics 4 Data API. It translates everyday terms such as users, page views, and conversions into the names the API accepts.

In plain words
What is it for?
Use it before writing GA4 queries for users, active users, page views, engagement, traffic sources, or key events.
Why use it?
It prevents requests from failing because they use old Universal Analytics names or informal labels. It also notes that GA4 now calls conversions key events.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the google-analytics-mcp plugin — 16 skills, 1 MCP server shipped together

Good fit Use it before writing GA4 queries for users, active users, page views, engagement, traffic sources, or key events.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/surendranb/google-analytics-mcp/common-metric-names
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add surendranb/google-analytics-mcp --skill common-metric-names
Clone the repo
git clone --depth 1 https://github.com/surendranb/google-analytics-mcp

Made for: Claude Code.

Or install google-analytics-mcp, the plugin that ships this one along with the rest of its 16 skills, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for common-metric-names

README.md
[![agentmods](https://agentmods.dev/badge/skills/surendranb/google-analytics-mcp/common-metric-names/github.svg)](https://agentmods.dev/skills/surendranb/google-analytics-mcp/common-metric-names)
Your own site
<a href="https://agentmods.dev/skills/surendranb/google-analytics-mcp/common-metric-names"><img src="https://agentmods.dev/badge/skills/surendranb/google-analytics-mcp/common-metric-names/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for common-metric-names

Your own site · 80×15
<a href="https://agentmods.dev/skills/surendranb/google-analytics-mcp/common-metric-names"><img src="https://agentmods.dev/badge/skills/surendranb/google-analytics-mcp/common-metric-names.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 39 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,184 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00039 $0.01184
Opus 5 $0.00019 $0.00592
Sonnet 5 $0.00008 $0.00237
Haiku 4.5 $0.00004 $0.00118

Measured 11d ago against content hash 924e0a34a4f5, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

common-metric-names scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/common-metric-names/SKILL.md · 75 lines

How it starts

The opening of the file, as written. The whole thing — 75 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Common Metric & Dimension Names

The correct GA4 Data API names for fields models most often get wrong. Use these before calling get_ga4_data — wrong names return a hard error.

⚠️ YOUR TRAINING DATA IS OUTDATED: Universal Analytics was sunset 2023-07-01, and on 2024-05-06 Google Analytics 4 renamed all conversion metrics to "key events" (conversionskeyEvents, conversionRatesessionKeyEventRate). Querying conversions will fail with an Invalid metric error. Always use keyEvents.

Metrics — correct API names

What you mean Wrong (will fail) Correct API name
Goal completions / conversions (RENAMED 2024) conversions, goals, conversion keyEvents
Total users users, totalVisitors totalUsers
Active users (rolling 30-day ≈ MAU) MAU, monthlyActiveUsers, activeVisitors active28DayUsers
Active users (rolling 7-day ≈ WAU) WAU, weeklyActiveUsers active7DayUsers
Active users (rolling 1-day ≈ DAU) DAU, dailyActiveUsers active1DayUsers
Distinct users in the queried range uniqueUsers activeUsers
Page views pageViews, pageviews, page_views screenPageViews
E-commerce purchases purchases, transactions ecommercePurchases
Product views itemViews, productViews itemsViewed
Items added to cart addToCarts, cartAdds itemsAddedToCart
Revenue revenue, ecommerceRevenue purchaseRevenue
Avg session duration avgSessionDuration, avgTimeOnSite averageSessionDuration
Total engagement time engagementDuration, timeOnSite userEngagementDuration
Session key event rate (was "conversion rate", renamed 2024) conversionRate, goalConversionRate, sessionConversionRate sessionKeyEventRate
User key event rate userConversionRate userKeyEventRate
Engaged sessions qualifiedSessions, validSessions engagedSessions
Pages per session pagesPerSession, pageDepth screenPageViewsPerSession

Read the full file on GitHub · 75 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 75 lines · 39 tokens per session scan A 924e0a34a4f5

Subscribe to this mod's changes

common-metric-names is a skill published in the GitHub repository surendranb/google-analytics-mcp (241 stars, last pushed yesterday), licensed MIT. It adds 39 tokens to every session and 1,184 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

salesforce-cli

Safety-first Salesforce CLI skill wrapping sf (v2). This skill should be used when performing Salesforce operations — SOQL/SOSL queries, metadata deploy/retrieve, data import/export, Apex execution, org management, auth, and platform events. Enforces risk classification w/ mandatory confirmation for all…

georgekhananaev/claude-skills-vault · 86 tokens

fastapi-senior-dev

Senior Python Backend Engineer skill for FastAPI. Use when scaffolding production-ready APIs, enforcing clean architecture, optimizing async patterns, or auditing FastAPI codebases.

georgekhananaev/claude-skills-vault · 39 tokens

firebase-cli

Safety-first Firebase CLI (firebase-tools v15) skill for full project control — deploy, Hosting (sites/channels/rollback), Cloud Functions (+secrets), Firestore (databases/indexes/backups/delete), Realtime Database, Auth import/export, Remote Config, App Distribution, App Hosting, Extensions, Data Connect, Emulator…

georgekhananaev/claude-skills-vault · 172 tokens

pydantic-model

Pydantic v2 model patterns for req/res validation, MongoDB conversion, validation rules. Travel Panel conventions.

georgekhananaev/claude-skills-vault · 28 tokens

nextjs-senior-dev

Senior Next.js 15+/16 Engineer skill for App Router. Use when scaffolding production apps, enforcing RSC patterns, auditing codebases, or optimizing performance.

georgekhananaev/claude-skills-vault · 40 tokens

supabase-cli

CLI automation for Supabase development workflows. Provides scripts for migrations, Edge Functions, secrets management, type generation, and SQL execution with safety checks.

georgekhananaev/claude-skills-vault · 33 tokens