> For the complete documentation index, see [llms.txt](https://www.analytics-docs.laplacetec.com/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.analytics-docs.laplacetec.com/guide/en/customdashboard/custom/about_values/ga4.md).

# GA4 data

{% hint style="info" %}
GA4 API data collects and provides user behavior data such as website visits, traffic sources, and conversions.
{% endhint %}

{% hint style="info" %}
For the GA4 API, you can select custom metrics managed in your GA4 account. However, if you add or edit a custom metric in your GA4 account, it becomes available after the next day's data sourcing is complete (around 9 AM).
{% endhint %}

<table><thead><tr><th width="219.65625">Measure</th><th>Description</th></tr></thead><tbody><tr><td>Active users</td><td>The number of distinct users who visited your site or app.</td></tr><tr><td>1-day active users</td><td>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.</td></tr><tr><td>28-day active users</td><td>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.</td></tr><tr><td>7-day active users</td><td>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.</td></tr><tr><td>Add to carts</td><td>The number of times users added items to their shopping carts.</td></tr><tr><td>Ad unit exposure</td><td>The time that an ad unit was exposed to a user, in milliseconds.</td></tr><tr><td>Ads clicks</td><td>The total number of times users clicked on an ad to reach the property. Includes clicks from linked integrations such as linked Search Ads 360 advertisers. Also includes clicks uploaded through data import.</td></tr><tr><td>Ads cost</td><td>The total amount you paid for your ads. Includes costs from linked integrations such as linked Google Ads accounts. Also includes costs uploaded through data import. For details, see Import cost data.</td></tr><tr><td>AD CPC</td><td>The average cost per ad click.</td></tr><tr><td>Cost per conversion</td><td>Cost per conversion is the ad cost divided by conversions.</td></tr><tr><td>Ads impressions</td><td>The total number of impressions. Includes impressions from linked integrations such as linked Display &#x26; Video 360 advertisers. Also includes impressions uploaded through data import.</td></tr><tr><td>Average purchase revenue</td><td>The average purchase revenue in the transaction group of events.</td></tr><tr><td>ARPPU</td><td>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.</td></tr><tr><td>Average purchase revenue per user</td><td>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.</td></tr><tr><td>ARPU</td><td>Average revenue per active user (ARPU). The summary metric is for the time period selected. ARPU uses total revenue and includes AdMob estimated earnings.</td></tr><tr><td>Average session duration</td><td>The average duration (in seconds) of users' sessions.</td></tr><tr><td>Bounce rate</td><td>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.</td></tr><tr><td>Cart-to-view rate</td><td>The number of users who added a product to their cart divided by the number of users who viewed the same product. This metric is returned as a fraction; for example, 0.1132 means 11.32% of users who viewed a product added the same product to their cart.</td></tr><tr><td>Checkouts</td><td>The number of times users started the checkout process. This metric counts the occurrence of the 'begin_checkout' event.</td></tr><tr><td>Crash-affected users</td><td>The number of users that logged a crash in this row of the report. For example, if the report is a time series by date, this metric reports total users with at least one crash on that date. Crashes are events with the name 'app_exception'.</td></tr><tr><td>Crash-free users rate</td><td>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.</td></tr><tr><td>DAU / MAU</td><td>The rolling percentage 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.</td></tr><tr><td>DAU / WAU</td><td>The rolling percentage 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.</td></tr><tr><td>Ecommerce purchases</td><td>The number of times users completed a purchase. This metric counts 'purchase' events; it does not count 'in_app_purchase' and subscription events.</td></tr><tr><td>Engaged sessions</td><td>The number of sessions that lasted longer than 10 seconds, had a conversion event, or had 2 or more screen views.</td></tr><tr><td>Engagement rate</td><td>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.</td></tr><tr><td>Event count</td><td>The count of events.</td></tr><tr><td>Event count per user</td><td>The average number of events per user (event count divided by active users).</td></tr><tr><td>Events per session</td><td>The average number of events per session (event count divided by sessions).</td></tr><tr><td>Event value</td><td>The sum of the event parameter named 'value'.</td></tr><tr><td>First-time purchaser conversion</td><td>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.</td></tr><tr><td>First-time purchasers</td><td>The number of distinct users who made their first purchase.</td></tr><tr><td>First-time purchasers per new user</td><td>The average number of first-time purchasers per new user.</td></tr><tr><td>Gross item revenue</td><td>The total revenue from items only. Gross item revenue is the product of price and quantity. Tax and shipping values are excluded from item revenue; they are specified at the event level, not the item level. Gross item revenue does not include refunds.</td></tr><tr><td>Gross purchase revenue</td><td>The sum of purchase revenue on your app or site. Gross purchase revenue sums the revenue for the 'purchase', 'ecommerce_purchase', 'in_app_purchase', 'app_store_subscription_convert', and 'app_store_subscription_renew' events. Purchase revenue is specified by the 'value' parameter in tagging.</td></tr><tr><td>Item discount amount</td><td>The monetary value of item discounts in ecommerce events. This metric is populated in tagging by the 'discount' item parameter.</td></tr><tr><td>Item list click events</td><td>The number of times users clicked an item when it appeared in a list. This metric counts the occurrence of the 'select_item' event.</td></tr><tr><td>Item list click-through rate</td><td>The number of users who selected a list divided by the number of users who viewed the same list. 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.</td></tr><tr><td>Item list view events</td><td>The number of times the item list was viewed. This metric counts the occurrence of the 'view_item_list' event.</td></tr><tr><td>Item promotion click-through rate</td><td>The number of users who selected a promotion divided by the number of users who viewed the same promotion. This metric is returned as a fraction; for example, 0.1382 means 13.82% of users who viewed a promotion also selected the promotion.</td></tr><tr><td>Item refund amount</td><td>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.</td></tr><tr><td>Item revenue</td><td>The total purchase revenue minus refunded transaction revenue from items only. Item revenue is the product of price and quantity. Tax and shipping values are excluded from item revenue; they are specified at the event level, not the item level.</td></tr><tr><td>Items added to cart</td><td>The number of units added to cart for a single item. This metric counts the quantity of items in 'add_to_cart' events.</td></tr><tr><td>Items checked out</td><td>The number of units checked out for a single item. This metric counts the quantity of items in 'begin_checkout' events.</td></tr><tr><td>Items clicked in list</td><td>The number of units clicked in a list for a single item. This metric counts the quantity of items in 'select_item' events.</td></tr><tr><td>Items clicked in promotion</td><td>The number of units clicked in a promotion for a single item. This metric counts the quantity of items in 'select_promotion' events.</td></tr><tr><td>Items purchased</td><td>The number of units for a single item included in purchase events. This metric counts the quantity of items in purchase events.</td></tr><tr><td>Items viewed</td><td>The number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events.</td></tr><tr><td>Items viewed in list</td><td>The number of units viewed in a list for a single item. This metric counts the quantity of items in 'view_item_list' events.</td></tr><tr><td>Items viewed in promotion</td><td>The number of units viewed in a promotion for a single item. This metric counts the quantity of items in 'view_promotion' events.</td></tr><tr><td>Item view events</td><td>The number of times the item details were viewed. The metric counts the occurrence of the 'view_item' event.</td></tr><tr><td>Conversions</td><td>The count of conversion events. Events are marked as conversions at collection time.</td></tr><tr><td>New users</td><td>The number of users who visited your app or website for the first time.</td></tr><tr><td>Organic Google Search average position</td><td>The average ranking of your website URLs for the queries 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.</td></tr><tr><td>Organic Google Search clicks</td><td>The number of organic Google Search clicks reported from Search Console. This metric requires an active Search Console link.</td></tr><tr><td>Organic Google Search click-through rate</td><td>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.</td></tr><tr><td>Organic Google Search impressions</td><td>The number of organic Google Search impressions reported from Search Console. This metric requires an active Search Console link.</td></tr><tr><td>Promotion clicks</td><td>The number of times an item promotion was clicked. This metric counts the occurrence of the 'select_promotion' event.</td></tr><tr><td>Promotion views</td><td>The number of times an item promotion was viewed. This metric counts the occurrence of the 'view_promotion' event.</td></tr><tr><td>Publisher ad clicks</td><td>The number of ad_click events.</td></tr><tr><td>Publisher ad impressions</td><td>The number of ad_impression events.</td></tr><tr><td>Purchase revenue</td><td>The sum of revenue from purchases minus refunded transaction revenue made in your app or site. Purchase revenue sums the revenue for the 'purchase', 'ecommerce_purchase', 'in_app_purchase', 'app_store_subscription_convert', and 'app_store_subscription_renew' events. Purchase revenue is specified by the 'value' parameter in tagging.</td></tr><tr><td>Purchaser conversion</td><td>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.</td></tr><tr><td>Purchase-to-view rate</td><td>The number of users who purchased a product divided by the number of users who viewed the same product. This metric is returned as a fraction; for example, 0.128 means 12.8% of users who viewed a product purchased the same product.</td></tr><tr><td>Refund amount</td><td>The total refunded transaction revenue. Refund amount sums refunded revenue for the 'refund' and 'app_store_refund' events.</td></tr><tr><td>ROAS</td><td>Return on ad spend (ROAS) is total revenue divided by advertiser ad cost.</td></tr><tr><td>Views</td><td>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)</td></tr><tr><td>Views per session</td><td>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.</td></tr><tr><td>Views per user</td><td>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</td></tr><tr><td>Scrolled users</td><td>The number of distinct users who scrolled down at least 90% of the page.</td></tr><tr><td>Session conversion rate</td><td>The percentage of sessions in which any conversion event was triggered.</td></tr><tr><td>Sessions</td><td>The number of sessions that began on your site or app (event triggered: session_start).</td></tr><tr><td>Sessions per user</td><td>The average number of sessions per user (sessions divided by active users).</td></tr><tr><td>Shipping amount</td><td>Shipping amount associated with a transaction. Populated by the 'shipping' event parameter.</td></tr><tr><td>Tax amount</td><td>Tax amount associated with a transaction. Populated by the 'tax' event parameter.</td></tr><tr><td>Total ad revenue</td><td>The total advertising revenue from both AdMob and third-party sources.</td></tr><tr><td>Total purchasers</td><td>The number of users that logged purchase events for the time period selected.</td></tr><tr><td>Total revenue</td><td>The sum of revenue from purchases, subscriptions, and advertising (purchase revenue plus subscription revenue plus ad revenue) minus refunded transaction revenue.</td></tr><tr><td>Total users</td><td>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.</td></tr><tr><td>Transactions</td><td>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.</td></tr><tr><td>Transactions per purchaser</td><td>The average number of transactions per purchaser.</td></tr><tr><td>User engagement</td><td>The total amount of time (in seconds) your website or app was in the foreground of users' devices.</td></tr><tr><td>User conversion rate</td><td>The percentage of users who triggered any conversion event.</td></tr><tr><td>WAU / MAU</td><td>The rolling percentage 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.</td></tr></tbody></table>
