Field reference

The GA4 fields that carry almost every report.

GA4 exposes hundreds of fields; day-to-day reporting runs on a few dozen. These are the ones, with the API names your calculated fields will need.

Fields
41
Data source
Google Analytics 4
Names
Standard API

See them live in the Google Analytics 4 Dashboard for Data Studio.

Traffic metrics

FieldAPI nameTypeWhat it measures
SessionssessionsmetricVisits: periods of activity, started by the session_start event.
Total userstotalUsersmetricDistinct users who logged any event in the period.
Active usersactiveUsersmetricDistinct users with an engaged session or first visit; GA4’s headline “Users”.
New usersnewUsersmetricUsers whose first-ever visit fell inside the period.
ViewsscreenPageViewsmetricPage views plus app screen views, repeats included.

Engagement metrics

FieldAPI nameTypeWhat it measures
Engaged sessionsengagedSessionsmetricSessions that lasted 10s+, had a key event, or viewed 2+ pages.
Engagement rateengagementRatemetricEngaged sessions divided by sessions; the inverse of bounce rate.
Bounce ratebounceRatemetricShare of sessions that were not engaged. Defined differently than in Universal Analytics.
Avg. session durationaverageSessionDurationmetricMean session length in seconds.
Event counteventCountmetricTotal events logged; everything in GA4 is an event.
Key eventskeyEventsmetricEvents you marked as important (renamed from “conversions” in 2024).

Acquisition dimensions

FieldAPI nameTypeWhat it measures
Default channel groupsessionDefaultChannelGroupdimensionGoogle’s channel classification per session: Organic Search, Paid Search, Direct, Referral…
Session sourcesessionSourcedimensionWhere the session came from (google, newsletter, a referring domain).
Session mediumsessionMediumdimensionHow it arrived: organic, cpc, email, referral.
Session campaignsessionCampaignNamedimensionCampaign name from tagged URLs or Google Ads.

Content dimensions

FieldAPI nameTypeWhat it measures
Landing pagelandingPagedimensionFirst page of the session; the page that won the visit.
Page pathpagePathdimensionPath of the viewed page, without domain or query string.
Page titlepageTitledimensionThe page’s <title> at view time.

Audience dimensions

FieldAPI nameTypeWhat it measures
CountrycountrydimensionUser’s country, resolved from IP.
CitycitydimensionUser’s city; the field local SEO reports pivot on.
Device categorydeviceCategorydimensionDesktop, mobile or tablet.
BrowserbrowserdimensionBrowser the session ran in.
DatedatedimensionDay of the event, in the property’s timezone.

Ecommerce metrics

FieldAPI nameTypeWhat it measures
Total revenuetotalRevenuemetricAll revenue: purchases, subscriptions and ads, minus refunds.
Purchase revenuepurchaseRevenuemetricRevenue from purchase events specifically.
TransactionstransactionsmetricCount of purchase events.
Add-to-cartsaddToCartsmetricCount of add_to_cart events; the top of the checkout funnel.
Total purchaserstotalPurchasersmetricDistinct users who made at least one purchase in the period.
Items purchaseditemsPurchasedmetricUnits sold, summed across purchase events.
Item revenueitemRevenuemetricRevenue attributed to an item, before shipping and tax.
Item nameitemNamedimensionName of the product in the ecommerce event; what the products table pivots on.

Events and behaviour

FieldAPI nameTypeWhat it measures
Event nameeventNamedimensionThe name of the event (page_view, scroll, purchase…); every GA4 table of behaviour pivots on it.
Events per sessioneventsPerSessionmetricEvent count divided by sessions; how much happens in an average visit.
Event count per active usereventCountPerUsermetricEvent count divided by active users; separates a busy few from a broad many.
Key event ratesessionKeyEventRatemetricSessions with at least one key event, as a share of all sessions.
New vs returningnewVsReturningdimensionWhether the user’s first visit was in the period (new) or before it (returning).
Search termsearchTermdimensionWhat the visitor typed into the site’s own search box (view_search_results event).
InterestsbrandingInterestdimensionGoogle Signals interest category of the user, when signals are enabled and thresholds allow.
AgeuserAgeBracketdimensionAge bracket of the user (18-24 to 65+), from Google Signals.
GenderuserGenderdimensionGender of the user, from Google Signals; unknown when not available.
RegionregiondimensionState or region of the user, resolved from IP.