Skip to content

🐸 Rybbit - open-source and privacy-friendly alternative to Google Analytics that is 10x more intuitive.

Add bounce rate metrics to analytics API and UI components

Bill Yangae0db79336ee
diff --git a/client/src/api/analytics/useSingleCol.ts b/client/src/api/analytics/useSingleCol.ts
index 4c69c8978..e75e655e2 100644
--- a/client/src/api/analytics/useSingleCol.ts
+++ b/client/src/api/analytics/useSingleCol.ts
@@ -20,6 +20,7 @@ export type SingleColResponse = {
pageviews?: number;
pageviews_percentage?: number;
time_on_page_seconds?: number;
+ bounce_rate?: number;
};
export function useSingleCol({
diff --git a/client/src/app/[site]/components/shared/StandardSection/StandardSectionDialog.tsx b/client/src/app/[site]/components/shared/StandardSection/StandardSectionDialog.tsx
index 9b81357f7..d6e58af6d 100644
--- a/client/src/app/[site]/components/shared/StandardSection/StandardSectionDialog.tsx
+++ b/client/src/app/[site]/components/shared/StandardSection/StandardSectionDialog.tsx
@@ -148,6 +148,18 @@ export function StandardSectionDialog({
}) as any
);
}
+
+ const hasBounceRate = filteredData[0]?.bounce_rate !== undefined;
+ if (hasBounceRate) {
+ cols.push(
+ columnHelper.accessor("bounce_rate", {
+ header: "Bounce Rate",
+ cell: info => (
+ <div className="flex flex-row gap-1 items-center sm:justify-end">{info.getValue()?.toFixed(1)}%</div>
+ ),
+ }) as any
+ );
+ }
}
return cols;
diff --git a/server/src/api/analytics/getOverview.ts b/server/src/api/analytics/getOverview.ts
index fbde8dd7d..a50a1daf7 100644
--- a/server/src/api/analytics/getOverview.ts
+++ b/server/src/api/analytics/getOverview.ts
@@ -17,50 +17,72 @@ const getQuery = (params: FilterParams) => {
const filterStatement = getFilterStatement(params.filters);
const timeStatement = getTimeStatement(params);
- return `SELECT
- session_stats.sessions,
- session_stats.pages_per_session,
- session_stats.bounce_rate * 100 AS bounce_rate,
- session_stats.session_duration,
- page_stats.pageviews,
- page_stats.users
+ return `
+ WITH
+ -- First, calculate total pageviews per session (no filters except time)
+ AllSessionPageviews AS (
+ SELECT
+ session_id,
+ COUNT(CASE WHEN type = 'pageview' THEN 1 END) AS total_pageviews_in_session
+ FROM events
+ WHERE
+ site_id = {siteId:Int32}
+ ${timeStatement}
+ GROUP BY session_id
+ ),
+ -- Then get session data with filters applied
+ FilteredSessions AS (
+ SELECT
+ session_id,
+ MIN(timestamp) AS start_time,
+ MAX(timestamp) AS end_time
+ FROM events
+ WHERE
+ site_id = {siteId:Int32}
+ ${filterStatement}
+ ${timeStatement}
+ GROUP BY session_id
+ ),
+ -- Join to get sessions with their total pageviews
+ SessionsWithPageviews AS (
+ SELECT
+ fs.session_id,
+ fs.start_time,
+ fs.end_time,
+ asp.total_pageviews_in_session
+ FROM FilteredSessions fs
+ LEFT JOIN AllSessionPageviews asp ON fs.session_id = asp.session_id
+ )
+ SELECT
+ session_stats.sessions,
+ session_stats.pages_per_session,
+ session_stats.bounce_rate * 100 AS bounce_rate,
+ session_stats.session_duration,
+ page_stats.pageviews,
+ page_stats.users
FROM
(
-- Session-level metrics
SELECT
COUNT() AS sessions,
- AVG(pages_in_session) AS pages_per_session,
- sumIf(1, pages_in_session = 1) / COUNT() AS bounce_rate,
+ AVG(total_pageviews_in_session) AS pages_per_session,
+ sumIf(1, total_pageviews_in_session = 1) / COUNT() AS bounce_rate,
AVG(end_time - start_time) AS session_duration
- FROM
- (
- -- One row per session
- SELECT
- session_id,
- MIN(timestamp) AS start_time,
- MAX(timestamp) AS end_time,
- COUNT(CASE WHEN type = 'pageview' THEN 1 END) AS pages_in_session
- FROM events
- WHERE
- site_id = {siteId:Int32}
- ${filterStatement}
- ${timeStatement}
- GROUP BY session_id
- )
- ) AS session_stats
- CROSS JOIN
- (
- -- Page-level and user-level metrics
- SELECT
- COUNT(CASE WHEN type = 'pageview' THEN 1 END) AS pageviews,
- COUNT(DISTINCT user_id) AS users
- FROM events
- WHERE
- site_id = {siteId:Int32}
- ${filterStatement}
- ${timeStatement}
- -- AND type = 'pageview'
- ) AS page_stats`;
+ FROM SessionsWithPageviews
+ ) AS session_stats
+ CROSS JOIN
+ (
+ -- Page-level and user-level metrics
+ SELECT
+ COUNT(CASE WHEN type = 'pageview' THEN 1 END) AS pageviews,
+ COUNT(DISTINCT user_id) AS users
+ FROM events
+ WHERE
+ site_id = {siteId:Int32}
+ ${filterStatement}
+ ${timeStatement}
+ -- AND type = 'pageview'
+ ) AS page_stats`;
};
export interface OverviewRequest {
diff --git a/server/src/api/analytics/getOverviewBucketed.ts b/server/src/api/analytics/getOverviewBucketed.ts
index e3a607e23..f32a119cb 100644
--- a/server/src/api/analytics/getOverviewBucketed.ts
+++ b/server/src/api/analytics/getOverviewBucketed.ts
@@ -78,6 +78,41 @@ const getQuery = (params: FilterParams<{ bucket: TimeBucket }>) => {
const isAllTime = !startDate && !endDate && !pastMinutesRange;
const query = `
+WITH
+-- First, calculate total pageviews per session (no parameter filters)
+AllSessionPageviews AS (
+ SELECT
+ session_id,
+ countIf(type = 'pageview') AS total_pageviews_in_session
+ FROM events
+ WHERE
+ site_id = {siteId:Int32}
+ ${getTimeStatement(params)}
+ GROUP BY session_id
+),
+-- Then get session data with filters applied
+FilteredSessions AS (
+ SELECT
+ session_id,
+ MIN(timestamp) AS start_time,
+ MAX(timestamp) AS end_time
+ FROM events
+ WHERE
+ site_id = {siteId:Int32}
+ ${filterStatement}
+ ${getTimeStatement(params)}
+ GROUP BY session_id
+),
+-- Join to get sessions with their total pageviews
+SessionsWithPageviews AS (
+ SELECT
+ fs.session_id,
+ fs.start_time,
+ fs.end_time,
+ asp.total_pageviews_in_session
+ FROM FilteredSessions fs
+ LEFT JOIN AllSessionPageviews asp ON fs.session_id = asp.session_id
+)
SELECT
session_stats.time AS time,
session_stats.sessions,
@@ -86,29 +121,15 @@ SELECT
session_stats.session_duration,
page_stats.pageviews,
page_stats.users
-FROM
+FROM
(
SELECT
toDateTime(${TimeBucketToFn[bucket]}(toTimeZone(start_time, ${SqlString.escape(timeZone)}))) AS time,
COUNT() AS sessions,
- AVG(pages_in_session) AS pages_per_session,
- sumIf(1, pages_in_session = 1) / COUNT() AS bounce_rate,
+ AVG(total_pageviews_in_session) AS pages_per_session,
+ sumIf(1, total_pageviews_in_session = 1) / COUNT() AS bounce_rate,
AVG(end_time - start_time) AS session_duration
- FROM
- (
- /* One row per session */
- SELECT
- session_id,
- MIN(timestamp) AS start_time,
- MAX(timestamp) AS end_time,
- countIf(type = 'pageview') AS pages_in_session
- FROM events
- WHERE
- site_id = {siteId:Int32}
- ${filterStatement}
- ${getTimeStatement(params)}
- GROUP BY session_id
- )
+ FROM SessionsWithPageviews
GROUP BY time ORDER BY time ${isAllTime ? "" : getTimeStatementFill(params, bucket)}
) AS session_stats
FULL JOIN
diff --git a/server/src/api/analytics/getSingleCol.ts b/server/src/api/analytics/getSingleCol.ts
index dc56f0d78..e762b6b8b 100644
--- a/server/src/api/analytics/getSingleCol.ts
+++ b/server/src/api/analytics/getSingleCol.ts
@@ -27,6 +27,7 @@ type GetSingleColResponse = {
pageviews?: number; // pageviews of this specific page when it was an entry/exit
pageviews_percentage?: number;
time_on_page_seconds?: number; // avg time on this page when it was an entry/exit
+ bounce_rate?: number; // percentage of sessions that were bounces (single pageview)
}[];
// This type represents a single item in the array returned *within* the data property
@@ -39,6 +40,7 @@ type SingleColItem = {
pageviews?: number;
pageviews_percentage?: number;
time_on_page_seconds?: number;
+ bounce_rate?: number;
};
// This is the structure the API will now send
@@ -114,7 +116,7 @@ const getQuery = (request: FastifyRequest<GetSingleColRequest>, isCountQuery: bo
FROM events
WHERE
site_id = {siteId:Int32}
- AND page_title IS NOT NULL
+ AND page_title IS NOT NULL
AND page_title <> ''
-- AND type = 'pageview'
${filterStatement}
@@ -127,18 +129,46 @@ const getQuery = (request: FastifyRequest<GetSingleColRequest>, isCountQuery: bo
}
return `
- WITH TitleStats AS (
- ${corePageTitleLogic}
+ WITH SessionPageCounts AS (
+ SELECT
+ session_id,
+ COUNT() as pageviews_in_session
+ FROM events
+ WHERE
+ site_id = {siteId:Int32}
+ AND type = 'pageview'
+ ${timeStatement}
+ GROUP BY session_id
+ ),
+ TitleStatsWithSessions AS (
+ SELECT
+ e.page_title as value,
+ argMax(e.pathname, e.timestamp) as pathname,
+ e.session_id,
+ spc.pageviews_in_session
+ FROM events e
+ LEFT JOIN SessionPageCounts spc ON e.session_id = spc.session_id
+ WHERE
+ e.site_id = {siteId:Int32}
+ AND e.page_title IS NOT NULL
+ AND e.page_title <> ''
+ ${filterStatement}
+ ${timeStatement}
)
SELECT
value, -- This is page_title
- pathname, -- This is the representative pathname
- unique_sessions as count,
+ any(pathname) as pathname, -- This is the representative pathname
+ COUNT(DISTINCT session_id) as count,
ROUND(
- unique_sessions * 100.0 / SUM(unique_sessions) OVER (),
+ COUNT(DISTINCT session_id) * 100.0 / SUM(COUNT(DISTINCT session_id)) OVER (),
2
- ) as percentage
- FROM TitleStats
+ ) as percentage,
+ ROUND(
+ countIf(DISTINCT session_id, pageviews_in_session = 1) * 100.0 / nullIf(COUNT(DISTINCT session_id), 0),
+ 2
+ ) as bounce_rate
+ FROM TitleStatsWithSessions
+ GROUP BY value
ORDER BY count DESC
${limitStatement}
${offsetStatement};
@@ -151,11 +181,25 @@ const getQuery = (request: FastifyRequest<GetSingleColRequest>, isCountQuery: bo
const rowNumFilter = isEntry ? "row_num = 1" : "row_num = 1";
const baseCteQuery = `
- RelevantEvents AS (
- SELECT *
+ SessionPageCounts AS (
+ SELECT
+ session_id,
+ COUNT() as pageviews_in_session
FROM events
WHERE
site_id = {siteId:Int32}
+ AND type = 'pageview'
+ ${timeStatement}
+ GROUP BY session_id
+ ),
+ RelevantEvents AS (
+ SELECT
+ e.*,
+ spc.pageviews_in_session
+ FROM events e
+ LEFT JOIN SessionPageCounts spc ON e.session_id = spc.session_id
+ WHERE
+ e.site_id = {siteId:Int32}
-- AND type = 'pageview'
${filterStatement}
${timeStatement}
@@ -165,6 +209,7 @@ const getQuery = (request: FastifyRequest<GetSingleColRequest>, isCountQuery: bo
session_id,
pathname,
timestamp,
+ pageviews_in_session,
leadInFrame(timestamp) OVER (PARTITION BY session_id ORDER BY timestamp ROWS BETWEEN CURRENT ROW AND 1 FOLLOWING) as next_timestamp,
row_number() OVER (PARTITION BY session_id ORDER BY timestamp ${orderDirection}) as row_num
FROM RelevantEvents
@@ -176,6 +221,7 @@ const getQuery = (request: FastifyRequest<GetSingleColRequest>, isCountQuery: bo
timestamp,
next_timestamp,
row_num,
+ pageviews_in_session,
if(isNull(next_timestamp), 0, dateDiff('second', timestamp, next_timestamp)) as time_diff_seconds
FROM EventTimes
),
@@ -189,7 +235,8 @@ const getQuery = (request: FastifyRequest<GetSingleColRequest>, isCountQuery: bo
pathname,
count(DISTINCT session_id) as unique_sessions,
count() as visits,
- avg(if(time_diff_seconds < 0, 0, if(time_diff_seconds > 1800, 1800, time_diff_seconds))) as avg_time_on_page_seconds
+ avg(if(time_diff_seconds < 0, 0, if(time_diff_seconds > 1800, 1800, time_diff_seconds))) as avg_time_on_page_seconds,
+ countIf(DISTINCT session_id, pageviews_in_session = 1) as bounced_sessions
FROM FilteredDurations
WHERE pathname IS NOT NULL AND pathname <> ''
GROUP BY pathname
@@ -206,12 +253,13 @@ const getQuery = (request: FastifyRequest<GetSingleColRequest>, isCountQuery: bo
return `
WITH ${baseCteQuery}
SELECT
- pathname as value,
+ pathname as value,
unique_sessions as count,
round((unique_sessions / sum(unique_sessions) OVER ()) * 100, 2) as percentage,
visits as pageviews,
round((visits / sum(visits) OVER ()) * 100, 2) as pageviews_percentage,
- avg_time_on_page_seconds as time_on_page_seconds
+ avg_time_on_page_seconds as time_on_page_seconds,
+ round((bounced_sessions / nullIf(unique_sessions, 0)) * 100, 2) as bounce_rate
FROM PathStats
ORDER BY unique_sessions DESC
${limitStatement}
@@ -220,15 +268,28 @@ const getQuery = (request: FastifyRequest<GetSingleColRequest>, isCountQuery: bo
if (parameter === "pathname") {
const baseCteQuery = `
- EventTimes AS (
+ SessionPageCounts AS (
SELECT
session_id,
- pathname,
- timestamp,
- leadInFrame(timestamp) OVER (PARTITION BY session_id ORDER BY timestamp ROWS BETWEEN CURRENT ROW AND 1 FOLLOWING) as next_timestamp
+ COUNT() as pageviews_in_session
FROM events
- WHERE
- site_id = {siteId:Int32}
+ WHERE
+ site_id = {siteId:Int32}
+ AND type = 'pageview'
+ ${timeStatement}
+ GROUP BY session_id
+ ),
+ EventTimes AS (
+ SELECT
+ e.session_id,
+ e.pathname,
+ e.timestamp,
+ spc.pageviews_in_session,
+ leadInFrame(e.timestamp) OVER (PARTITION BY e.session_id ORDER BY e.timestamp ROWS BETWEEN CURRENT ROW AND 1 FOLLOWING) as next_timestamp
+ FROM events e
+ LEFT JOIN SessionPageCounts spc ON e.session_id = spc.session_id
+ WHERE
+ e.site_id = {siteId:Int32}
-- AND type = 'pageview'
${filterStatement}
${timeStatement}
@@ -239,6 +300,7 @@ const getQuery = (request: FastifyRequest<GetSingleColRequest>, isCountQuery: bo
pathname,
timestamp,
next_timestamp,
+ pageviews_in_session,
if(isNull(next_timestamp), 0, dateDiff('second', timestamp, next_timestamp)) as time_diff_seconds
FROM EventTimes
),
@@ -247,7 +309,8 @@ const getQuery = (request: FastifyRequest<GetSingleColRequest>, isCountQuery: bo
pathname,
count() as visits,
count(DISTINCT session_id) as unique_sessions,
- avg(if(time_diff_seconds < 0, 0, if(time_diff_seconds > 1800, 1800, time_diff_seconds))) as avg_time_on_page_seconds
+ avg(if(time_diff_seconds < 0, 0, if(time_diff_seconds > 1800, 1800, time_diff_seconds))) as avg_time_on_page_seconds,
+ countIf(DISTINCT session_id, pageviews_in_session = 1) as bounced_sessions
FROM PageDurations
GROUP BY pathname
)
@@ -266,7 +329,8 @@ const getQuery = (request: FastifyRequest<GetSingleColRequest>, isCountQuery: bo
round((unique_sessions / sum(unique_sessions) OVER ()) * 100, 2) as percentage,
visits as pageviews,
round((visits / sum(visits) OVER ()) * 100, 2) as pageviews_percentage,
- avg_time_on_page_seconds as time_on_page_seconds
+ avg_time_on_page_seconds as time_on_page_seconds,
+ round((bounced_sessions / nullIf(unique_sessions, 0)) * 100, 2) as bounce_rate
FROM PathStats
ORDER BY unique_sessions DESC
${limitStatement}
@@ -290,27 +354,40 @@ const getQuery = (request: FastifyRequest<GetSingleColRequest>, isCountQuery: bo
}
return `
- WITH PageStats AS (
- SELECT
- ${sqlParam} as value,
- COUNT(distinct(session_id)) as unique_sessions,
- COUNT() as pageviews
- FROM events
- WHERE
- site_id = {siteId:Int32}
- AND ${sqlParam} IS NOT NULL
- AND ${sqlParam} <> ''
- ${filterStatement}
- ${timeStatement}
- GROUP BY value
+ WITH SessionPageCounts AS (
+ SELECT
+ session_id,
+ COUNT() as pageviews_in_session
+ FROM events
+ WHERE
+ site_id = {siteId:Int32}
+ AND type = 'pageview'
+ ${timeStatement}
+ GROUP BY session_id
+ ),
+ SessionData AS (
+ SELECT
+ ${sqlParam} as value,
+ e.session_id,
+ spc.pageviews_in_session
+ FROM events e
+ LEFT JOIN SessionPageCounts spc ON e.session_id = spc.session_id
+ WHERE
+ e.site_id = {siteId:Int32}
+ AND ${sqlParam} IS NOT NULL
+ AND ${sqlParam} <> ''
+ ${filterStatement}
+ ${timeStatement}
)
SELECT
- value,
- unique_sessions as count,
- round((unique_sessions / sum(unique_sessions) OVER ()) * 100, 2) as percentage,
- pageviews,
- round((pageviews / sum(pageviews) OVER ()) * 100, 2) as pageviews_percentage
- FROM PageStats
+ value,
+ COUNT(DISTINCT session_id) as count,
+ round((COUNT(DISTINCT session_id) / sum(COUNT(DISTINCT session_id)) OVER ()) * 100, 2) as percentage,
+ COUNT() as pageviews,
+ round((COUNT() / sum(COUNT()) OVER ()) * 100, 2) as pageviews_percentage,
+ round((countIf(DISTINCT session_id, pageviews_in_session = 1) / nullIf(COUNT(DISTINCT session_id), 0)) * 100, 2) as bounce_rate
+ FROM SessionData
+ GROUP BY value
ORDER BY count desc
${limitStatement}
${offsetStatement};