> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Dashboard

> Real-time analytics dashboard with KPIs, traffic charts, geographic data, and campaign performance

## Overview

The Revol Tracker monitors visitor activity on your website. It collects session data, pageviews, custom events, and campaign attribution — all through the same script that powers the chat widget. No additional code needed.

The Dashboard provides a real-time overview of your website's traffic and visitor behavior. Data refreshes automatically every **60 seconds**.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/ABxHZb82eqCt60yU/images/tracker-analitiks-light.png?fit=max&auto=format&n=ABxHZb82eqCt60yU&q=85&s=b9021eed35ded4aac21c19194b7d9783" alt="Tracker analytics dashboard" width="2875" height="1556" data-path="images/tracker-analitiks-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/ABxHZb82eqCt60yU/images/tracker-analitiks-dark.png?fit=max&auto=format&n=ABxHZb82eqCt60yU&q=85&s=84b6d2d92218e3fb1ec0750cbf537218" alt="Tracker analytics dashboard" width="2858" height="1548" data-path="images/tracker-analitiks-dark.png" />
</Frame>

### Data Availability

Analytics data is stored in monthly partitions and cleaned up automatically based on your plan:

| Plan         | Data Retention |
| ------------ | -------------- |
| Free         | 3 months       |
| Premium      | 12 months      |
| Professional | 24 months      |

### Filters

Use filters to narrow down the dashboard data:

**Quick period selector:**

| Period  | Description           |
| ------- | --------------------- |
| **24h** | Last 24 hours         |
| **7d**  | Last 7 days (default) |
| **30d** | Last 30 days          |
| **90d** | Last 90 days          |

**Advanced filters** (dropdown):

| Filter        | Description                               |
| ------------- | ----------------------------------------- |
| **Device**    | Desktop, Mobile, or Tablet                |
| **Country**   | Filter by country (2-letter ISO code)     |
| **Source**    | UTM source (e.g., google, facebook)       |
| **Page URL**  | Filter by specific page                   |
| **Browser**   | Chrome, Firefox, Safari, etc.             |
| **OS**        | Windows, macOS, iOS, Android, etc.        |
| **Bounce**    | Show only bounced or non-bounced sessions |
| **Campaign**  | Select from your campaigns list           |
| **Medium**    | cpc, organic, social, email, referral     |
| **Date From** | Custom start date                         |
| **Date To**   | Custom end date                           |

<Tip>
  Without filters, the dashboard uses pre-aggregated data for fast loading. When filters are applied, it switches to raw queries for accurate results — this may take slightly longer.
</Tip>

***

## KPI Cards

The top row shows 6 key performance indicators. Each card displays the current value, a **trend percentage** compared to the previous period of equal length, and a **7-day sparkline** chart.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/LO2B_5CXGrVTXIMc/images/tracker-kpi-light.png?fit=max&auto=format&n=LO2B_5CXGrVTXIMc&q=85&s=02068d610da9a8d207db8b03f59782ff" alt="KPI cards" width="2706" height="342" data-path="images/tracker-kpi-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/LO2B_5CXGrVTXIMc/images/tracker-kpi-dark.png?fit=max&auto=format&n=LO2B_5CXGrVTXIMc&q=85&s=f05bf1bd97f66557fffbe802631cee49" alt="KPI cards" width="2711" height="356" data-path="images/tracker-kpi-dark.png" />
</Frame>

### Sessions

Total number of visitor sessions in the selected period. A session starts when a visitor loads your website and ends after 30 minutes of inactivity or when they leave.

**Calculation:** `COUNT(*)` from all sessions in the period.

### Unique Visitors

Number of distinct visitors, identified by a unique browser token. One person visiting your site 5 times = 1 unique visitor but 5 sessions.

**Calculation:** `COUNT(DISTINCT guest_token)` from sessions.

### Bounce Rate

Percentage of sessions where the visitor viewed only one page and left without further interaction. A lower bounce rate generally indicates better engagement.

**Calculation:** `(sessions with 1 pageview / total sessions) × 100%`

<Note>
  The trend arrow for bounce rate is **inverted** — a decrease (green arrow) means improvement, while an increase (red arrow) means more visitors are leaving after one page.
</Note>

### Avg Duration

Average time visitors spend on your website per session, displayed in seconds or minutes.

**Calculation:** `AVG(duration_seconds)` across all sessions.

### Pages / Visit

Average number of pages viewed per session. Higher values indicate visitors are exploring more of your content.

**Calculation:** `AVG(pages_visited)` across all sessions.

### Conversions

Number of unique sessions that triggered at least one event marked as a **Conversion Goal**. You define which events count as conversions in the Events tab.

**Calculation:** `COUNT(DISTINCT session_id)` where the session contains at least one event with `is_conversion = true`.

<Tip>
  To set up conversions, go to the **Events** tab, create or edit an event, and toggle the **"Conversion Goal"** switch. Any event type can be a conversion — form submissions, button clicks, page views, or custom events.
</Tip>

***

## Sessions Over Time

An area chart showing traffic trends over the selected period. Two overlaid lines:

* **Sessions** — total sessions per day
* **Visitors** — unique visitors per day

