GA4 Metrics and Dimensions Definition

A complete list of GA4 official Metrics and Dimensions with definitions and examples. Combine with User Interface Name (Which you see in the report) with API name.

You can also view it in the GA dev tool, but a GA4 account and login are required.

1.1 User — Dimensions

Audience ID - audienceId

The numeric identifier of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behaviour does not affect historical audience membership in reports.

Audience name - audienceName

The given name of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behavior does not affect historical audience membership in reports.

New / returning - newVsReturning

New users have 0 previous sessions, and returning users have 1 or more previous sessions. This dimension returns two values: 'new' or 'returning'.

Signed in with user ID - signedInWithUserId

The string 'yes' if the user signed in with the User-ID feature. To learn more about User-ID, see User-ID for cross-platform analysis.

1.2 User — Metrics

1-day active users - active1DayUsers

The number of distinct active users on your site or app within a 1 day period. The 1 day period includes the last day in the report's date range. Note: this is the same as Active Users.

28-day active users - active28DayUsers

The number of distinct active users on your site or app within a 28 day period. The 28 day period includes the last day in the report's date range.

7-day active users - active7DayUsers

The number of distinct active users on your site or app within a 7 day period. The 7 day period includes the last day in the report's date range.

Active users - activeUsers

The number of distinct users who visited your site or app.

DAU / MAU - dauPerMau

The rolling percent of 30-day active users who are also 1-day active users. This metric is returned as a fraction; for example, 0.113 means 11.3% of 30-day active users were also 1-day active users.

DAU / WAU - dauPerWau

The rolling percent of 7-day active users who are also 1-day active users. This metric is returned as a fraction; for example, 0.082 means 8.2% of 7-day active users were also 1-day active users.

First-time purchaser conversion - firstTimePurchaserConversionRate

The percentage of active users who made their first purchase. This metric is returned as a fraction; for example, 0.092 means 9.2% of active users were first time purchasers.

First time purchasers - firstTimePurchasers

The number of users that completed their first purchase event.

First-time purchasers per new - userfirstTimePurchasersPerNewUser

The average number of first time purchasers per new user.

New users - newUsers

The number of users who interacted with your site or launched your app for the first time (event triggered: first_open or first_visit).

Total purchasers - totalPurchasers

The number of users that logged purchase events for the time period selected.

Total users - totalUsers

The number of distinct users who have logged at least one event, regardless of whether the site or app was in use when that event was logged.

User engagement - userEngagementDuration

The total amount of time (in seconds) your website or app was in the foreground of users' devices.

WAU / MAU - wauPerMau

The rolling percent of 30-day active users who are also 7-day active users. This metric is returned as a fraction; for example, 0.234 means 23.4% of 30-day active users were also 7-day active users.

2.1 EcommerceDimensions

Item affiliation - itemAffiliation

The name or code of the affiliate (partner/vendor; if any) associated with an individual item. Populated by the 'affiliation' item parameter.

Item brand - itemBrand

Brand name of the item.

Item category - itemCategory

The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Apparel is the item category.

Item category - itemCategory2

The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Mens is the item category 2.

Item category - itemCategory3

The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Mens is the item category 3.

Item category - itemCategory4

The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Mens is the item category 4.

Item category - itemCategory5

The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Mens is the item category 5.

Item ID - itemId

The ID of the item.

Item list ID - itemListId

The ID of the item list.

Item list name - itemListName

The name of the item list.

Item name - itemName

The name of the item.

Item promotion creative name - itemPromotionCreativeName

The name of the item-promotion creative.

Item promotion ID - itemPromotionId

The ID of the item promotion.

Item promotion name - itemPromotionName

The name of the promotion for the item.

Item variant - itemVariant

The specific variation of a product. e.g., XS, S, M, L for size; or Red, Blue, Green, Black for color. Populated by the 'item_variant' parameter.

Order coupon - orderCoupon

Code for the order-level coupon.

Shipping tier - shippingTier

