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

# Журнал активності

> Перегляд та фільтрація подій трекінгу — кліки, відправлення форм, тригери та кастомні події з повними даними

## Огляд

Вкладка Activity Log показує останні 500 подій трекінгу, зафіксованих на вашому сайті. Використовуйте для моніторингу взаємодій відвідувачів, налагодження відстеження подій, перевірки спрацювання тригерів та перегляду захоплених даних форм — все в одній хронологічній стрічці.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/fjI-3Zk750dSQkZZ/images/tracker-activity-log-light.png?fit=max&auto=format&n=fjI-3Zk750dSQkZZ&q=85&s=a2396acde0f03ac3d1f044fbe5c528b8" alt="Журнал активності" width="2869" height="1554" data-path="images/tracker-activity-log-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/fjI-3Zk750dSQkZZ/images/tracker-activity-log-dark.png?fit=max&auto=format&n=fjI-3Zk750dSQkZZ&q=85&s=3a52a59e17e9745792b779397891c113" alt="Журнал активності" width="2870" height="1554" data-path="images/tracker-activity-log-dark.png" />
</Frame>

***

## Таблиця подій

Кожен рядок у журналі активності представляє одну відстежену подію:

| Колонка     | Опис                                                                                                                                              |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Time**    | Коли відбулася подія. Нещодавні події показують відносний час (напр., «5m ago»), старіші — дату і час. Наведіть курсор для повної мітки часу.     |
| **Event**   | Іконка та назва події. Назва береться з визначення події (якщо прив'язано), назви тригера (якщо пов'язано з тригером) або сирого типу події.      |
| **Page**    | URL сторінки, де подія спрацювала. Довгі URL скорочуються до 50 символів — наведіть курсор для повного шляху.                                     |
| **Data**    | Попередній перегляд даних події — показує перші 3 пари ключ-значення. Якщо їх більше, з'являється бейдж «+N more». Події без даних показують «—». |
| **Session** | ID сесії, що прив'язує подію до конкретної сесії відвідувача.                                                                                     |

Таблиця відображає **15 подій на сторінку** з пагінацією внизу.

***

## Типи подій

Журнал активності фіксує кілька категорій подій:

### Події взаємодії

| Тип              | Іконка    | Опис                                                                            |
| ---------------- | --------- | ------------------------------------------------------------------------------- |
| **click**        | Вказівник | Відвідувач натиснув на елемент, що відповідає CSS-селектору з ваших подій       |
| **scroll**       | Стрілки   | Відвідувач прокрутив до відстежуваного елемента (IntersectionObserver)          |
| **form\_submit** | Документ  | Відвідувач відправив форму, що відповідає CSS-селектору                         |
| **custom**       | Код       | Кастомна подія, викликана через `RevolTracker.track()` з вашого JavaScript-коду |

### Події тригерів

| Тип                        | Іконка       | Опис                                                                        |
| -------------------------- | ------------ | --------------------------------------------------------------------------- |
| **trigger\_shown**         | Дзвіночок    | Тригер був показаний відвідувачу (модальне вікно, тост або перенаправлення) |
| **trigger\_clicked**       | Курсор       | Відвідувач натиснув кнопку всередині тригера                                |
| **trigger\_dismissed**     | X            | Відвідувач закрив або відхилив тригер                                       |
| **trigger\_promo\_copied** | Буфер обміну | Відвідувач скопіював промокод з тригера                                     |

### Життєвий цикл

| Тип            | Іконка | Опис                                          |
| -------------- | ------ | --------------------------------------------- |
| **visibility** | Око    | Відстежуваний елемент став видимим у вьюпорті |

<Note>
  Події життєвого циклу (trigger\_shown, trigger\_dismissed, visibility) **приховані за замовчуванням** для зменшення шуму. Використовуйте фільтр Lifecycle, щоб їх показати.
</Note>

***

## Фільтри

Журнал активності підтримує гнучку систему фільтрів. Натисніть кнопку **+ Filter**, щоб додати фільтри. Активні фільтри відображаються як чіпи з можливістю видалення над таблицею.

### Доступні фільтри

| Фільтр         | Тип         | Опис                                                                                                                                                      |
| -------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Event Type** | Серверний   | Показати лише події конкретного типу: click, scroll, form\_submit, visibility, custom або trigger                                                         |
| **Campaign**   | Серверний   | Показати події лише з сесій, прив'язаних до конкретної кампанії. Випадаючий список заповнюється динамічно з ваших існуючих кампаній.                      |
| **Has Data**   | Гібридний   | Фільтр за даними події: **Any data** (події з payload), **No data** (події без payload) або **Form data only** (події з полями форм — email, phone, name) |
| **Lifecycle**  | Клієнтський | Перемикач видимості подій життєвого циклу (trigger\_shown, trigger\_dismissed, visibility). Приховано за замовчуванням.                                   |
| **Search**     | Клієнтський | Вільний пошук по типу події та URL сторінки. Фільтрує в реальному часі з затримкою 200мс.                                                                 |

