> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mastermetrics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Analytics 4: Metrics

> Complete reference of the Google Analytics 4 metrics in Master Metrics

> [!NOTE]
>
> **Last updated:** 2026-11-12

This reference covers the 90 metrics available for Google Analytics 4 in Master Metrics. Use it to understand which data you can pull and how each field is named.

**Available in:** Dashboards · Reports · AI assistant · MCP

## Metrics

Metrics are the numeric values you can measure and aggregate from your Google Analytics 4 data.

### User

| | |
| - | - |
| 1-day active users | 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. **Field name:** `active1DayUsers` **Type:** metric **MCP:** Available |
| 28-day active users | 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. **Field name:** `active28DayUsers` **Type:** metric **MCP:** Available |
| 7-day active users | 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. **Field name:** `active7DayUsers` **Type:** metric **MCP:** Available |
| Active users | The number of distinct users who visited your site or app. **Field name:** `activeUsers` **Type:** metric **MCP:** Available |
| User key event rate for purchase | The percentage of users who triggered a specific key event. **Field name:** `userKeyEventRate:purchase` **Type:** metric **MCP:** Available |
| DAU / MAU | 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. **Field name:** `dauPerMau` **Type:** metric **MCP:** Available |
| DAU / WAU | 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. **Field name:** `dauPerWau` **Type:** metric **MCP:** Available |
| First-time purchaser conversion | 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. **Field name:** `firstTimePurchaserConversionRate` **Type:** metric **MCP:** Available |
| First time purchasers | The number of users that completed their first purchase event. **Field name:** `firstTimePurchasers` **Type:** metric **MCP:** Available |
| First-time purchasers per new user | The average number of first time purchasers per new user. **Field name:** `firstTimePurchasersPerNewUser` **Type:** metric **MCP:** Available |
| New users | The number of users who interacted with your site or launched your app for the first time (event triggered: first\_open or first\_visit). **Field name:** `newUsers` **Type:** metric **MCP:** Available |
| Total purchasers | The number of users that logged purchase events for the time period selected. **Field name:** `totalPurchasers` **Type:** metric **MCP:** Available |
| Total users | 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. **Field name:** `totalUsers` **Type:** metric **MCP:** Available |
| User engagement | The total amount of time (in seconds) your website or app was in the foreground of users' devices. **Field name:** `userEngagementDuration` **Type:** metric **MCP:** Available |
| WAU / MAU | 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. **Field name:** `wauPerMau` **Type:** metric **MCP:** Available |

### Ecommerce

