> ## 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

> Аналітичний дашборд у реальному часі з KPI, графіками трафіку, географією та ефективністю кампаній

## Огляд

Revol Tracker відстежує активність відвідувачів на вашому сайті. Він збирає дані сесій, перегляди сторінок, кастомні події та атрибуцію кампаній — все через той самий скрипт, що забезпечує роботу чат-віджета. Додатковий код не потрібен.

Dashboard надає огляд трафіку та поведінки відвідувачів вашого сайту в реальному часі. Дані оновлюються автоматично кожні **60 секунд**.

<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>

### Доступність даних

Аналітичні дані зберігаються у місячних партиціях та автоматично очищуються відповідно до вашого тарифу:

| Тариф        | Зберігання даних |
| ------------ | ---------------- |
| Free         | 3 місяці         |
| Premium      | 12 місяців       |
| Professional | 24 місяці        |

### Фільтри

Використовуйте фільтри для звуження даних дашборду:

**Швидкий вибір періоду:**

| Період  | Опис                              |
| ------- | --------------------------------- |
| **24h** | Останні 24 години                 |
| **7d**  | Останні 7 днів (за замовчуванням) |
| **30d** | Останні 30 днів                   |
| **90d** | Останні 90 днів                   |

**Розширені фільтри** (dropdown):

| Фільтр        | Опис                                         |
| ------------- | -------------------------------------------- |
| **Device**    | Desktop, Mobile або Tablet                   |
| **Country**   | Фільтр за країною (2-літерний ISO код)       |
| **Source**    | UTM source (напр., google, facebook)         |
| **Page URL**  | Фільтр за конкретною сторінкою               |
| **Browser**   | Chrome, Firefox, Safari тощо                 |
| **OS**        | Windows, macOS, iOS, Android тощо            |
| **Bounce**    | Показати лише відмовні або не відмовні сесії |
| **Campaign**  | Вибір зі списку ваших кампаній               |
| **Medium**    | cpc, organic, social, email, referral        |
| **Date From** | Кастомна початкова дата                      |
| **Date To**   | Кастомна кінцева дата                        |

<Tip>
  Без фільтрів дашборд використовує попередньо агреговані дані для швидкого завантаження. При застосуванні фільтрів переключається на прямі запити для точних результатів — це може зайняти трохи більше часу.
</Tip>

***

## KPI-картки

Верхній рядок показує 6 ключових показників ефективності. Кожна картка відображає поточне значення, **тренд у відсотках** порівняно з попереднім періодом рівної довжини та **7-денний спарклайн** графік.

<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-картки" 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-картки" width="2711" height="356" data-path="images/tracker-kpi-dark.png" />
</Frame>

### Sessions (Сесії)

Загальна кількість сесій відвідувачів за обраний період. Сесія починається, коли відвідувач завантажує ваш сайт, і завершується після 30 хвилин неактивності або при виході.

**Розрахунок:** `COUNT(*)` з усіх сесій за період.

### Unique Visitors (Унікальні відвідувачі)

Кількість окремих відвідувачів, ідентифікованих за унікальним токеном браузера. Одна людина, що відвідала ваш сайт 5 разів = 1 унікальний відвідувач, але 5 сесій.

**Розрахунок:** `COUNT(DISTINCT guest_token)` з сесій.

### Bounce Rate (Показник відмов)

Відсоток сесій, де відвідувач переглянув лише одну сторінку та покинув сайт без подальшої взаємодії. Нижчий показник відмов зазвичай означає кращу залученість.

**Розрахунок:** `(сесії з 1 переглядом / всі сесії) × 100%`

<Note>
  Стрілка тренду для показника відмов **інвертована** — зменшення (зелена стрілка) означає покращення, а збільшення (червона стрілка) означає, що більше відвідувачів йдуть після однієї сторінки.
</Note>

### Avg Duration (Середня тривалість)

Середній час, який відвідувачі проводять на вашому сайті за сесію, у секундах або хвилинах.

**Розрахунок:** `AVG(duration_seconds)` по всіх сесіях.

### Pages / Visit (Сторінок за візит)

Середня кількість переглянутих сторінок за сесію. Вищі значення вказують, що відвідувачі вивчають більше вашого контенту.

**Розрахунок:** `AVG(pages_visited)` по всіх сесіях.

### Conversions (Конверсії)

Кількість унікальних сесій, які запустили принаймні одну подію, позначену як **Conversion Goal**. Ви самі визначаєте, які події вважаються конверсіями, у вкладці Events.

**Розрахунок:** `COUNT(DISTINCT session_id)` де сесія містить принаймні одну подію з `is_conversion = true`.

<Tip>
  Щоб налаштувати конверсії, перейдіть у вкладку **Events**, створіть або відредагуйте подію та увімкніть перемикач **"Conversion Goal"**. Будь-який тип події може бути конверсією — відправлення форм, кліки на кнопки, перегляди сторінок або кастомні події.
</Tip>

***

## Sessions Over Time (Сесії за часом)

Графік-область, що показує тренди трафіку за обраний період. Дві накладені лінії:

* **Sessions** — загальна кількість сесій за день
* **Visitors** — унікальні відвідувачі за день

Використовуйте для виявлення піків трафіку, трендів та розриву між загальними візитами та унікальними відвідувачами (коефіцієнт повторних візитів).

