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

# Aktivitaetsprotokoll

> Durchsuchen und filtern Sie Roh-Tracking-Ereignisse — Klicks, Formulareinreichungen, Trigger und benutzerdefinierte Ereignisse mit vollstaendigen Datennutzlasten

## Ueberblick

Der Aktivitaetsprotokoll-Tab zeigt die letzten 500 auf Ihrer Website erfassten Tracking-Ereignisse. Verwenden Sie ihn, um Besucherinteraktionen zu ueberwachen, Ereignis-Tracking zu debuggen, Trigger-Aktivierungen zu ueberpruefen und erfasste Formulardaten zu inspizieren — alles in einem chronologischen Feed.

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

***

## Ereignistabelle

Jede Zeile im Aktivitaetsprotokoll repraesentiert ein einzelnes erfasstes Ereignis:

| Spalte       | Beschreibung                                                                                                                                                                                                        |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Zeit**     | Wann das Ereignis aufgetreten ist. Aktuelle Ereignisse zeigen relative Zeit (z.B. "vor 5 Min."), aeltere Ereignisse zeigen Datum und Uhrzeit. Fahren Sie mit der Maus darueber fuer den vollstaendigen Zeitstempel. |
| **Ereignis** | Ereignissymbol und Name. Der Name stammt aus der Ereignisdefinition (wenn verknuepft), dem Triggernamen (wenn triggerbezogen) oder dem rohen Ereignistyp.                                                           |
| **Seite**    | Die Seiten-URL, auf der das Ereignis ausgeloest wurde. Lange URLs werden auf 50 Zeichen gekuerzt — fahren Sie mit der Maus darueber fuer den vollstaendigen Pfad.                                                   |
| **Daten**    | Vorschau der Ereignisnutzlast — zeigt die ersten 3 Schluessel-Wert-Paare. Bei mehr erscheint ein "+N weitere"-Badge. Ereignisse ohne Daten zeigen "—".                                                              |
| **Sitzung**  | Sitzungs-ID, die das Ereignis mit einer bestimmten Besuchersitzung verknuepft.                                                                                                                                      |

Die Tabelle zeigt **15 Ereignisse pro Seite** mit Seitennummerierung am unteren Rand.

***

## Ereignistypen

Das Aktivitaetsprotokoll erfasst mehrere Kategorien von Ereignissen:

### Interaktionsereignisse

| Typ              | Symbol   | Beschreibung                                                                                              |
| ---------------- | -------- | --------------------------------------------------------------------------------------------------------- |
| **click**        | Zeiger   | Besucher hat auf ein Element geklickt, das einem in Ihren Ereignissen definierten CSS-Selektor entspricht |
| **scroll**       | Pfeile   | Besucher hat an einem verfolgten Element vorbeigescrollt (IntersectionObserver)                           |
| **form\_submit** | Dokument | Besucher hat ein Formular eingereicht, das einem CSS-Selektor entspricht                                  |
| **custom**       | Code     | Benutzerdefiniertes Ereignis, ausgeloest ueber `RevolTracker.track()` aus Ihrem JavaScript-Code           |

### Trigger-Ereignisse

| Typ                        | Symbol         | Beschreibung                                                                  |
| -------------------------- | -------------- | ----------------------------------------------------------------------------- |
| **trigger\_shown**         | Glocke         | Ein Trigger wurde dem Besucher angezeigt (Modal, Toast oder Weiterleitung)    |
| **trigger\_clicked**       | Cursor         | Besucher hat auf eine Schaltflaeche innerhalb eines Trigger-Overlays geklickt |
| **trigger\_dismissed**     | X              | Besucher hat ein Trigger-Overlay geschlossen oder verworfen                   |
| **trigger\_promo\_copied** | Zwischenablage | Besucher hat einen Aktionscode aus einem Trigger kopiert                      |

### Lebenszyklus-Ereignisse

| Typ            | Symbol | Beschreibung                                      |
| -------------- | ------ | ------------------------------------------------- |
| **visibility** | Auge   | Ein verfolgtes Element wurde im Viewport sichtbar |

<Note>
  Lebenszyklus-Ereignisse (trigger\_shown, trigger\_dismissed, visibility) sind **standardmaessig ausgeblendet**, um Rauschen zu reduzieren. Verwenden Sie den Lebenszyklus-Filter, um sie anzuzeigen.
</Note>

***

## Filter

Das Aktivitaetsprotokoll unterstuetzt ein flexibles Filtersystem. Klicken Sie auf die Schaltflaeche **+ Filter**, um Filter hinzuzufuegen. Aktive Filter erscheinen als entfernbare Chips ueber der Tabelle.

### Verfuegbare Filter

| Filter           | Typ          | Beschreibung                                                                                                                                                                                                   |
| ---------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Ereignistyp**  | Serverseitig | Nur Ereignisse eines bestimmten Typs anzeigen: click, scroll, form\_submit, visibility, custom oder trigger                                                                                                    |
| **Kampagne**     | Serverseitig | Nur Ereignisse aus Sitzungen anzeigen, die mit einer bestimmten Kampagne verknuepft sind. Das Dropdown wird dynamisch aus Ihren vorhandenen Kampagnen befuellt.                                                |
| **Hat Daten**    | Hybrid       | Nach Ereignisnutzlast filtern: **Beliebige Daten** (Ereignisse mit Nutzlast), **Keine Daten** (Ereignisse ohne Nutzlast) oder **Nur Formulardaten** (Ereignisse mit Formularfeldern wie E-Mail, Telefon, Name) |
| **Lebenszyklus** | Clientseitig | Sichtbarkeit von Lebenszyklus-Ereignissen umschalten (trigger\_shown, trigger\_dismissed, visibility). Standardmaessig ausgeblendet.                                                                           |
| **Suche**        | Clientseitig | Freitextsuche ueber Ereignistyp und Seiten-URL. Filtert in Echtzeit mit 200ms Verzoegerung.                                                                                                                    |