| | |
| - | - |
| Add to carts | The number of times users added items to their shopping carts. **Field name:** `addToCarts` **Type:** metric **MCP:** Available |
| Checkouts | The number of times users started the checkout process. This metric counts the occurrence of the 'begin\_checkout' event. **Field name:** `checkouts` **Type:** metric **MCP:** Available |
| Ecommerce purchases | The number of times users completed a purchase. This metric counts 'purchase' events; this metric does not count 'in\_app\_purchase' and subscription events. **Field name:** `ecommercePurchases` **Type:** metric **MCP:** Available |
| Gross item revenue | The total revenue from items only. Gross 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. Gross item revenue does not include refunds. **Field name:** `grossItemRevenue` **Type:** metric **MCP:** Available |
| Gross purchase revenue | The sum of revenue from purchases made in your app or site. Gross 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. **Field name:** `grossPurchaseRevenue` **Type:** metric **MCP:** Available |
| Item discount amount | The monetary value of item discounts in eCommerce events. This metric is populated in tagging by the 'discount' item parameter. **Field name:** `itemDiscountAmount` **Type:** metric **MCP:** Available |
| Item-list click events | The number of times users clicked an item when it appeared in a list. This metric counts the occurrence of the 'select\_item' event. **Field name:** `itemListClickEvents` **Type:** metric **MCP:** Available |
| Item list click through rate | 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. **Field name:** `itemListClickThroughRate` **Type:** metric **MCP:** Available |
| Item-list view events | The number of times the item list was viewed. This metric counts the occurrence of the 'view\_item\_list' event. **Field name:** `itemListViewEvents` **Type:** metric **MCP:** Available |
| Item promotion click through rate | 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. **Field name:** `itemPromotionClickThroughRate` **Type:** metric **MCP:** Available |
| Item refund amount | Item refund amount is the total refunded transaction revenue from items only. Item refund amount is the product of price and quantity for the 'refund' event. **Field name:** `itemRefundAmount` **Type:** metric **MCP:** Available |
| Item revenue | The total revenue from purchases minus refunded transaction 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. **Field name:** `itemRevenue` **Type:** metric **MCP:** Available |
| Items added to cart | The number of units added to cart for a single item. This metric counts the quantity of items in 'add\_to\_cart' events. **Field name:** `itemsAddedToCart` **Type:** metric **MCP:** Available |
| Items checked out | The number of units checked out for a single item. This metric counts the quantity of items in 'begin\_checkout' events. **Field name:** `itemsCheckedOut` **Type:** metric **MCP:** Available |
| Items clicked in list | The number of units clicked in list for a single item. This metric counts the quantity of items in 'select\_item' events. **Field name:** `itemsClickedInList` **Type:** metric **MCP:** Available |
| Items clicked in promotion | The number of units clicked in promotion for a single item. This metric counts the quantity of items in 'select\_promotion' events. **Field name:** `itemsClickedInPromotion` **Type:** metric **MCP:** Available |
| Items purchased | The number of units for a single item included in purchase events. This metric counts the quantity of items in purchase events. **Field name:** `itemsPurchased` **Type:** metric **MCP:** Available |
| Items viewed | The number of units viewed for a single item. This metric counts the quantity of items in 'view\_item' events. **Field name:** `itemsViewed` **Type:** metric **MCP:** Available |
| Items viewed in list | The number of units viewed in list for a single item. This metric counts the quantity of items in 'view\_item\_list' events. **Field name:** `itemsViewedInList` **Type:** metric **MCP:** Available |
| Items viewed in promotion | The number of units viewed in promotion for a single item. This metric counts the quantity of items in 'view\_promotion' events. **Field name:** `itemsViewedInPromotion` **Type:** metric **MCP:** Available |
| Item view events | The number of times the item details were viewed. The metric counts the occurrence of the 'view\_item' event. **Field name:** `itemViewEvents` **Type:** metric **MCP:** Available |
| Promotion clicks | The number of times an item promotion was clicked. This metric counts the occurrence of the 'select\_promotion' event. **Field name:** `promotionClicks` **Type:** metric **MCP:** Available |
| Promotion views | The number of times an item promotion was viewed. This metric counts the occurrence of the 'view\_promotion' event. **Field name:** `promotionViews` **Type:** metric **MCP:** Available |
| Purchase revenue | The sum of revenue from purchases minus refunded transaction revenue 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. **Field name:** `purchaseRevenue` **Type:** metric **MCP:** Available |
| Refund amount | The total refunded transaction revenues. Refund amount sums refunded revenue for the 'refund' and 'app\_store\_refund' events. **Field name:** `refundAmount` **Type:** metric **MCP:** Available |
| Shipping amount | Shipping amount associated with a transaction. Populated by the 'shipping' event parameter. **Field name:** `shippingAmount` **Type:** metric **MCP:** Available |
| Tax amount | Tax amount associated with a transaction. Populated by the 'tax' event parameter. **Field name:** `taxAmount` **Type:** metric **MCP:** Available |
| 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. **Field name:** `transactions` **Type:** metric **MCP:** Available |
| Transactions per purchaser | The average numer of transactions per purchaser. **Field name:** `transactionsPerPurchaser` **Type:** metric **MCP:** Available |

### Publisher

| | |
| - | - |
| Ad unit exposure | The time that an ad unit was exposed to a user, in milliseconds. **Field name:** `adUnitExposure` **Type:** metric **MCP:** Available |

### Other

