Skip to content

📈 Open source, privacy-first web analytics — a cookie-less Google Analytics alternative with built-in error tracking and performance monitoring. Self-host it or use our cloud. Get started for free!

traffic analytics & segments

Blue Mouse94ef2ef42eef
diff --git a/docs/docs/analytics-dashboard/segments.md b/docs/docs/analytics-dashboard/segments.md
new file mode 100644
index 000000000..e1893082b
--- /dev/null
+++ b/docs/docs/analytics-dashboard/segments.md
@@ -0,0 +1,37 @@
+---
+id: segments
+title: Segments
+sidebar_label: Segments
+---
+
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
+Segments (also known as Saved Views) allow you to save a specific configuration of filters and custom metrics for quick access. Instead of manually reapplying the same filters every time you visit your dashboard, you can simply switch to a saved Segment.
+
+<img alt="Segments Modal" src={useBaseUrl('img/analytics-dashboard/segments.png')} />
+
+## Creating a Segment
+
+1. **Apply Filters**: Set up the dashboard exactly how you want it. This includes:
+ - Date ranges and time buckets.
+ - Specific filters (e.g., Country = USA, Browser = Chrome).
+ - Selected metrics on the chart.
+2. **Open Segments Menu**: Click on the **Segments** dropdown (bookmark icon) in the top right header.
+3. **Add Segment**: Select **Add a segment**.
+4. **Name It**: Give your segment a descriptive name (e.g., "US Mobile Traffic").
+5. **Save**: Confirm to save your current view.
+
+## Using a Segment
+
+To switch to a saved segment:
+
+1. Click the **Segments** dropdown.
+2. Select the segment you wish to view from the list.
+3. The dashboard will immediately update to reflect the saved configuration.
+
+## Managing Segments
+
+You can manage your segments directly from the dropdown menu:
+
+- **Edit**: Click the pencil icon next to a segment to rename it or update its configuration.
+- **Delete**: Click the trash icon to remove a segment you no longer need.
diff --git a/docs/docs/analytics-dashboard/traffic.md b/docs/docs/analytics-dashboard/traffic.md
new file mode 100644
index 000000000..60d478837
--- /dev/null
+++ b/docs/docs/analytics-dashboard/traffic.md
@@ -0,0 +1,108 @@
+---
+id: traffic
+title: Traffic Analytics
+sidebar_label: Traffic Analytics
+---
+
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
+The Traffic Analytics dashboard is the core of Swetrix, providing comprehensive insights into your website's visitors, their behavior, and traffic sources. It allows you to visualize data through interactive charts and detailed breakdowns.
+
+<img alt="Traffic Dashboard" src={useBaseUrl('img/analytics-dashboard/screenshot_light.png')} />
+
+## Overview
+
+The Traffic view consolidates all essential metrics into a single, easy-to-read interface. You can track visitor trends, analyze specific segments, and drill down into detailed reports.
+
+### Key Metrics
+
+The main chart visualizes various metrics to help you understand your traffic performance:
+
+- **Sessions (Unique)**: The number of unique visitors to your site within the selected timeframe.
+- **Pageviews**: The total number of pages viewed.
+- **Session Duration**: The average time visitors spend on your site per session.
+- **Bounce Rate**: The percentage of visitors who navigate away from the site after viewing only one page.
+- **Views per Unique**: The average number of pages viewed by a single unique visitor.
+- **Revenue**: Total revenue generated (if revenue tracking is enabled).
+
+You can also enable **Trendlines** to see the general direction of your data and **Cumulative Mode** to view data accumulation over time.
+
+## Traffic Breakdown
+
+Below the main chart, you will find detailed panels categorizing your traffic data:
+
+### Location
+
+Analyze where your visitors are coming from. You can view data by:
+
+- **Country code & Name**
+- **Region**
+- **City**
+- **Language**
+- **Map View**: An interactive map visualizing visitor distribution.
+
+### Devices
+
+Understand the technology your visitors are using:
+
+- **Browser**
+- **Operating System (OS)**
+- **Device Type** (Desktop, Mobile, Tablet, etc.)
+
+### Pages
+
+See which parts of your website are most popular:
+
+- **Page Paths**: The specific URLs visited.
+- **Entry Pages**: The first page visitors land on.
+- **Exit Pages**: The last page visitors view before leaving.
+- **User Flow**: Visualize the path users take through your site.
+- **Host**: Useful for cross-domain tracking, showing which specific domain or subdomain the traffic originated from.
+
+### Traffic Sources
+
+Identify how visitors find your website:
+
+- **Referrers**: External websites linking to yours.
+- **Source / Medium**: Detailed breakdown of acquisition channels (e.g., `google / organic`, `newsletter / email`).
+- **Campaigns**: Track specific marketing campaigns via UTM parameters.
+ :::tip
+ Use our free **[UTM Generator](https://swetrix.com/tools/utm-generator)** to easily build trackable URLs for your campaigns.
+ :::
+- **Keywords**: If you have connected Google Search Console, this tab shows the search queries driving traffic to your site.
+ - [Learn more about Google Search Console integration](../integrations/google-search-console.md).
+
+## Custom Events & Metadata
+
+Swetrix allows you to track specific interactions beyond standard pageviews.
+
+- **Custom Events**: A dedicated panel shows the performance of your tracked events (e.g., "Button Clicked", "Form Submitted").
+- **Metadata**: You can view detailed breakdowns of metadata attached to both Pageviews and Custom Events in their respective panels.
+
+## Timeframes & Comparisons
+
+You can analyze data over various periods using the time selector in the top right corner:
+
+- **Standard Periods**: Today, Yesterday, Last 7 days, Last 30 days, Month to Date, etc.
+- **Custom Range**: Select specific start and end dates.
+- **Time Buckets**: Group chart data by Hour, Day, Week, Month, or Year for better trend analysis.
+
+You can also **Compare** the current period with a previous one (e.g., "Previous period" or "Same period last year") to identify growth or decline.
+
+## Segments (Saved Views)
+
+You can save specific filter configurations as **Segments** to quickly access them later. This is useful for frequently analyzing specific user groups, such as "Mobile Users from US" or "Paid Traffic".
+
+- [Learn more about Segments](./segments.md)
+
+## Annotations
+
+Annotations allow you to mark significant events directly on your chart, such as a new feature launch or a marketing campaign.
+
+To create an annotation, simply **right-click** on a data point on the chart and select "Add annotation".
+
+- [Learn more about Annotations](../sitesettings/annotations.md)
+
+## Exporting Data
+
+You can export the current view's data (including the chart and all breakdown tables) to a CSV file for offline analysis or reporting. Click the **Export** icon (download symbol) in the header actions area.
diff --git a/docs/sidebars.js b/docs/sidebars.js
index 6376943c9..18d3ca51b 100644
--- a/docs/sidebars.js
+++ b/docs/sidebars.js
@@ -26,11 +26,13 @@ module.exports = {
],
'Analytics Dashboard': [
'analytics-dashboard/ask-ai',
+ 'analytics-dashboard/traffic',
'analytics-dashboard/performance',
'analytics-dashboard/profiles-and-sessions',
'analytics-dashboard/feature-flags',
'analytics-dashboard/experiments',
'analytics-dashboard/revenue-tracking',
+ 'analytics-dashboard/segments',
],
'Site settings': [
'sitesettings/how-to-access-site-settings',
diff --git a/docs/static/img/analytics-dashboard/screenshot_light.png b/docs/static/img/analytics-dashboard/screenshot_light.png
new file mode 100644
index 000000000..a66f43203
Binary files /dev/null and b/docs/static/img/analytics-dashboard/screenshot_light.png differ
diff --git a/docs/static/img/analytics-dashboard/segments.png b/docs/static/img/analytics-dashboard/segments.png
new file mode 100644
index 000000000..42a46b9cd
Binary files /dev/null and b/docs/static/img/analytics-dashboard/segments.png differ