Wording

Author: macobo

docs/metrics-definitions.md

@@ -102,7 +102,7 @@ See all referral sources that are sending you traffic. A source is reported when
 
 The average amount of time spent per visitor viewing a particular page on your site.
 
-Similar to scroll depth, this metric relies on `engagement` events being sent by our tracking script for every pageview. This allows us to provide you with a more precise and reliable measure of user engagement which includes visitors who bounce away from your pages and excludes those who are not actually active on your pages.
+Similar to scroll depth, this metric relies on `engagement` events being sent by our tracking script for every pageview when the user navigates to a new page or switches tabs. This allows us to provide you with a more precise and reliable measure of user engagement which includes visitors who bounce away from your pages and which does not include time not spent actively on your pages.
 
 <details>
 <summary>Legacy time on page metric</summary>

docs/stats-api.md

@@ -94,7 +94,7 @@ Valid metrics are:
 | `group_conversion_rate` | `float` | The percentage of visitors who completed the goal with the same dimension. Requires: dimension list passed, an event:goal filter or event:goal dimension | Requires non-empty `dimensions`, event:goal filter or dimension being set |
 | `average_revenue` | `Revenue` or null | Average revenue per revenue goal conversion | Requires [revenue goals](docs/ecommerce-revenue-tracking.md), `event:goal` filter or dimension for a relevant revenue goal. |
 | `total_revenue` | `Revenue` or null | Total revenue from revenue goal conversions | Requires [revenue goals](docs/ecommerce-revenue-tracking.md), `event:goal` filter or dimension for a relevant revenue goal. |
-| `time_on_page` | `int` | Average time in seconds spent on a page per visitor | Requires `event:page` filter or dimension being set. |
+| `time_on_page` | `int` | Average time in seconds spent on a page per visit | Requires `event:page` filter or dimension being set. |
 
 <details>
   <summary>Read more about revenue metrics</summary>