The shipping tier (e.g. Ground, Air, Next-day) selected for delivery of the purchased item. Populated by the 'shipping_tier' event parameter.

Transaction ID - transactionId

The ID of the ecommerce transaction.

2.2 EcommerceMetrics

Add-to-carts - addToCarts

The number of times users added items to their shopping carts.

Checkouts - checkouts

The number of times users started the checkout process.

Ecommerce purchases - ecommercePurchases

The number of times users completed a purchase. This metric counts 'purchase' events; this metric does not count 'in_app_purchase' and subscription events.

Item list clicks - itemListClicks

The number of times users clicked an item when it appeared in a list.

Item list click through rate - itemListClickThroughRate

The number of users who selected a list(s) divided by the number of users who viewed the same list(s). This metric is returned as a fraction; for example, 0.2145 means 21.45% of users who viewed a list also selected the same list.

Item list views - itemListViews

The number of times the item list was viewed.

Item promotion clicks - itemPromotionClicks

The number of times an item promotion was clicked.

Item promotion click through rate - itemPromotionClickThroughRate

The number of users who selected a promotion(s) divided by the number of users who viewed the same promotion(s). This metric is returned as a fraction; for example, 0.1382 means 13.82% of users who viewed a promotion also selected the promotion.

Item promotion views - itemPromotionViews

The number of times an item promotion was viewed.

Item purchase quantity - itemPurchaseQuantity

The number of units for a single item included in purchase events.

Item revenue - itemRevenue

The total revenue from items only. Item revenue is the product of its price and quantity. Item revenue excludes tax and shipping values; tax & shipping values are specified at the event and not item level.

Item views - itemViews

The number of times the item details were viewed.

Purchase revenue - purchaseRevenue

The sum of revenue from purchases made in your app or site. Purchase revenue sums the revenue for these events: 'purchase', 'ecommerce_purchase', 'in_app_purchase', 'app_store_subscription_convert', and 'app_store_subscription_renew'. Purchase revenue is specified by the 'value' parameter in tagging.

Shipping amount - shippingAmount

Shipping amount associated with a transaction. Populated by the 'shipping' event parameter.

Tax amount - taxAmount

Tax amount associated with a transaction. Populated by the 'tax' event parameter.

Transactions - transactions

The count of transaction events with purchase revenue. Transaction events are in_app_purchase, ecommerce_purchase, purchase, app_store_subscription_renew, app_store_subscription_convert, and refund.

Transactions per purchaser - transactionsPerPurchaser

The average numer of transactions per purchaser.

3.1. PublisherDimensions

Ad format - adFormat

Describes the way ads looked and where they were located. Typical formats include 'Interstitial', 'Banner', 'Rewarded', and 'Native advanced'.

Ad source - adSourceName

The source network that served the ad. Typical sources include 'AdMob Network', 'Liftoff', 'Facebook Audience Network', and 'Mediated house ads'.

Ad unit - adUnitName

The name you chose to describe this Ad unit. Ad units are containers you place in your apps to show ads to users.

3.2. Publisher — Metrics

Ad unit exposure - adUnitExposure

The time that an ad unit was exposed to a user, in milliseconds.

4. Revenue — Metrics

Average purchase revenue - averagePurchaseRevenue

The average purchase revenue in the transaction group of events.

ARPPU - averagePurchaseRevenuePerPayingUser

Average revenue per paying user (ARPPU) is the total purchase revenue per active user that logged a purchase event. The summary metric is for the time period selected.

Average purchase revenue per user - averagePurchaseRevenuePerUser

The average purchase revenue per active user is the total purchase revenue per active user that logged any event. The summary metric is for the time period selected.

ARPU - averageRevenuePerUser

Average revenue per active user (ARPU). The summary metric is for the time period selected. ARPU uses Total Revenue and includes AdMob estimated earnings.

Total revenue - totalRevenue

The sum of revenue from purchases, subscriptions, and advertising (Purchase revenue plus Subscription revenue plus Ad revenue).

5. Session — Metrics

