A platform for community discussion. Free, open, simple.
FEATURE: Add direct traffic KPI to the Site Traffic dashboard (#41274)
Alan Guo Xiang Tan247c2ad7750a
diff --git a/app/services/admin_dashboard_site_traffic.rb b/app/services/admin_dashboard_site_traffic.rbindex 44ee936e7d7..1dca17ec4ab 100644--- a/app/services/admin_dashboard_site_traffic.rb+++ b/app/services/admin_dashboard_site_traffic.rb@@ -108,6 +108,9 @@ class AdminDashboardSiteTraffickpis[:logged_in_share] = { value: logged_in_share } if !logged_in_share.nil?+ direct_traffic = direct_traffic_value+ kpis[:direct_traffic] = { value: direct_traffic } if !direct_traffic.nil?+kpisend@@ -126,6 +129,25 @@ class AdminDashboardSiteTraffictotals[:human].positive? ? ((totals[:logged_in].to_f / totals[:human]) * 100).round : 0end+ def direct_traffic_value+ return nil if !SiteSetting.persist_browser_pageview_events++ count_column = login_required? ? "logged_in_count" : "count"++ row = DB.query(<<~SQL, start_date: start_date.to_date, end_date: end_date.to_date).first+ SELECT+ COALESCE(SUM(#{count_column}), 0)::bigint AS total,+ COALESCE(SUM(#{count_column}) FILTER (WHERE normalized_referrer IS NULL), 0)::bigint AS direct+ FROM browser_pageview_referrer_daily_rollups+ WHERE date >= :start_date+ AND date <= :end_date+ SQL++ return nil if row.total.zero?++ ((row.direct.to_f / row.total) * 100).round+ end+def pageview_series(rows, include_embedded:)series_ids(include_embedded: include_embedded).map do |id|{diff --git a/config/locales/client.en.yml b/config/locales/client.en.ymlindex 05420eb7791..cb49dc7fb3e 100644--- a/config/locales/client.en.yml+++ b/config/locales/client.en.yml@@ -7319,6 +7319,9 @@ en:logged_in_share:label: "Logged-in share"tooltip: "The share of pageviews from logged-in members."+ direct_traffic:+ label: "Direct traffic"+ tooltip: "The share of pageviews that came directly to your community, such as by typing your URL or using a browser bookmark."top_countries:title: "Top countries"empty: "No country data for this period."diff --git a/frontend/discourse/admin/components/dashboard/traffic.gjs b/frontend/discourse/admin/components/dashboard/traffic.gjsindex 72fad15affb..65f8ecd77d9 100644--- a/frontend/discourse/admin/components/dashboard/traffic.gjs+++ b/frontend/discourse/admin/components/dashboard/traffic.gjs@@ -95,6 +95,15 @@ export default class DashboardTraffic extends Component {return `${this.args.traffic?.kpis?.logged_in_share?.value ?? 0}%`;}+ get showDirectTraffic() {+ const directTraffic = this.args.traffic?.kpis?.direct_traffic?.value;+ return directTraffic !== null && directTraffic !== undefined;+ }++ get directTraffic() {+ return `${this.args.traffic?.kpis?.direct_traffic?.value ?? 0}%`;+ }+get chartModel() {return {start_date: this.args.startDate,@@ -224,29 +233,55 @@ export default class DashboardTraffic extends Component {</p> }}</div>- {{#if this.showLoggedInShare}}+ {{#if (or this.showLoggedInShare this.showDirectTraffic)}}<div class="db-section__metrics">- <div class="db-section__metric">- <div- class="db-section__metric-number"- >{{this.loggedInShare}}</div>- <div class="db-section__metric-label">- {{i18n- "admin.dashboard.site_traffic.kpi.logged_in_share.label"- }}- <DTooltip- class="db-section__info"- @identifier="site-traffic-logged-in-share-tooltip"- @icon="far-circle-question"- >- <:content>- {{i18n- "admin.dashboard.site_traffic.kpi.logged_in_share.tooltip"- }}- </:content>- </DTooltip>+ {{#if this.showLoggedInShare}}+ <div class="db-section__metric">+ <div+ class="db-section__metric-number"+ >{{this.loggedInShare}}</div>+ <div class="db-section__metric-label">+ {{i18n+ "admin.dashboard.site_traffic.kpi.logged_in_share.label"+ }}+ <DTooltip+ class="db-section__info"+ @identifier="site-traffic-logged-in-share-tooltip"+ @icon="far-circle-question"+ >+ <:content>+ {{i18n+ "admin.dashboard.site_traffic.kpi.logged_in_share.tooltip"+ }}+ </:content>+ </DTooltip>+ </div></div>- </div>+ {{/if}}++ {{#if this.showDirectTraffic}}+ <div class="db-section__metric">+ <div+ class="db-section__metric-number"+ >{{this.directTraffic}}</div>+ <div class="db-section__metric-label">+ {{i18n+ "admin.dashboard.site_traffic.kpi.direct_traffic.label"+ }}+ <DTooltip+ class="db-section__info"+ @identifier="site-traffic-direct-traffic-tooltip"+ @icon="far-circle-question"+ >+ <:content>+ {{i18n+ "admin.dashboard.site_traffic.kpi.direct_traffic.tooltip"+ }}+ </:content>+ </DTooltip>+ </div>+ </div>+ {{/if}}</div>{{/if}}</div>diff --git a/spec/services/admin_dashboard_site_traffic_spec.rb b/spec/services/admin_dashboard_site_traffic_spec.rbindex 1679e16af04..161c1f3fdee 100644--- a/spec/services/admin_dashboard_site_traffic_spec.rb+++ b/spec/services/admin_dashboard_site_traffic_spec.rb@@ -686,5 +686,130 @@ RSpec.describe AdminDashboardSiteTraffic doexpect(second[:top_countries][:rows].first[:country_code]).to eq("US")endend++ context "for direct traffic share" do+ before { SiteSetting.persist_browser_pageview_events = true }++ def aggregate_referrer_rollups+ BrowserPageviewReferrerDailyRollup.aggregate(+ start_date: "2026-05-01".to_date,+ end_date: "2026-05-01".to_date,+ )+ end++ it "returns the rounded share of pageviews that arrived with no referrer" do+ 3.times do+ Fabricate(:browser_pageview_event, normalized_referrer: nil, created_at: "2026-05-01")+ end+ 9.times do+ Fabricate(+ :browser_pageview_event,+ normalized_referrer: "google.com",+ created_at: "2026-05-01",+ )+ end+ aggregate_referrer_rollups++ expect(build_traffic(start_date: "2026-05-01", end_date: "2026-05-03")[:kpis]).to eq(+ browser_pageviews: {+ value: 0,+ },+ logged_in_share: {+ value: 0,+ },+ direct_traffic: {+ value: 25,+ },+ )+ end++ it "reports zero direct traffic when every tracked pageview had a referrer" do+ 4.times do+ Fabricate(+ :browser_pageview_event,+ normalized_referrer: "google.com",+ created_at: "2026-05-01",+ )+ end+ aggregate_referrer_rollups++ expect(build_traffic(start_date: "2026-05-01", end_date: "2026-05-03")[:kpis]).to eq(+ browser_pageviews: {+ value: 0,+ },+ logged_in_share: {+ value: 0,+ },+ direct_traffic: {+ value: 0,+ },+ )+ end++ it "computes the share from logged-in pageviews only when login is required" do+ SiteSetting.login_required = true+ member = Fabricate(:user)++ Fabricate(+ :browser_pageview_event,+ normalized_referrer: nil,+ user_id: member.id,+ created_at: "2026-05-01",+ )+ Fabricate(+ :browser_pageview_event,+ normalized_referrer: nil,+ user_id: nil,+ created_at: "2026-05-01",+ )+ 2.times do+ Fabricate(+ :browser_pageview_event,+ normalized_referrer: "google.com",+ user_id: member.id,+ created_at: "2026-05-01",+ )+ end+ aggregate_referrer_rollups++ expect(build_traffic(start_date: "2026-05-01", end_date: "2026-05-03")[:kpis]).to eq(+ browser_pageviews: {+ value: 0,+ },+ direct_traffic: {+ value: 33,+ },+ )+ end++ it "omits direct traffic when persist_browser_pageview_events is disabled" do+ SiteSetting.persist_browser_pageview_events = false++ 3.times do+ Fabricate(:browser_pageview_event, normalized_referrer: nil, created_at: "2026-05-01")+ end+ aggregate_referrer_rollups++ expect(build_traffic(start_date: "2026-05-01", end_date: "2026-05-03")[:kpis]).to eq(+ browser_pageviews: {+ value: 0,+ },+ logged_in_share: {+ value: 0,+ },+ )+ end++ it "omits direct traffic when no pageviews were tracked in the period" do+ expect(build_traffic(start_date: "2026-05-01", end_date: "2026-05-03")[:kpis]).to eq(+ browser_pageviews: {+ value: 0,+ },+ logged_in_share: {+ value: 0,+ },+ )+ end+ endendenddiff --git a/spec/system/admin_dashboard_redesign/site_traffic_section_spec.rb b/spec/system/admin_dashboard_redesign/site_traffic_section_spec.rbindex 2ad45c10d4f..6b237cbc002 100644--- a/spec/system/admin_dashboard_redesign/site_traffic_section_spec.rb+++ b/spec/system/admin_dashboard_redesign/site_traffic_section_spec.rb@@ -170,6 +170,7 @@ describe "Admin Dashboard Redesign | Site Traffic section" doexpect(traffic).to have_no_top_countries_cardexpect(traffic).to have_no_top_referrers_card+ expect(traffic).to have_no_metric("Direct traffic")endit "shows ranked top countries and top referrers when events exist in the period",@@ -234,6 +235,13 @@ describe "Admin Dashboard Redesign | Site Traffic section" do{ referrer: "reddit.com/r/discourse", percent: 33 },],)++ expect(traffic).to have_metric("Direct traffic", "10%")++ traffic.hover_direct_traffic_tooltip+ expect(traffic).to have_direct_traffic_tooltip(+ "The share of pageviews that came directly to your community, such as by typing your URL or using a browser bookmark.",+ )endit "shows an empty state in both cards but keeps the headers as drill-down links when no events qualify",@@ -245,6 +253,7 @@ describe "Admin Dashboard Redesign | Site Traffic section" doexpect(traffic).to have_top_referrers_empty_stateexpect(traffic).to have_top_referrers_drilldownexpect(traffic).to have_top_countries_drilldown+ expect(traffic).to have_no_metric("Direct traffic")endit "drills into the full top referrers report scoped to the dashboard period",diff --git a/spec/system/page_objects/components/admin_dashboard_site_traffic.rb b/spec/system/page_objects/components/admin_dashboard_site_traffic.rbindex d5eadf46ff7..6f2b91b2d52 100644--- a/spec/system/page_objects/components/admin_dashboard_site_traffic.rb+++ b/spec/system/page_objects/components/admin_dashboard_site_traffic.rb@@ -66,6 +66,15 @@ module PageObjectsTooltips.new("site-traffic-logged-in-share-tooltip").present?(text: text)end+ def hover_direct_traffic_tooltip+ find("[data-trigger][data-identifier='site-traffic-direct-traffic-tooltip']").hover+ self+ end++ def has_direct_traffic_tooltip?(text)+ Tooltips.new("site-traffic-direct-traffic-tooltip").present?(text: text)+ end+def has_no_top_countries_card?has_no_top_card?("Top countries")end