From 9e56692167c73dab99aa5249ef2f6f4334747355 Mon Sep 17 00:00:00 2001 From: Marko Saric <34340819+metmarkosaric@users.noreply.github.com> Date: Wed, 19 Mar 2025 16:33:10 +0100 Subject: [PATCH 1/6] time on page --- docs/metrics-definitions.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/metrics-definitions.md b/docs/metrics-definitions.md index 02c25c41..520dde41 100644 --- a/docs/metrics-definitions.md +++ b/docs/metrics-definitions.md @@ -97,9 +97,7 @@ See all referral sources that are sending you traffic. A source is reported when ## Time on Page -The average time people spend on a particular page on your site. This is calculated as the difference between the point when a person lands on a particular page and when they move on to the next page. - -You may notice differences in the time on page in Plausible and in Google's Universal Analytics. This is because we have a different definition. In Google Analytics (UA), bounced visitors are included in the time on page calculation but are set to 10 seconds. In Plausible, we exclude bounced visitors from the time on page calculation. Neither of these approaches is 100% accurate. Plausible would show higher than the actual time on page, and Google Analytics would show lower than the actual time on page. In both cases, it's not possible to measure the time on page of people that bounce from your site. +The average amount of time people spend viewing a particular page on your site. Since March 2025, we've improved our methodology by sending multiple `engagement` events per pageview and by triggering an event every time the visitor closes the browser tab or moves the focus away from the current tab. 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. ## Total Conversions From 21cb80e9143b48f08314ebdb847781ee68c42246 Mon Sep 17 00:00:00 2001 From: Marko Saric <34340819+metmarkosaric@users.noreply.github.com> Date: Fri, 4 Apr 2025 10:47:20 +0200 Subject: [PATCH 2/6] Update metrics-definitions.md --- docs/metrics-definitions.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/metrics-definitions.md b/docs/metrics-definitions.md index 520dde41..6e165da0 100644 --- a/docs/metrics-definitions.md +++ b/docs/metrics-definitions.md @@ -22,7 +22,7 @@ If you have issues with high bounce rates on your site, you can try to set up so Shows the browsers used by your visitors. We only show the brand of the browser and when you click on the brand you can see the version number too. Metrics are shown as a percentage of all visitors and the total number of unique visitors. -## Conversion Rate +## Conversion Rate (or CR) The percentage of visitors that take a desired action such as subscribing to a newsletter or signing up for an account. Calculated as follows: unique conversions for a goal / unique visitors, where both values depend on the filters applied to the dashboard. @@ -59,7 +59,7 @@ Automatically track the number of file downloads. This feature isn't enabled by You can follow the visitor journey from a landing page to a conversion with [funnel analysis](funnel-analysis.md). -## Goals +## Goals (or Events) You can use goals to track desired actions people take on your site. Goals can be based on people [visiting a particular page](pageview-goals.md) or [triggering a particular event](custom-event-goals.md) such as subscribing to a newsletter or signing up for an account. You can even use custom properties to create your own metrics to collect and analyze data that Plausible doesn’t automatically track. @@ -89,7 +89,7 @@ Shows the devices used by your visitors. Devices are categorized into desktop, m ## Scroll Depth -Measures how far visitors scroll down a webpage. It represents the percentage of a page’s total height that visitors have reached on average. You can learn how we calculate it [here](http://plausible.io/docs/scroll-depth).``` +Measures how far visitors scroll down a webpage. It represents the percentage of a page’s total height that visitors have reached on average. You can learn how we calculate it [here](http://plausible.io/docs/scroll-depth). ## Source From c4db2516b7c095a6f6071d7ad313a1190aa9c117 Mon Sep 17 00:00:00 2001 From: Marko Saric <34340819+metmarkosaric@users.noreply.github.com> Date: Fri, 4 Apr 2025 11:18:50 +0200 Subject: [PATCH 3/6] Update metrics-definitions.md --- docs/metrics-definitions.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/metrics-definitions.md b/docs/metrics-definitions.md index 6e165da0..3d993f19 100644 --- a/docs/metrics-definitions.md +++ b/docs/metrics-definitions.md @@ -22,10 +22,13 @@ If you have issues with high bounce rates on your site, you can try to set up so Shows the browsers used by your visitors. We only show the brand of the browser and when you click on the brand you can see the version number too. Metrics are shown as a percentage of all visitors and the total number of unique visitors. +## Channels + +Channels show a breakdown of your traffic sources categorized into high-level groups such as "Organic Social", "Paid Search" and "Email". Learn more [here](top-referrers.md). + ## Conversion Rate (or CR) -The percentage of visitors that take a desired action such as subscribing to a newsletter or signing up for an account. Calculated as follows: -unique conversions for a goal / unique visitors, where both values depend on the filters applied to the dashboard. +The percentage of visitors that take a desired action such as subscribing to a newsletter or signing up for an account. Calculated as follows: unique conversions for a goal / unique visitors, where both values depend on the filters applied to the dashboard. ## Custom Properties (or Custom Dimensions) From 6e8422b0d342777cfa0d2191d2c1e348bb0d7dc1 Mon Sep 17 00:00:00 2001 From: Karl-Aksel Puulmann Date: Mon, 7 Apr 2025 10:11:30 +0300 Subject: [PATCH 4/6] Add legacy section to time-on-page --- docs/metrics-definitions.md | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/docs/metrics-definitions.md b/docs/metrics-definitions.md index 3d993f19..054a486a 100644 --- a/docs/metrics-definitions.md +++ b/docs/metrics-definitions.md @@ -60,7 +60,7 @@ Automatically track the number of file downloads. This feature isn't enabled by ## Funnels -You can follow the visitor journey from a landing page to a conversion with [funnel analysis](funnel-analysis.md). +You can follow the visitor journey from a landing page to a conversion with [funnel analysis](funnel-analysis.md). ## Goals (or Events) @@ -100,7 +100,17 @@ See all referral sources that are sending you traffic. A source is reported when ## Time on Page -The average amount of time people spend viewing a particular page on your site. Since March 2025, we've improved our methodology by sending multiple `engagement` events per pageview and by triggering an event every time the visitor closes the browser tab or moves the focus away from the current tab. 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. +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. + +
+Legacy time on page metric + +Prior to a tracker script upgrade in March 2025, we used a different method to calculate time on page, instead relying on timestamp of each `pageview` event. This method was both prone to over-estimating time spent on a page and was unable to provide measurements on pages where visitors bounced. + +For dates prior to the new tracker upgrade, the legacy time on page metric is displayed along with a note in the tooltip. +
## Total Conversions From deb2f53851faf3e01de0c41903a82aaff29541d4 Mon Sep 17 00:00:00 2001 From: Karl-Aksel Puulmann Date: Mon, 7 Apr 2025 10:16:10 +0300 Subject: [PATCH 5/6] Add time-on-page to APIv2 docs --- docs/stats-api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/stats-api.md b/docs/stats-api.md index 11f477e5..154d16cd 100644 --- a/docs/stats-api.md +++ b/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. |
Read more about revenue metrics From 2a741d16ae2efde102e976528f682022c628f333 Mon Sep 17 00:00:00 2001 From: Karl-Aksel Puulmann Date: Mon, 7 Apr 2025 10:18:29 +0300 Subject: [PATCH 6/6] Wording --- docs/metrics-definitions.md | 2 +- docs/stats-api.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/metrics-definitions.md b/docs/metrics-definitions.md index 054a486a..736aafe2 100644 --- a/docs/metrics-definitions.md +++ b/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.
Legacy time on page metric diff --git a/docs/stats-api.md b/docs/stats-api.md index 154d16cd..5b17ad50 100644 --- a/docs/stats-api.md +++ b/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. |
Read more about revenue metrics