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"
(conversions → keyEvents, conversionRate → sessionKeyEventRate).
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 |
Dimensions — correct API names
| What you mean |
Wrong (will fail) |
Correct API name |
| Traffic channel group |
sessionDefaultChannelGrouping, channelGrouping |
sessionDefaultChannelGroup |
| Landing page + query |
landingPage (often wrong scope) |
landingPagePlusQueryString |
| Page path |
pagePath, page |
pagePath |
| Page path + query |
pagePathPlusQueryString |
unifiedPagePathScreen |
| Session source |
source (wrong scope — see attribution-scope skill) |
sessionSource |
| Session medium |
medium (wrong scope) |
sessionMedium |
| Device type |
device, deviceType |
deviceCategory |
| Operating system |
os |
operatingSystem |
| Browser |
userAgent |
browser |
| Week of year |
week, weekNumber |
week (this one IS correct) |
Note on active users (MAU / WAU / DAU)
GA4 has no MAU, WAU, DAU, monthlyActiveUsers, or dailyActiveUsers metric —
these hard-error. Use the rolling n-day metrics: active1DayUsers (≈ DAU),
active7DayUsers (≈ WAU), active28DayUsers (≈ MAU). Each counts distinct users
active in the N days ending on that date (a rolling window, not a calendar bucket).
activeUsers = distinct users in the queried range. Never sum daily activeUsers
across rows to get a period total — it double-counts users active on multiple days.
For a monthly total, query activeUsers once over the whole range (no date dimension),
or use active28DayUsers for a rolling month. Stickiness ratios dauPerMau,
dauPerWau, wauPerMau are also available as metrics.
Note on bounce rate
GA4 bounce rate = sessions with NO engaged session (opposite of GA3 logic).
A bounce rate of 60% means 60% of sessions had no engagement — that is high.
In GA3, bounce rate meant single-page sessions. Do not compare GA3 and GA4 bounce rates.
When you hit a schema error
If get_ga4_data returns "Invalid dimension" or "Invalid metric", do not guess
alternatives. Use search_schema with a keyword to find the correct name, or
check this skill's table above.
1---2name: common-metric-names3description: "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."4metadata:5 source: https://skillmd.com/skills/surendranb/common-metric-names6---78# Common Metric & Dimension Names910The correct GA4 Data API names for fields models most often get wrong.11Use these before calling `get_ga4_data` — wrong names return a hard error.1213> ⚠️ **YOUR TRAINING DATA IS OUTDATED**: Universal Analytics was sunset14> 2023-07-01, and on 2024-05-06 Google Analytics 4 renamed all conversion metrics to **"key events"**15> (`conversions` → `keyEvents`, `conversionRate` → `sessionKeyEventRate`).16> Querying `conversions` will fail with an `Invalid metric` error. Always use `keyEvents`.1718## Metrics — correct API names1920| What you mean | Wrong (will fail) | Correct API name |21|---|---|---|22| Goal completions / conversions (RENAMED 2024) | `conversions`, `goals`, `conversion` | `keyEvents` |23| Total users | `users`, `totalVisitors` | `totalUsers` |24| Active users (rolling 30-day ≈ MAU) | `MAU`, `monthlyActiveUsers`, `activeVisitors` | `active28DayUsers` |25| Active users (rolling 7-day ≈ WAU) | `WAU`, `weeklyActiveUsers` | `active7DayUsers` |26| Active users (rolling 1-day ≈ DAU) | `DAU`, `dailyActiveUsers` | `active1DayUsers` |27| Distinct users in the queried range | `uniqueUsers` | `activeUsers` |28| Page views | `pageViews`, `pageviews`, `page_views` | `screenPageViews` |29| E-commerce purchases | `purchases`, `transactions` | `ecommercePurchases` |30| Product views | `itemViews`, `productViews` | `itemsViewed` |31| Items added to cart | `addToCarts`, `cartAdds` | `itemsAddedToCart` |32| Revenue | `revenue`, `ecommerceRevenue` | `purchaseRevenue` |33| Avg session duration | `avgSessionDuration`, `avgTimeOnSite` | `averageSessionDuration` |34| Total engagement time | `engagementDuration`, `timeOnSite` | `userEngagementDuration` |35| Session key event rate (was "conversion rate", renamed 2024) | `conversionRate`, `goalConversionRate`, `sessionConversionRate` | `sessionKeyEventRate` |36| User key event rate | `userConversionRate` | `userKeyEventRate` |37| Engaged sessions | `qualifiedSessions`, `validSessions` | `engagedSessions` |38| Pages per session | `pagesPerSession`, `pageDepth` | `screenPageViewsPerSession` |3940## Dimensions — correct API names4142| What you mean | Wrong (will fail) | Correct API name |43|---|---|---|44| Traffic channel group | `sessionDefaultChannelGrouping`, `channelGrouping` | `sessionDefaultChannelGroup` |45| Landing page + query | `landingPage` (often wrong scope) | `landingPagePlusQueryString` |46| Page path | `pagePath`, `page` | `pagePath` |47| Page path + query | `pagePathPlusQueryString` | `unifiedPagePathScreen` |48| Session source | `source` (wrong scope — see attribution-scope skill) | `sessionSource` |49| Session medium | `medium` (wrong scope) | `sessionMedium` |50| Device type | `device`, `deviceType` | `deviceCategory` |51| Operating system | `os` | `operatingSystem` |52| Browser | `userAgent` | `browser` |53| Week of year | `week`, `weekNumber` | `week` (this one IS correct) |5455## Note on active users (MAU / WAU / DAU)5657GA4 has no `MAU`, `WAU`, `DAU`, `monthlyActiveUsers`, or `dailyActiveUsers` metric —58these hard-error. Use the rolling n-day metrics: `active1DayUsers` (≈ DAU),59`active7DayUsers` (≈ WAU), `active28DayUsers` (≈ MAU). Each counts distinct users60active in the N days *ending on that date* (a rolling window, not a calendar bucket).61`activeUsers` = distinct users in the queried range. Never sum daily `activeUsers`62across rows to get a period total — it double-counts users active on multiple days.63For a monthly total, query `activeUsers` once over the whole range (no date dimension),64or use `active28DayUsers` for a rolling month. Stickiness ratios `dauPerMau`,65`dauPerWau`, `wauPerMau` are also available as metrics.6667## Note on bounce rate6869GA4 bounce rate = sessions with NO engaged session (opposite of GA3 logic).70A bounce rate of 60% means 60% of sessions had no engagement — that is high.71In GA3, bounce rate meant single-page sessions. Do not compare GA3 and GA4 bounce rates.7273## When you hit a schema error7475If `get_ga4_data` returns "Invalid dimension" or "Invalid metric", do not guess76alternatives. Use `search_schema` with a keyword to find the correct name, or77check this skill's table above.