<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="Графік сесій за часом" 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="Графік сесій за часом" width="2700" height="913" data-path="images/tracker-sessions-chart-dark.png" />
</Frame>

## New vs Returning (Нові vs Повторні)

Кільцева діаграма, що показує розподіл між:

* **New visitors** — відвідувачі вперше (лише 1 сесія за весь час)
* **Returning visitors** — відвідувачі, які вже були на вашому сайті (2+ сесій)

Здоровий баланс залежить від бізнесу: контентні сайти прагнуть більше повторних відвідувачів, тоді як рекламні лендинги очікують переважно нових.

***

## Top Pages (Топ сторінок)

Таблиця 10 найбільш відвідуваних сторінок:

| Колонка        | Опис                                                                      |
| -------------- | ------------------------------------------------------------------------- |
| **Page URL**   | Шлях сторінки                                                             |
| **Views**      | Загальна кількість переглядів                                             |
| **Avg Time**   | Середній час на сторінці                                                  |
| **Avg Scroll** | Середня глибина прокрутки — наскільки далеко вниз прокручують відвідувачі |

Використовуйте для визначення найпопулярнішого контенту та сторінок з найвищою (або найнижчою) залученістю.

<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="Таблиця топ сторінок" 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="Таблиця топ сторінок" width="2684" height="906" data-path="images/tracker-top-pages-dark.png" />
</Frame>

## Traffic Sources (Джерела трафіку)

Топ-15 джерел трафіку за кількістю відвідувачів, з логотипами джерел (Google, Facebook, TikTok тощо):

| Колонка         | Опис                                                 |
| --------------- | ---------------------------------------------------- |
| **Source**      | Звідки прийшов відвідувач (utm\_source або referrer) |
| **Visitors**    | Кількість унікальних відвідувачів з цього джерела    |
| **Bounce Rate** | Відсоток односторінкових сесій з цього джерела       |

Сесії без джерела групуються як **"direct"** (пряме введення URL або закладка).

***

## Visitor Globe (Глобус відвідувачів)

Інтерактивна 3D-візуалізація глобуса, що показує, звідки ваші відвідувачі. Країни з більшим трафіком відображаються як яскравіші точки.

## All Countries (Всі країни)

Детальний список країн з:

| Колонка             | Опис                                   |
| ------------------- | -------------------------------------- |
| **Country**         | Іконка прапора та назва країни         |
| **Sessions**        | Загальна кількість сесій з цієї країни |
| **Unique Visitors** | Унікальні відвідувачі з цієї країни    |

Глобус і список країн використовують геолокацію за IP-адресою відвідувача.

***

## Session Duration (Тривалість сесій)

Гістограма, що показує, скільки часу відвідувачі проводять на вашому сайті, згрупована у 6 бакетів:

| Бакет       | Опис                                   |
| ----------- | -------------------------------------- |
| **0–10с**   | Дуже короткі візити (ймовірно відмови) |
| **10–30с**  | Швидкі перегляди                       |
| **30–60с**  | Короткі візити                         |
| **1–3 хв**  | Помірна залученість                    |
| **3–10 хв** | Хороша залученість                     |
| **10+ хв**  | Глибока залученість                    |

## Scroll Depth (Глибина прокрутки)

Гістограма, що показує, наскільки далеко відвідувачі прокручують ваші сторінки, у 4 бакетах:

| Бакет       | Опис                        |
| ----------- | --------------------------- |
| **0–25%**   | Побачили лише верх сторінки |
| **25–50%**  | Прокрутили до середини      |
| **50–75%**  | Прочитали більшу частину    |
| **75–100%** | Дійшли до низу              |

Використовуйте, щоб зрозуміти, чи читають відвідувачі ваш контент повністю, чи залишають сторінку рано.

## Hourly Traffic (Погодинний трафік)

Стовпчикова діаграма з 24 годинами, що показує розподіл сесій за годинами доби (0–23). Визначає пікові години трафіку — корисно для планування кампаній, графіку підтримки або публікації контенту.

***

## Top Events (Топ подій)

Стовпчикова діаграма 6 найчастіших визначень подій. Події — це кастомні дії, які ви визначаєте у вкладці Events (кліки, відправлення форм, тригери прокрутки тощо).

## Trigger Activity (Активність тригерів)

Стовпчикова діаграма 6 найактивніших тригерів. Тригери — це автоматичні дії (попапи, оверлеї, сповіщення), що спрацьовують на основі правил поведінки відвідувачів, визначених у вкладці Triggers.

***

## Campaign Performance (Ефективність кампаній)

Таблиця топ-10 кампаній плюс рядок **(Direct / Organic)** для неатрибутованого трафіку:

| Колонка             | Опис                                                  |
| ------------------- | ----------------------------------------------------- |
| **Campaign**        | Назва кампанії (з UTM-параметрів або створена вручну) |
| **Sessions**        | Загальна кількість сесій, атрибутованих кампанії      |
| **Events**          | Кількість відстежених подій у сесіях кампанії         |
| **Triggers**        | Кількість активацій тригерів у сесіях кампанії        |
| **Phone Swaps**     | Події підміни номерів телефону                        |
| **Bounce Rate**     | % односторінкових сесій                               |
| **Avg Duration**    | Середня тривалість сесії в секундах                   |
| **Conversations**   | Кількість розпочатих чат-розмов                       |
| **Conversion Rate** | % сесій з принаймні однією подією-конверсією          |