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

# Dziennik aktywności

> Przeglądaj i filtruj surowe zdarzenia śledzenia — kliknięcia, wysyłki formularzy, wyzwalacze i zdarzenia niestandardowe z pełnymi ładunkami danych

## Przegląd

Zakładka Dziennik aktywności pokazuje 500 najnowszych zdarzeń śledzenia zarejestrowanych na Twojej stronie. Użyj go do monitorowania interakcji odwiedzających, debugowania śledzenia zdarzeń, weryfikacji aktywacji wyzwalaczy i inspekcji przechwyconych danych formularzy — wszystko w jednym chronologicznym strumieniu.

<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="Dziennik aktywności" 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="Dziennik aktywności" width="2870" height="1554" data-path="images/tracker-activity-log-dark.png" />
</Frame>

***

## Tabela zdarzeń

Każdy wiersz w dzienniku aktywności reprezentuje pojedyncze śledzone zdarzenie:

| Kolumna       | Opis                                                                                                                                                                        |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Czas**      | Kiedy zdarzenie wystąpiło. Najnowsze zdarzenia pokazują czas względny (np. "5m temu"), starsze pokazują datę i godzinę. Najedź kursorem, aby zobaczyć pełny znacznik czasu. |
| **Zdarzenie** | Ikona i nazwa zdarzenia. Nazwa pochodzi z definicji zdarzenia (jeśli powiązane), nazwy wyzwalacza (jeśli związane z wyzwalaczem) lub surowego typu zdarzenia.               |
| **Strona**    | URL strony, na której zdarzenie zostało wywołane. Długie URL-e są obcinane do 50 znaków — najedź kursorem, aby zobaczyć pełną ścieżkę.                                      |
| **Dane**      | Podgląd ładunku zdarzenia — pokazuje pierwsze 3 pary klucz-wartość. Jeśli jest więcej, pojawia się plakietka "+N więcej". Zdarzenia bez danych pokazują "—".                |
| **Sesja**     | Identyfikator sesji łączący zdarzenie z konkretną sesją odwiedzającego.                                                                                                     |

Tabela wyświetla **15 zdarzeń na stronę** z paginacją na dole.

***

## Typy zdarzeń

Dziennik aktywności rejestruje kilka kategorii zdarzeń:

### Zdarzenia interakcji

| Typ              | Ikona    | Opis                                                                                     |
| ---------------- | -------- | ---------------------------------------------------------------------------------------- |
| **click**        | Wskaźnik | Odwiedzający kliknął element pasujący do selektora CSS zdefiniowanego w zdarzeniach      |
| **scroll**       | Strzałki | Odwiedzający przewinął obok śledzonego elementu (IntersectionObserver)                   |
| **form\_submit** | Dokument | Odwiedzający wysłał formularz pasujący do selektora CSS                                  |
| **custom**       | Kod      | Zdarzenie niestandardowe wywołane przez `RevolTracker.track()` z Twojego kodu JavaScript |

### Zdarzenia wyzwalaczy

| Typ                        | Ikona   | Opis                                                                          |
| -------------------------- | ------- | ----------------------------------------------------------------------------- |
| **trigger\_shown**         | Dzwonek | Wyzwalacz został wyświetlony odwiedzającemu (modal, toast lub przekierowanie) |
| **trigger\_clicked**       | Kursor  | Odwiedzający kliknął przycisk wewnątrz nakładki wyzwalacza                    |
| **trigger\_dismissed**     | X       | Odwiedzający zamknął lub odrzucił nakładkę wyzwalacza                         |
| **trigger\_promo\_copied** | Schowek | Odwiedzający skopiował kod promocyjny z wyzwalacza                            |

### Zdarzenia cyklu życia

| Typ            | Ikona | Opis                                              |
| -------------- | ----- | ------------------------------------------------- |
| **visibility** | Oko   | Śledzony element stał się widoczny w oknie widoku |

<Note>
  Zdarzenia cyklu życia (trigger\_shown, trigger\_dismissed, visibility) są **domyślnie ukryte** aby ograniczyć szum. Użyj filtra Cykl życia, aby je wyświetlić.
</Note>

***

## Filtry

Dziennik aktywności obsługuje elastyczny system filtrów. Kliknij przycisk **+ Filtr**, aby dodać filtry. Aktywne filtry pojawiają się jako usuwalne chipy nad tabelą.

### Dostępne filtry

| Filtr             | Typ       | Opis                                                                                                                                                                                                               |
| ----------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Typ zdarzenia** | Serwerowy | Pokaż tylko zdarzenia określonego typu: click, scroll, form\_submit, visibility, custom lub trigger                                                                                                                |
| **Kampania**      | Serwerowy | Pokaż zdarzenia tylko z sesji powiązanych z konkretną kampanią. Lista rozwijana jest wypełniana dynamicznie z istniejących kampanii.                                                                               |
| **Zawiera dane**  | Hybrydowy | Filtruj według ładunku zdarzenia: **Dowolne dane** (zdarzenia z ładunkiem), **Bez danych** (zdarzenia bez ładunku) lub **Tylko dane formularza** (zdarzenia zawierające pola formularza jak e-mail, telefon, imię) |
| **Cykl życia**    | Kliencki  | Przełącz widoczność zdarzeń cyklu życia (trigger\_shown, trigger\_dismissed, visibility). Domyślnie ukryte.                                                                                                        |
| **Wyszukiwanie**  | Kliencki  | Wyszukiwanie pełnotekstowe po typie zdarzenia i URL strony. Filtruje w czasie rzeczywistym z 200ms debounce.                                                                                                       |