Use this to identify traffic spikes, trends, and the gap between total visits and unique visitors (repeat visit ratio).

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/LO2B_5CXGrVTXIMc/images/tracker-sessions-chart-light.png?fit=max&auto=format&n=LO2B_5CXGrVTXIMc&q=85&s=d4e93c568c97916465837530e8823e03" alt="Sessions over time chart" width="2676" height="894" data-path="images/tracker-sessions-chart-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/LO2B_5CXGrVTXIMc/images/tracker-sessions-chart-dark.png?fit=max&auto=format&n=LO2B_5CXGrVTXIMc&q=85&s=a06d232738ac2746d35c6f4f5f75751a" alt="Sessions over time chart" width="2700" height="913" data-path="images/tracker-sessions-chart-dark.png" />
</Frame>

## New vs Returning

A donut chart showing the split between:

* **New visitors** — first-time visitors (only 1 session ever)
* **Returning visitors** — visitors who have been to your site before (2+ sessions)

A healthy mix depends on your business: content sites aim for more returning visitors, while ad-driven landing pages expect mostly new visitors.

***

## Top Pages

A table of the 10 most visited pages, showing:

| Column         | Description                                                                |
| -------------- | -------------------------------------------------------------------------- |
| **Page URL**   | The page path                                                              |
| **Views**      | Total pageview count                                                       |
| **Avg Time**   | Average time spent on the page (milliseconds converted to readable format) |
| **Avg Scroll** | Average scroll depth percentage — how far down visitors scroll             |

Use this to identify your most popular content and pages where visitors engage the most (or the least).

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/rjFVqBPwM83rZSqL/images/tracker-top-pages-light.png?fit=max&auto=format&n=rjFVqBPwM83rZSqL&q=85&s=f51479e4e650386adb0c7b5d21c3179a" alt="Top pages table" width="2658" height="895" data-path="images/tracker-top-pages-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/rjFVqBPwM83rZSqL/images/tracker-top-pages-dark.png?fit=max&auto=format&n=rjFVqBPwM83rZSqL&q=85&s=31fc004bab10c1d4e335c3866a4ae124" alt="Top pages table" width="2684" height="906" data-path="images/tracker-top-pages-dark.png" />
</Frame>

## Traffic Sources

Top 15 traffic sources by visitor count, with source logos (Google, Facebook, TikTok, etc.) and metrics:

| Column          | Description                                           |
| --------------- | ----------------------------------------------------- |
| **Source**      | Where the visitor came from (utm\_source or referrer) |
| **Visitors**    | Unique visitor count from this source                 |
| **Bounce Rate** | Percentage of single-page sessions from this source   |

Sessions without a source are grouped as **"direct"** (typed URL or bookmark).

***

## Visitor Globe

An interactive 3D globe visualization showing where your visitors are located. Countries with more traffic appear as brighter hotspots.

## All Countries

A detailed list of countries with:

| Column              | Description                         |
| ------------------- | ----------------------------------- |
| **Country**         | Flag icon and country name          |
| **Sessions**        | Total sessions from this country    |
| **Unique Visitors** | Distinct visitors from this country |

The globe and country list use the visitor's IP-based geolocation data.

***

## Session Duration

A histogram showing how long visitors stay on your site, grouped into 6 buckets:

| Bucket       | Description                        |
| ------------ | ---------------------------------- |
| **0–10s**    | Very short visits (likely bounces) |
| **10–30s**   | Quick glances                      |
| **30–60s**   | Brief visits                       |
| **1–3 min**  | Moderate engagement                |
| **3–10 min** | Good engagement                    |
| **10+ min**  | Deep engagement                    |

## Scroll Depth

A histogram showing how far visitors scroll on your pages, in 4 buckets:

| Bucket      | Description                  |
| ----------- | ---------------------------- |
| **0–25%**   | Saw only the top of the page |
| **25–50%**  | Scrolled to the middle       |
| **50–75%**  | Read most of the page        |
| **75–100%** | Reached the bottom           |

Use this to understand if visitors are reading your full content or dropping off early.

## Hourly Traffic

A 24-hour bar chart showing session distribution by hour of day (0–23). Identifies peak traffic hours — useful for scheduling campaigns, support staffing, or content publishing.

***

## Top Events

A bar chart of the 6 most fired event definitions. Events are custom actions you define in the Events tab (clicks, form submissions, scroll triggers, etc.).

## Trigger Activity

A bar chart of the 6 most active triggers. Triggers are automated actions (popups, overlays, alerts) that fire based on visitor behavior rules you define in the Triggers tab.

***

## Campaign Performance

A table of the top 10 campaigns plus a **(Direct / Organic)** row for unattributed traffic:

| Column              | Description                                             |
| ------------------- | ------------------------------------------------------- |
| **Campaign**        | Campaign name (from UTM parameters or manually created) |
| **Sessions**        | Total sessions attributed to this campaign              |
| **Events**          | Number of tracked events fired in campaign sessions     |
| **Triggers**        | Number of trigger activations in campaign sessions      |
| **Phone Swaps**     | Phone number substitution events                        |
| **Bounce Rate**     | % of single-page sessions                               |
| **Avg Duration**    | Average session duration in seconds                     |
| **Conversations**   | Number of chat conversations started                    |
| **Conversion Rate** | % of sessions with at least one conversion event        |