GAGA4 MCPv2.11.9

Agent skill

GA4 Dimensions and Metrics Reference: API Field Names

The Google Analytics 4 (GA4) Data API enforces strict field naming conventions. Universal Analytics was sunset on July 1, 2023, and on May 6, 2024, Google renamed all conversion metrics to key events (conversions → keyEvents).

Querying invalid field names causes a hard 400 error. Use this reference table before constructing queries or prompts.

Metrics Reference Table

Metric IntentLegacy / Invalid Names (Fails)Valid GA4 Data API Name
Conversions / Goal Completionsconversions, goals, conversionkeyEvents
Session Conversion RateconversionRate, sessionConversionRatesessionKeyEventRate
User Conversion RateuserConversionRateuserKeyEventRate
Total Usersusers, totalVisitorstotalUsers
Active UsersuniqueUsers, activeVisitorsactiveUsers
Daily Active Users (DAU)DAU, dailyActiveUsersactive1DayUsers
Weekly Active Users (WAU)WAU, weeklyActiveUsersactive7DayUsers
Monthly Active Users (MAU)MAU, monthlyActiveUsersactive28DayUsers
Pageviewspageviews, pageViews, page_viewsscreenPageViews
Pages per SessionpagesPerSession, pageDepthscreenPageViewsPerSession
E-commerce Purchasespurchases, transactionsecommercePurchases
Product ViewsitemViews, productViewsitemsViewed
Items Added to CartaddToCarts, cartAddsitemsAddedToCart
Purchase Revenuerevenue, ecommerceRevenuepurchaseRevenue
Average Order Value (AOV)revenuePerTransactionaveragePurchaseRevenue
Average Session DurationavgSessionDuration, avgTimeOnSiteaverageSessionDuration
Total Engagement TimeengagementDuration, timeOnSiteuserEngagementDuration
Engaged SessionsqualifiedSessions, validSessionsengagedSessions
Bounce Ratebounce_ratebounceRate

Dimensions Reference Table

Dimension IntentLegacy / Invalid Names (Fails)Valid GA4 Data API Name
Default Channel GroupchannelGrouping, sessionDefaultChannelGroupingsessionDefaultChannelGroup
Traffic Sourcesource, session_sourcesessionSource
Traffic Mediummedium, session_mediumsessionMedium
Source / Medium CombinedsourceMediumsessionSourceMedium
Campaign NamecampaignsessionCampaignName
Page Pathpage, page_pathpagePath
Page Path with QuerypagePathPlusQueryStringunifiedPagePathScreen
Landing PagelandingPagePathlandingPage
Landing Page with QuerylandingPage (when query needed)landingPagePlusQueryString
Page Titletitle, page_titlepageTitle
Device Categorydevice, deviceTypedeviceCategory
Operating SystemosoperatingSystem
BrowseruserAgentbrowser
CountrycountryNamecountry
CitycityNamecity

Active Users Mechanics (DAU / WAU / MAU)

GA4 does not provide literal DAU or MAU metrics. It provides rolling windows:

  • active1DayUsers: Users active in the 1 day ending on that date (DAU).
  • active7DayUsers: Rolling 7-day distinct active users (WAU).
  • active28DayUsers: Rolling 28-day distinct active users (MAU).

Important: Never sum daily activeUsers across rows to compute a monthly total. Summing rows double-counts returning users. Request activeUsers once over the full date range with no date dimension, and GA4 will return the true deduped count.


How to Check Field Names in-Session

If you are unsure of a dimension or metric name for your specific property, ask your agent:

text
search_schema("keyword")

The server queries your live GA4 metadata schema and returns all matching dimensions and metrics with exact API identifiers.