| | |
| - | - |
| Ads clicks | Total number of times users have clicked on an ad to reach the property. Includes clicks from linked integrations like linked Search Ads 360 advertisers. Also includes uploaded clicks from data import. **Field name:** `advertiserAdClicks` **Type:** metric **MCP:** Available |
| Ads cost | The total amount you paid for your ads. Includes costs from linked integrations like linked Google Ads accounts. Also includes uploaded cost from data import; to learn more, see [Import cost data](https://support.google.com/analytics/answer/10071305). **Field name:** `advertiserAdCost` **Type:** metric **MCP:** Available |
| Ads cost per click | Ads cost per click is ad cost divided by ad clicks and is often abbreviated CPC. **Field name:** `advertiserAdCostPerClick` **Type:** metric **MCP:** Available |
| Cost per conversion | Cost per conversion is ad cost divided by conversions. **Field name:** `advertiserAdCostPerConversion` **Type:** metric **MCP:** Available |
| Ads impressions | The total number of impressions. Includes impressions from linked integrations like linked Display & Video 360 advertisers. Also includes uploaded impressions from data import. **Field name:** `advertiserAdImpressions` **Type:** metric **MCP:** Available |
| Cart-to-view rate | 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. **Field name:** `cartToViewRate` **Type:** metric **MCP:** Available |
| Crash-affected users | 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". **Field name:** `crashAffectedUsers` **Type:** metric **MCP:** Available |
| Crash-free users rate | 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. **Field name:** `crashFreeUsersRate` **Type:** metric **MCP:** Available |
| Organic Google Search average position | 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. **Field name:** `organicGoogleSearchAveragePosition` **Type:** metric **MCP:** Available |
| Organic Google Search clicks | The number of organic Google Search clicks reported from Search Console.  This metric requires an active Search Console link. **Field name:** `organicGoogleSearchClicks` **Type:** metric **MCP:** Available |
| Organic Google Search click through rate | 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. **Field name:** `organicGoogleSearchClickThroughRate` **Type:** metric **MCP:** Available |
| Organic Google Search impressions | The number of organic Google Search impressions reported from Search Console. This metric requires an active Search Console link. **Field name:** `organicGoogleSearchImpressions` **Type:** metric **MCP:** Available |
| Publisher ad clicks | The number of ad\_click events. **Field name:** `publisherAdClicks` **Type:** metric **MCP:** Available |
| Publisher ad impressions | The number of ad\_impression events. **Field name:** `publisherAdImpressions` **Type:** metric **MCP:** Available |
| Purchaser conversion | 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. **Field name:** `purchaserConversionRate` **Type:** metric **MCP:** Available |
| Purchase-to-view rate | 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). **Field name:** `purchaseToViewRate` **Type:** metric **MCP:** Available |
| Return on ad spend | Return On Ad Spend (ROAS) is total revenue divided by advertiser ad cost. **Field name:** `returnOnAdSpend` **Type:** metric **MCP:** Available |
| Scrolled users | The number of unique users who scrolled down at least 90% of the page. **Field name:** `scrolledUsers` **Type:** metric **MCP:** Available |
| Total ad revenue | The total advertising revenue from both Admob and third-party sources. **Field name:** `totalAdRevenue` **Type:** metric **MCP:** Available |

### Revenue

| | |
| - | - |
| Average purchase revenue | The average purchase revenue in the transaction group of events. **Field name:** `averagePurchaseRevenue` **Type:** metric **MCP:** Available |
| ARPPU | 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. **Field name:** `averagePurchaseRevenuePerPayingUser` **Type:** metric **MCP:** Available |
| Average purchase revenue per user | 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. **Field name:** `averagePurchaseRevenuePerUser` **Type:** metric **MCP:** Available |
| ARPU | Average revenue per active user (ARPU). The summary metric is for the time period selected. ARPU uses Total Revenue and includes AdMob estimated earnings. **Field name:** `averageRevenuePerUser` **Type:** metric **MCP:** Available |
| Total revenue | The sum of revenue from purchases, subscriptions, and advertising (Purchase revenue plus Subscription revenue plus Ad revenue) minus refunded transaction revenue. **Field name:** `totalRevenue` **Type:** metric **MCP:** Available |