<Tip>
  **Серверні фільтри** (Event Type, Campaign, Any data) перезавантажують дані з сервера. **Клієнтські фільтри** (Lifecycle, No data, Form data, Search) фільтрують вже завантажені дані миттєво — без мережевого запиту.
</Tip>

### Поведінка фільтрів

* Вже застосовані фільтри вимкнені у випадаючому списку для запобігання дублювання
* Кожен чіп фільтра показує назву та обране значення
* Натисніть **×** на чіпі для видалення фільтра
* Фільтри можна комбінувати — наприклад, показати лише події `form_submit` з конкретної кампанії, що мають дані форм

***

## Панель деталей події

Натисніть на будь-який рядок події, що має дані (колонка **Data** показує пари ключ-значення замість «—»), щоб розгорнути панель деталей під рядком. Панель відображає повний payload події як **JSON-блок з підсвіткою синтаксису**.

### JSON-блок

Розгорнута панель рендерить повний об'єкт `event_data` з кольоровим синтаксисом:

| Елемент                  | Колір      | Приклад               |
| ------------------------ | ---------- | --------------------- |
| **Ключі**                | Фіолетовий | `"fields"`, `"email"` |
| **Рядкові значення**     | Зелений    | `"john@example.com"`  |
| **Числа, boolean, null** | Оранжевий  | `42`, `true`, `null`  |

### Що містять дані

JSON-payload відрізняється залежно від типу події:

<Tabs>
  <Tab title="Click">
    ```json theme={null}
    {
      "selector": "#cta-button",
      "text": "Get Started",
      "x": 452,
      "y": 320
    }
    ```

    Містить CSS-селектор, текст елемента та координати кліку.
  </Tab>

  <Tab title="Form Submit">
    ```json theme={null}
    {
      "fields": {
        "email": "visitor@example.com",
        "Phone": "0961234567",
        "name": "John"
      }
    }
    ```

    Містить захоплені значення полів форми. Поля пароля та приховані поля автоматично виключаються.
  </Tab>

  <Tab title="Custom Event">
    ```json theme={null}
    {
      "product_id": "SKU-12345",
      "product_name": "Running Shoes",
      "price": 89.99,
      "currency": "USD"
    }
    ```

    Містить дані, передані в `RevolTracker.track()`. Структура залежить від вашої реалізації.
  </Tab>

  <Tab title="Trigger">
    ```json theme={null}
    {
      "action_type": "modal"
    }
    ```

    Містить тип дії тригера (modal, toast або redirect).
  </Tab>
</Tabs>

### Кнопка Copy

Кожен JSON-блок має кнопку **Copy** в правому нижньому куті. Натисніть, щоб скопіювати відформатований JSON у буфер обміну — корисно для налагодження, обміну з колегами або імпорту даних в інші інструменти.

***

## Сценарії використання

<AccordionGroup>
  <Accordion title="Налагодження відстеження подій">
    Після налаштування нової події кліку або форми відкрийте Activity Log та взаємодійте з елементом на вашому сайті. Подія повинна з'явитися в журналі протягом кількох секунд. Перевірте колонку Data для підтвердження коректного payload.
  </Accordion>

  <Accordion title="Перевірка умов тригерів">
    Увімкніть фільтр **Lifecycle** для показу подій `trigger_shown`. Переміщуйтесь по сайту з різними умовами (UTM-параметри, типи пристроїв, глибина прокрутки), щоб підтвердити спрацювання тригерів.
  </Accordion>

  <Accordion title="Перегляд відправлень форм">
    Використовуйте фільтр **Has Data → Form data only**, щоб побачити всі відправлення форм із захопленими значеннями полів. Розгорніть кожен рядок для перевірки повного payload — переконайтесь, що правильні поля фіксуються і конфіденційні дані не потрапляють.
  </Accordion>

  <Accordion title="Моніторинг активності кампанії">
    Оберіть конкретну кампанію з фільтра **Campaign**, щоб побачити всі події від відвідувачів, які прийшли через цю кампанію. Корисно для перевірки правильності атрибуції кампаній.
  </Accordion>

  <Accordion title="Швидкий експорт даних">
    Знайдіть потрібну подію, розгорніть панель деталей та натисніть **Copy** для копіювання JSON-payload. Вставте у таблицю, повідомлення Slack або тікет підтримки для швидкого довідника.
  </Accordion>
</AccordionGroup>

***

## Обмеження

* Журнал активності завантажує **останні 500 подій** з сервера. Старіші події доступні через перегляд подій на рівні сесій.
* **Пошук** працює за типом події та URL сторінки — він не шукає всередині payload подій.
* Події без `event_data` не можна розгорнути (рядок не клікабельний).
* Перехід між сторінками згортає будь-яку відкриту панель деталей.