<Tip>
  **Serverseitige Filter** (Ereignistyp, Kampagne, Beliebige Daten) loesen ein vollstaendiges Neuladen der Daten vom Server aus. **Clientseitige Filter** (Lebenszyklus, Keine Daten, Formulardaten, Suche) filtern die bereits geladenen Daten sofort — keine Netzwerkanfrage erforderlich.
</Tip>

### Filterverhalten

* Bereits angewendete Filter sind im Dropdown deaktiviert, um Duplikate zu verhindern
* Jeder Filter-Chip zeigt den Filternamen und den ausgewaehlten Wert
* Klicken Sie auf das **x** eines Chips, um den Filter zu entfernen
* Filter koennen kombiniert werden — zum Beispiel nur `form_submit`-Ereignisse aus einer bestimmten Kampagne anzeigen, die Formulardaten haben

***

## Ereignisdetail-Panel

Klicken Sie auf eine beliebige Ereigniszeile mit Daten (die **Daten**-Spalte zeigt Schluessel-Wert-Paare statt "—"), um das Detailpanel unterhalb der Zeile zu erweitern. Das Panel zeigt die vollstaendige Ereignisnutzlast als **syntaxhervorgehobenen JSON-Block**.

### JSON-Codeblock

Das erweiterte Panel rendert das vollstaendige `event_data`-Objekt mit farbcodierter Syntax:

| Element                           | Farbe   | Beispiel              |
| --------------------------------- | ------- | --------------------- |
| **Schluessel**                    | Violett | `"fields"`, `"email"` |
| **Zeichenkettenwerte**            | Gruen   | `"john@example.com"`  |
| **Zahlen, Boolesche Werte, Null** | Orange  | `42`, `true`, `null`  |

### Was die Daten enthalten

Die JSON-Nutzlast variiert je nach Ereignistyp:

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

    Enthaelt den uebereinstimmenden CSS-Selektor, den Textinhalt des Elements und Klickkoordinaten.
  </Tab>

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

    Enthaelt erfasste Formularfeldwerte. Passwort- und versteckte Felder werden automatisch ausgeschlossen.
  </Tab>

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

    Enthaelt die Daten, die an `RevolTracker.track()` uebergeben wurden. Die Struktur haengt von Ihrer Implementierung ab.
  </Tab>

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

    Enthaelt den Aktionstyp des Triggers (modal, toast oder redirect).
  </Tab>
</Tabs>

### Kopieren-Schaltflaeche

Jeder JSON-Block hat eine **Kopieren**-Schaltflaeche in der unteren rechten Ecke. Klicken Sie darauf, um das formatierte JSON in Ihre Zwischenablage zu kopieren — nuetzlich zum Debuggen, Teilen mit Teammitgliedern oder Importieren von Daten in andere Tools.

***

## Anwendungsfaelle

<AccordionGroup>
  <Accordion title="Ereignis-Tracking debuggen">
    Oeffnen Sie nach dem Einrichten eines neuen Klick- oder Formularereignisses das Aktivitaetsprotokoll und interagieren Sie mit dem Element auf Ihrer Website. Das Ereignis sollte innerhalb von Sekunden im Protokoll erscheinen. Pruefen Sie die Daten-Spalte, um zu ueberpruefen, ob die korrekte Nutzlast erfasst wurde.
  </Accordion>

  <Accordion title="Trigger-Bedingungen ueberpruefen">
    Aktivieren Sie den **Lebenszyklus**-Filter, um `trigger_shown`-Ereignisse anzuzeigen. Navigieren Sie auf Ihrer Website mit verschiedenen Bedingungen (UTM-Parameter, Geraetetypen, Scrolltiefen), um zu bestaetigen, dass Trigger wie erwartet ausgeloest werden.
  </Accordion>

  <Accordion title="Formulareinreichungen ueberpruefen">
    Verwenden Sie den Filter **Hat Daten → Nur Formulardaten**, um alle Formulareinreichungen mit erfassten Feldwerten zu sehen. Erweitern Sie jede Zeile, um die vollstaendige Nutzlast zu inspizieren — ueberpruefen Sie, ob die richtigen Felder erfasst werden und keine sensiblen Daten durchsickern.
  </Accordion>

  <Accordion title="Kampagnenaktivitaet ueberwachen">
    Waehlen Sie eine bestimmte Kampagne aus dem **Kampagne**-Filter, um alle Ereignisse von Besuchern zu sehen, die ueber diese Kampagne kamen. Nuetzlich, um zu ueberpruefen, ob die Kampagnenzuordnung korrekt funktioniert.
  </Accordion>

  <Accordion title="Schneller Datenexport">
    Finden Sie das benoetigte Ereignis, erweitern Sie das Detailpanel und klicken Sie auf **Kopieren**, um die JSON-Nutzlast zu erfassen. Fuegen Sie sie in eine Tabelle, Slack-Nachricht oder ein Support-Ticket ein.
  </Accordion>
</AccordionGroup>

***

## Limits

* Das Aktivitaetsprotokoll laedt die **letzten 500 Ereignisse** vom Server. Aeltere Ereignisse sind ueber sitzungsbezogene Ereignisansichten verfuegbar.
* Die **Suche** durchsucht nur Ereignistyp und Seiten-URL — sie durchsucht nicht die Ereignisdaten-Nutzlasten.
* Ereignisse ohne `event_data` koennen nicht erweitert werden (die Zeile ist nicht klickbar).
* Seitennavigation klappt jedes geoeffnete Detailpanel zu.