Average session duration - averageSessionDuration

The average duration (in seconds) of users' sessions.

Bounce rate - bounceRate

The percentage of sessions that were not engaged ((Sessions Minus Engaged sessions) divided by Sessions). This metric is returned as a fraction; for example, 0.2761 means 27.61% of sessions were bounces.

Engaged sessions - engagedSessions

The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.

Engagement rate - engagementRate

The percentage of engaged sessions (Engaged sessions divided by Sessions). This metric is returned as a fraction; for example, 0.7239 means 72.39% of sessions were engaged sessions.

Sessions - sessions

The number of sessions that began on your site or app (event triggered: session_start).

Sessions per user - sessionsPerUser

The average number of sessions per user (Sessions divided by Active Users).

6. Other Dimensions

Achievement ID - achievementId

The achieventment ID in a game for an event. Populated by the event parameter 'achievement_id'.

Character - character

The player character in a game for an event. Populated by the event parameter 'character'.

File extension - fileExtension

The extension of the downloaded file (for example, 'pdf' or 'txt'). Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'file_extension'.

File name - fileName

The page path of the downloaded file (for example, '/menus/dinner-menu.pdf'). Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'file_name'.

Group ID - groupId

The player group ID in a game for an event. Populated by the event parameter 'group_id'.

Level - level

The player's level in a game. Populated by the event parameter 'level'.

Link classes - linkClasses

The HTML class attribute for an outbound link. For example if a user clicks a link '<a class="center" href="www.youtube.com">', this dimension will return 'center'. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'link_classes'.

Link domain - linkDomain

The destination domain of the outbound link. For example if a user clicks a link '<a href="www.youtube.com">', this dimension will return 'youtube.com'. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'link_domain'.

Link ID - linkId

The HTML id attribute for an outbound link or file download. For example if a user clicks a link '<a id="socialLinks" href="www.youtube.com">', this dimension will return 'socialLinks'. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'link_id'.

Link text - linkText

The link text of the file download. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'link_text'.

Link URL - linkUrl

The full url for an outbound link or file download. For example if a user clicks a link '<a href="https://www.youtube.com/results?search_query=analytics">', this dimension will return 'https://www.youtube.com/results?search_query=analytics'. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'link_url'.

Method - method

The method by which an event was triggered. Populated by the event parameter 'method'.

Outbound - outbound

Returns 'true' if the link lead to a site is not a part of the property’s domain. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'outbound'.

Percent scrolled - percentScrolled

The percentage down the page that the user has scrolled (for example, '90'). Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'percent_scrolled'.

Search term - searchTerm

The term searched by the user. For example if the user visits '/some-page.html?q=some-term', this dimension returns 'some-term'. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'search_term'.

Test data filter name - testDataFilterName

The name of data filters in testing state. You use data filters to include or exclude event data from your reports based on event-parameter values. To learn more, see Data filters.

Video provider - videoProvider

The source of the video (for example, 'youtube'). Automatically populated for embedded videos if Enhanced Measurement is enabled. Populated by the event parameter 'video_provider'.

Video title - videoTitle

The title of the video. Automatically populated for embedded videos if Enhanced Measurement is enabled. Populated by the event parameter 'video_title'.

Video URL - videoUrl

The url of the video. Automatically populated for embedded videos if Enhanced Measurement is enabled. Populated by the event parameter 'video_url'.

Virtual currency name - virtualCurrencyName

The name of a virtual currency with which the user is interacting. i.e. spending or purchasing gems in a game. Populated by the 'virtual_currency_name' event parameter.

Visible - visible

Returns 'true' if the content is visible. Automatically populated for embedded videos if Enhanced Measurement is enabled. Populated by the event parameter 'visible'.

7. Other — Metrics

Cart-to-view rate - cartToViewRate

The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s). This metric is returned as a fraction; for example, 0.1132 means 11.32% of users who viewed a product also added the same product to their cart.

Crash-affected users - crashAffectedUsers

