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