<Tip>
  **Filtry serwerowe** (Typ zdarzenia, Kampania, Dowolne dane) powodują pełne przeładowanie danych z serwera. **Filtry klienckie** (Cykl życia, Bez danych, Dane formularza, Wyszukiwanie) filtrują już załadowane dane natychmiast — bez potrzeby żądania sieciowego.
</Tip>

### Zachowanie filtrów

* Już zastosowane filtry są wyłączone w rozwijanej liście, aby zapobiec duplikatom
* Każdy chip filtra pokazuje nazwę filtra i wybraną wartość
* Kliknij **×** na chipie, aby usunąć filtr
* Filtry mogą być łączone — na przykład pokaż tylko zdarzenia `form_submit` z konkretnej kampanii, które mają dane formularza

***

## Panel szczegółów zdarzenia

Kliknij dowolny wiersz zdarzenia, który ma dane (kolumna **Dane** pokazuje pary klucz-wartość zamiast "—"), aby rozwinąć panel szczegółów pod wierszem. Panel wyświetla pełny ładunek zdarzenia jako **blok JSON z podświetleniem składni**.

### Blok kodu JSON

Rozwinięty panel renderuje kompletny obiekt `event_data` z kolorowaniem składni:

| Element                   | Kolor        | Przykład              |
| ------------------------- | ------------ | --------------------- |
| **Klucze**                | Fioletowy    | `"fields"`, `"email"` |
| **Wartości tekstowe**     | Zielony      | `"john@example.com"`  |
| **Liczby, boolean, null** | Pomarańczowy | `42`, `true`, `null`  |

### Co zawierają dane

Ładunek JSON różni się w zależności od typu zdarzenia:

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

    Zawiera selektor CSS, który pasował, treść tekstową elementu i współrzędne kliknięcia.
  </Tab>

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

    Zawiera przechwycone wartości pól formularza. Pola hasła i ukryte są automatycznie wykluczane.
  </Tab>

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

    Zawiera dane przekazane do `RevolTracker.track()`. Struktura zależy od Twojej implementacji.
  </Tab>

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

    Zawiera typ akcji wyzwalacza (modal, toast lub redirect).
  </Tab>
</Tabs>

### Przycisk kopiowania

Każdy blok JSON ma przycisk **Kopiuj** w prawym dolnym rogu. Kliknij go, aby skopiować sformatowany JSON do schowka — przydatne do debugowania, udostępniania współpracownikom lub importowania danych do innych narzędzi.

***

## Przypadki użycia

<AccordionGroup>
  <Accordion title="Debugowanie śledzenia zdarzeń">
    Po skonfigurowaniu nowego zdarzenia kliknięcia lub formularza otwórz Dziennik aktywności i wejdź w interakcję z elementem na swojej stronie. Zdarzenie powinno pojawić się w dzienniku w ciągu kilku sekund. Sprawdź kolumnę Dane, aby zweryfikować czy przechwycony ładunek jest poprawny.
  </Accordion>

  <Accordion title="Weryfikacja warunków wyzwalaczy">
    Włącz filtr **Cykl życia**, aby wyświetlić zdarzenia `trigger_shown`. Nawiguj po stronie z różnymi warunkami (parametry UTM, typy urządzeń, głębokości przewijania), aby potwierdzić, że wyzwalacze uruchamiają się zgodnie z oczekiwaniami.
  </Accordion>

  <Accordion title="Przegląd wysyłek formularzy">
    Użyj filtra **Zawiera dane → Tylko dane formularza**, aby zobaczyć wszystkie wysyłki formularzy z przechwyconym wartościami pól. Rozwiń każdy wiersz, aby sprawdzić pełny ładunek — zweryfikuj, że odpowiednie pola są przechwytywane i żadne wrażliwe dane nie wyciekają.
  </Accordion>

  <Accordion title="Monitorowanie aktywności kampanii">
    Wybierz konkretną kampanię z filtra **Kampania**, aby zobaczyć wszystkie zdarzenia od odwiedzających, którzy przybyli z tej kampanii. Przydatne do weryfikacji, czy atrybucja kampanii działa prawidłowo.
  </Accordion>

  <Accordion title="Szybki eksport danych">
    Znajdź potrzebne zdarzenie, rozwiń panel szczegółów i kliknij **Kopiuj**, aby pobrać ładunek JSON. Wklej go do arkusza kalkulacyjnego, wiadomości Slack lub zgłoszenia w celu szybkiego odniesienia.
  </Accordion>
</AccordionGroup>

***

## Limity

* Dziennik aktywności ładuje **ostatnich 500 zdarzeń** z serwera. Starsze zdarzenia są dostępne przez widoki zdarzeń na poziomie sesji.
* **Wyszukiwanie** dopasowuje tylko typ zdarzenia i URL strony — nie przeszukuje ładunków danych zdarzeń.
* Zdarzenia bez `event_data` nie mogą być rozwinięte (wiersz nie jest klikalny).
* Nawigacja po stronie zwija każdy otwarty panel szczegółów.
