203 lines
10 KiB
Plaintext
203 lines
10 KiB
Plaintext
---
|
||
title: "Understand the overview"
|
||
description: "The overview is the main page of every OpenPanel project. It gives you a real-time picture of how your site or app is performing right now and over any time range you choose. This page explains every section and every number so you know exactly what you're looking at."
|
||
date: 2026-02-27
|
||
---
|
||
|
||
## Top stats
|
||
|
||
The row of metric cards at the top of the page is the fastest way to understand the health of your project. Each card shows the value for the selected time range and a comparison to the previous period of the same length.
|
||
|
||
### Unique Visitors
|
||
|
||
The number of distinct profile IDs recorded in the selected period. How accurate this is depends on whether you use [identify](/docs/get-started/identify-users):
|
||
|
||
- **Without identify**: OpenPanel generates an anonymous profile ID that rotates every 24 hours. A visitor returning on 10 different days will be counted as 10 unique visitors, because each day produces a new ID.
|
||
- **With identify**: The profile ID is tied to the user's real identity. The same person visiting on 10 different days is counted as 1 unique visitor across the entire period.
|
||
|
||
If cross-day deduplication matters to your analysis, set up [user identification](/docs/get-started/identify-users).
|
||
|
||
### Sessions
|
||
|
||
The total number of sessions in the selected period. A session begins when someone arrives on your site and ends after 30 minutes of inactivity or when they close the tab. One visitor can have many sessions across a day.
|
||
|
||
### Pageviews
|
||
|
||
The total number of page views (`screen_view` events) recorded across all sessions. Every time a visitor loads a page—including navigating between pages in a single session—it counts as one pageview.
|
||
|
||
### Pages per Session
|
||
|
||
The average number of pages viewed within a single session, calculated as `total pageviews / total sessions`. A higher number means visitors are exploring more of your site before leaving.
|
||
|
||
### Bounce Rate
|
||
|
||
The percentage of sessions where a visitor viewed only a single page and left. Calculated as `single-page sessions / total sessions × 100`. Lower is generally better—it means more visitors are engaging beyond the first page.
|
||
|
||
> A session is counted as a bounce if the visitor triggered exactly one `screen_view` event before the session ended. Sessions where visitors read one article deeply and leave still count as bounces.
|
||
|
||
### Session Duration
|
||
|
||
The average length of a session in seconds, calculated only from sessions where the visitor did something after the first page load (duration > 0). Sessions where a visitor immediately left are excluded from the average to avoid skewing the number.
|
||
|
||
### Revenue
|
||
|
||
The total monetary value tracked via `revenue` events in the selected period, displayed in your account currency. Revenue is only shown if you are tracking revenue events. See the [revenue tracking docs](/features/revenue-tracking) for setup instructions.
|
||
|
||
---
|
||
|
||
## The time-series chart
|
||
|
||
Directly below the stat cards is a line chart that shows how the selected metric changes over time. Click any stat card to switch the chart to that metric.
|
||
|
||
The chart uses the **interval** you select (hour, day, week, or month) to group data points. A faint dashed line shows the equivalent period from the previous comparison window, so you can spot trends at a glance.
|
||
|
||
When any metric other than Revenue is active, the chart also overlays revenue as green bars on a secondary Y-axis—this lets you correlate traffic patterns with revenue without switching cards.
|
||
|
||
The trailing edge of the line (the current, incomplete interval) is shown as a dashed segment to remind you that the period is still accumulating data.
|
||
|
||
---
|
||
|
||
## Insights
|
||
|
||
A scrollable row of insight cards appears below the chart once your project has at least 30 days of data. OpenPanel automatically detects significant trends across pageviews, entry pages, referrers, and countries—no configuration needed.
|
||
|
||
Each card shows:
|
||
- **Share**: The percentage of total traffic that property represents (e.g., "United States: 42% of all sessions")
|
||
- **Absolute change**: The raw increase or decrease in sessions compared to the previous period
|
||
- **Percentage change**: How much that property grew or declined relative to its own previous value
|
||
|
||
For example, if the US had 1,000 sessions last week and 1,200 this week, the card shows "+200 sessions (+20%)".
|
||
|
||
Clicking any insight card filters the entire overview page to show only data matching that property—letting you drill into what's driving the trend.
|
||
|
||
---
|
||
|
||
## Sources
|
||
|
||
The Sources widget shows where your visitors came from. Switch between tabs to see different dimensions:
|
||
|
||
| Tab | What it shows |
|
||
|-----|---------------|
|
||
| **Refs** | Grouped referrer names (e.g., "Google", "Twitter", "Hacker News") |
|
||
| **Urls** | Raw referrer URLs |
|
||
| **Types** | Referrer categories: `search`, `social`, `email`, `unknown` |
|
||
| **Source** | `utm_source` query parameter values |
|
||
| **Medium** | `utm_medium` query parameter values |
|
||
| **Campaign** | `utm_campaign` query parameter values |
|
||
| **Term** | `utm_term` query parameter values |
|
||
| **Content** | `utm_content` query parameter values |
|
||
|
||
Referrer names and types are resolved automatically from the raw referrer URL using a built-in lookup table. Direct traffic (no referrer) appears as `(not set)`.
|
||
|
||
Each row shows sessions and pageviews. Clicking a row filters the entire overview page to only show data from that source.
|
||
|
||
---
|
||
|
||
## Pages
|
||
|
||
The Pages widget shows which URLs your visitors are landing on, exiting from, and spending time on.
|
||
|
||
| Tab | What it shows |
|
||
|-----|---------------|
|
||
| **Top pages** | Pages ranked by unique sessions. Each row is a `origin + path` combination. |
|
||
| **Entry pages** | The first page of each session—the page where visitors arrived. |
|
||
| **Exit pages** | The last page of each session—the page where visitors left. |
|
||
|
||
High exit rates on a page are not always bad—they can reflect a page that successfully answers a question. High bounce on an entry page is more diagnostic. Compare entry and exit distributions to understand the shape of your user journeys.
|
||
|
||
Clicking a page row filters the whole overview to sessions that included that page.
|
||
|
||
---
|
||
|
||
## Devices
|
||
|
||
The Devices widget breaks down your audience by hardware and software. Switch between tabs:
|
||
|
||
| Tab | What it shows |
|
||
|-----|---------------|
|
||
| **Device** | Device type: Desktop, Mobile, Tablet |
|
||
| **Brand** | Hardware brand (Apple, Samsung, etc.) |
|
||
| **Model** | Specific device model |
|
||
| **Browser** | Browser name (Chrome, Safari, Firefox, etc.) |
|
||
| **Browser ver.** | Browser version number |
|
||
| **OS** | Operating system (macOS, Windows, iOS, Android, etc.) |
|
||
| **OS ver.** | Operating system version |
|
||
|
||
Each row shows sessions and pageviews. Use this widget to prioritize which browsers and operating systems to test and optimize for.
|
||
|
||
---
|
||
|
||
## Events
|
||
|
||
The Events widget shows the most frequent custom events fired in the selected period, ranked by count. System events (`session_start`, `session_end`, `screen_view`) are excluded—only the events you instrument yourself appear here.
|
||
|
||
Click any event to filter the overview to sessions where that event was fired.
|
||
|
||
---
|
||
|
||
## Geo
|
||
|
||
The Geo widget shows the geographic distribution of your visitors. Switch between tabs:
|
||
|
||
| Tab | What it shows |
|
||
|-----|---------------|
|
||
| **Country** | Visitor country, derived from IP geolocation |
|
||
| **Region** | State or province |
|
||
| **City** | City level |
|
||
|
||
Below the table, a world map plots the same data as a heatmap—darker areas represent more sessions. This gives you a quick visual of where your audience is concentrated.
|
||
|
||
Clicking a country, region, or city filters the whole overview to that location.
|
||
|
||
---
|
||
|
||
## Activity heatmap
|
||
|
||
The activity heatmap at the bottom of the page shows when your visitors are most active, broken down by day of the week (Monday through Sunday) and hour of the day (00:00–23:00). Each cell shows the **average** of the selected metric at that day-and-hour combination, averaged across all weeks in the selected period.
|
||
|
||
Darker cells indicate higher average values. Hover any cell to see the exact average.
|
||
|
||
You can switch the metric being visualized using the tabs above the heatmap:
|
||
|
||
- **Unique Visitors**
|
||
- **Sessions**
|
||
- **Pageviews**
|
||
- **Bounce Rate**
|
||
- **Pages / Session**
|
||
- **Session Duration**
|
||
|
||
Use the heatmap to identify peak traffic windows, plan campaigns, and schedule maintenance during quiet periods.
|
||
|
||
---
|
||
|
||
## User Journey
|
||
|
||
The User Journey (Sankey) diagram at the very bottom visualizes how visitors flow through your site within a session. It answers the question: after landing on page A, where do visitors go next?
|
||
|
||
**How it works:**
|
||
|
||
1. OpenPanel identifies the top 3 most common entry pages in the selected period.
|
||
2. From each entry page, it finds the top 3 most frequent next pages (step 2), then the top 3 from those (step 3), and so on up to the configured number of steps (default 5, adjustable to a maximum of 10).
|
||
3. Paths that represent less than 0.25% of total sessions are filtered out to reduce visual noise.
|
||
4. Consecutive duplicate pages within a session are collapsed into one step (e.g., if someone refreshed a page, it only counts once in the journey).
|
||
|
||
Each node shows the page URL. The width of the connecting flows is proportional to the number of sessions that followed that path.
|
||
|
||
Use the User Journey to find drop-off points, discover unexpected popular paths, and understand whether visitors are reaching your key conversion pages.
|
||
|
||
---
|
||
|
||
## Filters and time controls
|
||
|
||
Every widget on the overview page responds to the same set of global filters and time controls at the top of the page.
|
||
|
||
**Range**: choose a preset (Today, Last 7 days, Last 30 days, etc.) or a custom date range.
|
||
|
||
**Interval**: controls how data is grouped in the time-series chart (hour, day, week, month).
|
||
|
||
**Event filter**: narrow the entire overview to sessions that include a specific event—useful for analyzing the behavior of users who completed a particular action.
|
||
|
||
**Dimension filters**: clicking any row in any widget (a country, a source, a page) applies that value as a filter. Active filters are shown as chips below the time controls. Remove a filter by clicking the × on its chip.
|
||
|
||
**Live counter**: a green badge in the top-right corner shows the number of active visitors (visitors who fired an event in the last 5 minutes). Click it for a 30-minute session histogram.
|