The number of users that logged a crash in this row of the report. For example if the report is time series by date, this metrics reports total users with at least one crash on this date. Crashes are events with the name "app_exception".

Crash-free users rate - crashFreeUsersRate

The number of users without crash events (in this row of the report) divided by the total number of users. This metric is returned as a fraction; for example, 0.9243 means 92.43% of users were crash-free.

Organic google search average position - organicGoogleSearchAveragePosition

The average ranking of your website URLs for the query reported from Search Console. For example, if your site's URL appears at position 3 for one query and position 7 for another query, the average position would be 5 (3+7/2). This metric requires an active Search Console link.

Organic google search clicks - organicGoogleSearchClicks

The number of organic Google Search clicks reported from Search Console. This metric requires an active Search Console link.

Organic google search click through rate - organicGoogleSearchClickThroughRate

The organic Google Search click through rate reported from Search Console. Click through rate is clicks per impression. This metric is returned as a fraction; for example, 0.0588 means about 5.88% of impressions resulted in a click. This metric requires an active Search Console link.

Organic google search impressions - organicGoogleSearchImpressions

The number of organic Google Search impressions reported from Search Console. This metric requires an active Search Console link.

Publisher ad clicks - publisherAdClicks

The number of ad_click events.

Publisher ad impressions - publisherAdImpressions

The number of ad_impression events.

Purchaser conversion - purchaserConversionRate

The percentage of active users who made 1 or more purchase transactions. This metric is returned as a fraction; for example, 0.412 means 41.2% of users were purchasers.

Purchase-to-view rate - purchaseToViewRate

The number of users who purchased a product(s) divided by the number of users who viewed the same product(s). This metric is returned as a fraction; for example, 0.128 means 12.8% of users that viewed a product(s) also purchased the same product(s).

Total ad revenue - totalAdRevenue

The total advertising revenue from both Admob and third-party sources.

8.1 Cohort — Dimensions

Cohort - cohort

The cohort's name in the request. A cohort is a set of users who started using your website or app in any consecutive group of days. If a cohort name is not specified in the request, cohorts are named by their zero based index: cohort_0, cohort_1, etc.

Daily cohort - cohortNthDay

Day offset relative to the firstSessionDate for the users in the cohort. For example, if a cohort is selected with the start and end date of 2020-03-01, then for the date 2020-03-02, cohortNthDay will be 0001.

Monthly cohort - cohortNthMonth

Month offset relative to the firstSessionDate for the users in the cohort. Month boundaries align with calendar month boundaries. For example, if a cohort is selected with the start and end date in March 2020, then for any date in April 2020, cohortNthMonth will be 0001.

Weekly cohort - cohortNthWeek

Week offset relative to the firstSessionDate for the users in the cohort. Weeks start on Sunday and end on Saturday. For example, if a cohort is selected with the start and end date in the range 2020-11-08 to 2020-11-14, then for the dates in the range 2020-11-15 to 2020-11-21, cohortNthWeek will be 0001.

8.2. Cohort — Metrics

Cohort active users - cohortActiveUsers

The number of users in the cohort who are active in the time window corresponding to the cohort nth day/week/month. For example for the row where cohortNthWeek = 0001, this metric is the number of users (in the cohort) who are active in week 1.

Cohort total users - cohortTotalUsers

The total number of users in the cohort. This metric is the same value in every row of the report for each cohort. Because cohorts are defined by a shared acquisition date, cohortTotalUsers is the same as cohortActiveUsers for the cohort's selection date range. For report rows later than the ochort's selection range, it is typical for cohortActiveUsers to be smaller than cohortTotalUsers. This difference represents users from the cohort that were not active for the later date. cohortTotalUsers is commonly used in the metric expression cohortActiveUsers/cohortTotalUsers to compute a user retention fraction for the cohort. The relationship between activeUsers and totalUsers is not equivalent to the relationship between cohortActiveUsers and cohortTotalUsers.

9.1. Event — Dimensions

Event name - eventName

The name of the event.

Is conversion event - isConversionEvent