### Session

| | |
| - | - |
| Average session duration | The average duration (in seconds) of users' sessions. **Field name:** `averageSessionDuration` **Type:** metric **MCP:** Available |
| Bounce rate | 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. **Field name:** `bounceRate` **Type:** metric **MCP:** Available |
| Engaged sessions | The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views. **Field name:** `engagedSessions` **Type:** metric **MCP:** Available |
| Engagement rate | 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. **Field name:** `engagementRate` **Type:** metric **MCP:** Available |
| Session conversion rate | The percentage of sessions in which any conversion event was triggered. **Field name:** `sessionConversionRate` **Type:** metric **MCP:** Available |
| Session conversion rate for purchase | The percentage of sessions in which a specific conversion event was triggered. **Field name:** `sessionConversionRate:purchase` **Type:** metric **MCP:** Available |
| Sessions | The number of sessions that began on your site or app (event triggered: session\_start). **Field name:** `sessions` **Type:** metric **MCP:** Available |
| Sessions per user | The average number of sessions per user (Sessions divided by Active Users). **Field name:** `sessionsPerUser` **Type:** metric **MCP:** Available |

### Cohort

| | |
| - | - |
| Cohort active users | 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. **Field name:** `cohortActiveUsers` **Type:** metric **MCP:** Available |
| Cohort total users | 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. **Field name:** `cohortTotalUsers` **Type:** metric **MCP:** Available |

### Event

| | |
| - | - |
| Key events | 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 \<[https://support.google.com/analytics/answer/9267568](https://support.google.com/analytics/answer/9267568)>. **Field name:** `keyEvents` **Type:** metric **MCP:** Available |
| 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 \<[https://support.google.com/analytics/answer/9267568](https://support.google.com/analytics/answer/9267568)>. **Field name:** `conversions` **Type:** metric **MCP:** Available |
| User key event rate | 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 \<[https://support.google.com/analytics/answer/9267568](https://support.google.com/analytics/answer/9267568)>. **Field name:** `userKeyEventRate` **Type:** metric **MCP:** Available |
| User Conversion rate | 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 \<[https://support.google.com/analytics/answer/9267568](https://support.google.com/analytics/answer/9267568)>. **Field name:** `userConversionRate` **Type:** metric **MCP:** Available |
| Event count | The count of events. **Field name:** `eventCount` **Type:** metric **MCP:** Available |
| Event count per user | The average number of events per user (Event count divided by Active users). **Field name:** `eventCountPerUser` **Type:** metric **MCP:** Available |
| Events per session | The average number of events per session (Event count divided by Sessions). **Field name:** `eventsPerSession` **Type:** metric **MCP:** Available |
| Event value | The sum of the event parameter named 'value'. **Field name:** `eventValue` **Type:** metric **MCP:** Available |

### Page / Screen

| | |
| - | - |
| Views | 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). **Field name:** `screenPageViews` **Type:** metric **MCP:** Available |
| Views per session | 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. **Field name:** `screenPageViewsPerSession` **Type:** metric **MCP:** Available |
| Views per user | The number of app screens or web pages your users viewed per active user. Repeated views of a single page or screen are counted. (screen\_view + page\_view events) / active users. **Field name:** `screenPageViewsPerUser` **Type:** metric **MCP:** Available |

## Related

> [card] [Fields catalog](https://docs.mastermetrics.com/en.md)
>
> Browse all sources

> [card] [Instagram](https://docs.mastermetrics.com/en/instagram/metrics.md)
>
> Metrics & Dimensions

> [card] [Facebook Pages](https://docs.mastermetrics.com/en/facebook/metrics.md)
>
> Metrics & Dimensions

> [card] [Shopify](https://docs.mastermetrics.com/en/shopify/metrics.md)
>
> Metrics & Dimensions


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.