The string 'true' if the event is a conversion. Events are marked as conversions at collection time; changes to an event's conversion marking apply going forward. You can mark any event as a conversion in Google Analytics, and some events (i.e. first_open, purchase) are marked as conversions by default. To learn more, see Set up and manage conversion events.

9.2. Event — Metrics

Conversions - conversions

The count of conversion events. Events are marked as conversions at collection time; changes to an event's conversion marking apply going forward. You can mark any event as a conversion in Google Analytics, and some events (i.e. first_open, purchase) are marked as conversions by default. To learn more, see Set up and manage conversion events.

Event count - eventCount

The count of events.

Event count per user - eventCountPerUser

The average number of events per user (Event count divided by Active users).

Events per session - eventsPerSession

The average number of events per session (Event count divided by Sessions).

Event value - eventValue

The sum of the event parameter named 'value'.

10.1. Page / Screen — Dimensions

Content group - contentGroup

A category that applies to items of published content. Populated by the event parameter 'content_group'.

Content ID - contentId

The identifier of the selected content. Populated by the event parameter 'content_id'.

Content type - contentType

The category of the selected content. Populated by the event parameter 'content_type'.

Full page URL - fullPageUrl

The hostname, page path, and query string for web pages visited; for example, the fullPageUrl portion of https://www.example.com/store/contact-us?query_string=true is www.example.com/store/contact-us?query_string=true.

Hostname - hostName

Includes the subdomain and domain names of a URL; for example, the Host Name of www.example.com/contact.html is www.example.com.

Landing page - landingPage

The page path + query string associated with the first pageview in a session.

Page location - pageLocation

The protocol, hostname, page path, and query string for web pages visited; for example, the pageLocation portion of https://www.example.com/store/contact-us?query_string=true is https://www.example.com/store/contact-us?query_string=true. Populated by the event parameter 'page_location'.

Page path - pagePath

The portion of the URL between the hostname and query string for web pages visited; for example, the pagePath portion of https://www.example.com/store/contact-us?query_string=true is /store/contact-us.

Page path + query string - pagePathPlusQueryString

The portion of the URL following the hostname for web pages visited; for example, the pagePathPlusQueryString portion of https://www.example.com/store/contact-us?query_string=true is /store/contact-us?query_string=true.

Page referrer - pageReferrer

The full referring URL including the hostname and path. This referring URL is the user's previous URL and can be this website's domain or other domains. Populated by the event parameter 'page_referrer'.

Page title - pageTitle

The web page titles used on your site.

Page path and screen class - unifiedPagePathScreen

The page path (web) or screen class (app) on which the event was logged.

Page path + query string and screen class - unifiedPageScreen

The page path and query string (web) or screen class (app) on which the event was logged.

Page title and screen class - unifiedScreenClass

The page title (web) or screen class (app) on which the event was logged.

Page title and screen name - unifiedScreenName

The page title (web) or screen name (app) on which the event was logged.

10.2. Page / Screen — Metrics

Views - screenPageViews

The number of app screens or web pages your users viewed. Repeated views of a single page or screen are counted. (screen_view + page_view events).

Views per session - screenPageViewsPerSession

The number of app screens or web pages your users viewed per session. Repeated views of a single page or screen are counted. (screen_view + page_view events) / sessions.

11. Event-scoped Custom Metric — Metrics

Average ad_drx_country_criteria_id - averageCustomEvent:ad_drx_country_criteria_id

The average of an event scoped custom metric for your Analytics property.

Average score - averageCustomEvent:score[post_score]

The average of an event scoped custom metric for your Analytics property.

Count ad_drx_country_criteria_id - countCustomEvent:ad_drx_country_criteria_id

The number of occurrences of an event scoped custom metric for your Analytics property.

Count score - countCustomEvent:score[post_score]

The number of occurrences of an event scoped custom metric for your Analytics property.

ad_drx_country_criteria_id - customEvent:ad_drx_country_criteria_id

An event scoped custom metric for your Analytics property.