Gesamte Doku

Start

  1. 01Erste Schritte
  2. 02Installation
  3. 03Tracking

Funktionen

  1. 04Das Dashboard
  2. 05Ziele
  3. 06Kurzlinks
  4. 07KI-Quellen und Agenten
  5. 08E-Mail-Berichte
  6. 09Stündlicher Check
  7. 10Frag deine KI

Referenz

  1. 11Konfiguration
  2. 12HTTP-API

Plattformen

  1. 13Eigenständiger Server
  2. 14PHP
  3. 15WordPress
  4. 16Drupal
  5. 17Craft CMS
  6. 18Python
  7. 19Rails
  8. 20Ruby
  9. 21Go
  10. 22Java
  11. 23.NET
  12. 24Elixir
  13. 25Rust

Vertrauen

  1. 26Datenschutz

Funktionen

Das Dashboard

Diese Seite erklärt, was jede Zahl bedeutet und wie du filterst, vergleichst, teilst und live zusiehst.

Das Dashboard liegt unter /runlight auf deiner eigenen Website. Seine einzige Seite beginnt mit einem Satz als Überschrift und sechs Kennzahlkarten über einem Diagramm, darunter folgt eine Fläche mit Boxen.

Die sechs Zahlen

Kennzahl Was sie zählt
Besucher Verschiedene Personen, jede einmal pro Tag gezählt (siehe Datenschutz dazu, wie Personen unterschieden werden, ohne sie zu identifizieren).
Besuche Sitzungen, die jeweils nach 30 Minuten ohne Aktivität enden.
Seitenaufrufe Geladene Seiten, einschließlich Seitenwechseln in Single-Page-Apps.
Seiten pro Besuch Seitenaufrufe geteilt durch Besuche.
Absprungrate Besuche mit einem Seitenaufruf, ohne Ereignis und mit weniger als 10 Sekunden aktiver Zeit, als Anteil an allen Besuchen.
Besuchsdauer Die durchschnittliche aktive Zeit pro Besuch, wobei nur Zeit zählt, in der der Tab sichtbar und im Fokus war.

Klick auf eine Karte, um sie ins Diagramm zu holen. Mehrere können es sich teilen, jede auf ihren eigenen Höchstwert skaliert, damit sich ihre Verläufe vergleichen lassen. Fahr über das Diagramm, um die genauen Zahlen zu sehen.

Die Boxen

  • Seiten zeigt die Top-Seiten mit der Verweildauer, Einstiegsseiten mit der Absprungrate und Ausstiegsseiten. Die Verweildauer ist der Durchschnitt über alle Aufrufe der Seite, und ein Aufruf unter einer Sekunde zählt als keiner.
  • Quellen schlüsselt den Traffic nach Kanal (Organische Suche, Soziale Medien, Direkt, KI, E-Mail, Verweise, Kampagne, Bezahlte Suche), benannter Quelle und verweisendem Host auf.
  • Orte zeigt Länder, Regionen und Städte, als Liste oder Karte.
  • Wann Leute kommen zeigt Besuche nach Wochentag und Stunde, in der Zeitzone der Website.
  • KI-Agenten listet die KI-Agenten auf, die deine Seiten abgerufen haben, und welche Seiten sie abgerufen haben. Siehe KI-Quellen und Agenten.
  • Geräte schlüsselt Besuche nach Gerätetyp, Browser, Betriebssystem, Bildschirmgröße und Sprache auf.
  • Ereignisse zeigt deine eigenen Ereignisse und die automatischen. Der Listen-Button in jeder Zeile öffnet ihre Eigenschaften, etwa die Adresse jedes ausgehenden Links und Downloads oder den Pfad jedes 404-Fehlers, jeweils damit, wie oft er vorkam.
  • Kampagnen zeigt deine UTM-Tags nach Quelle, Medium, Kampagne, Begriff und Inhalt.
  • Conversions zeigt deine Ziele.
  • Links zeigt deine Kurzlinks.

Alle anzeigen öffnet die vollständige Liste mit jeder Spalte und einem Suchfeld.

Filter

Klick auf eine beliebige Zeile, um das ganze Dashboard danach zu filtern. Der Button Filter kann nach Seite, Einstiegs- oder Ausstiegsseite, Quelle, Kanal, Verweis, jedem UTM-Tag, Land, Region, Stadt, Browser, Betriebssystem, Gerät, Bildschirm, Sprache, Hostname und Ereignis filtern. Jeder Filter nutzt ist, ist nicht oder enthält, und Filter lassen sich kombinieren.

Ein Filter wählt Besuche aus, und die Zahlen beschreiben dann diese ganzen Besuche, gezählt in dem Zeitraum, in dem jeder begonnen hat. Ein Filter auf das Ereignis Signup zeigt die Leute, die sich angemeldet haben, mit all ihren Seiten, ihrer Zeit und ihrer Absprungrate, und ist nicht wählt die Besuche, in denen es nie vorkam. Ein Seitenfilter zählt die Aufrufe dieser Seite als Seitenaufrufe, „Seite ist /pricing“ zeigt also, wie oft /pricing gesehen wurde. Mit zwei Seitenfiltern zählen die Aufrufe beider Seiten, und ein Hostname-Filter daneben behält nur die Aufrufe auf diesem Host. Conversions, Trichter und Eigenschaften von Ereignissen zählen dieselben Besuche, ein Besuch, der vor Mitternacht beginnt und danach konvertiert, zählt also an dem Tag, an dem er begann. Enthält ignoriert Groß- und Kleinschreibung, und bis zu sechs Filter gelten gleichzeitig.

Zeiträume und Vergleich

Wähle einen Zeitraum im Kalender oder eine Vorgabe (Letzte 30 Tage ist der Standard). Vergleiche ihn mit dem vorherigen Zeitraum, denselben Tagen im Vorjahr oder beliebigen Daten, die du wählst. Die Karten zeigen die Veränderung, und das Diagramm zeichnet den Vergleich gestrichelt. Vor Gesamter Zeitraum liegt nichts, deshalb schaltet er den Vergleich aus.

Zurücksetzen stellt alles auf Letzte 30 Tage ohne Filter oder Vergleich zurück, und der Zurück-Button des Browsers macht das rückgängig. Jede Ansicht steckt in der URL, du kannst sie also als Lesezeichen speichern oder verschicken.

Gerade jetzt

Klick unter dem Namen der Website auf gerade hier, um zu sehen, was gerade auf der Website passiert. Die Ansicht zeigt die Seitenaufrufe für jede der letzten 30 Minuten und einen Verlauf dessen, was darin passiert ist, etwa „Jemand in Toronto, Kanada hat /pricing angesehen, über Google“. Die Zahl der Personen und die Seiten, Quellen und Länder daneben decken die letzten fünf Minuten ab. Die Ansicht aktualisiert sich alle 10 Sekunden und zeigt nie, wer jemand ist.

Teilen

Unter Einstellungen, Teilen erstellst du einen schreibgeschützten Link zum Dashboard einer Website, für einen Kunden oder dein Team. Alle, die den Link haben, sehen die Berichte und Conversions, und der Link verbirgt deine Kurzlinks, Einstellungen und die Adresse der Website. Lösch den Link, und er funktioniert sofort nicht mehr. Ein geteiltes Dashboard nutzt dieselbe Seite, ausgeliefert unter /runlight/share/<id> (oder /share/<id> auf dem eigenständigen Server), und die ID besteht aus 128 zufälligen Bits.

Exportieren

Exportieren in der Fußzeile lädt alles, was das Dashboard für die aktuellen Daten und Filter zeigt, als ZIP mit CSV-Dateien herunter. Es enthält die sechs Zahlen, die Zahlen für jeden Tag, jede Aufschlüsselung bis 1.000 Zeilen und deine Ziele. Datumsangaben sind die der Website, Raten sind Prozentwerte und Zeiten stehen in Sekunden, sodass eine Tabellenkalkulation sie so liest, wie sie sind. Jede vollständige Liste hat außerdem CSV herunterladen für genau diese eine Tabelle. Ein Freigabelink kann seine eigene Website exportieren, und dieselben Dateien kommen auch aus der API unter /api/export und aus /api/breakdown mit format=csv.

Verlauf aus Umami übernehmen

Melde dich unter Einstellungen, Import, Besuche mit einem API-Schlüssel bei deinem Umami an (oder mit Benutzername und Passwort bei einem selbst gehosteten Standard-Umami) und wähle die Umami-Website, die zu dieser Website passt. Runlight liest ihre Seitenaufrufe und eigenen Ereignisse jeweils ein paar Tage auf einmal, die ältesten zuerst, und schreibt sie als Besuche mit ihren Quellen, Kampagnen, Orten und Geräten. Eine Lücke von dreißig Minuten beginnt einen neuen Besuch, genau wie bei Live-Besuchen.

Der Import hört dort auf, wo Runlights eigene Besuche beginnen, kein Tag wird also doppelt gezählt. Wenn du ihn stoppst oder die Seite schließt, macht ein erneuter Start beim zuletzt abgeschlossenen Tag weiter. Umami zeichnet keine aktive Zeit auf, deshalb reicht die Länge eines importierten Besuchs von seinem ersten bis zu seinem letzten Seitenaufruf. Dein Schlüssel oder Passwort wird nur während des Imports genutzt und nie gespeichert.

Verlauf aus einer CSV-Datei übernehmen

Wähle unter Einstellungen, Import, Besuche bei Importieren aus die Option Einer CSV-Datei und dann die Datei. Runlight nimmt zwei Arten von Dateien an und unterscheidet sie an ihrer Kopfzeile. Die erste ist die CSV aus dem Datenexport von Umami, mit einer Zeile pro Seitenaufruf oder Ereignis, passend für ein Umami, das du nicht mehr erreichen kannst. Die zweite ist Runlights eigenes Besuchsformat, für Verlauf von überall sonst, solange es eine Zeile pro Seitenaufruf gibt. Ein Skript oder ein KI-Assistent kann die meisten rohen Logs in dieses Format umwandeln.

Spalte Was sie enthält
time Wann es passiert ist, als ISO 8601 (2024-05-01T12:34:56Z), als 2024-05-01 12:34:56 in UTC oder als Unix-Zeit in Sekunden oder Millisekunden. Pflicht.
url oder path Die volle Adresse oder der Pfad mit seinem Query-String. Pflicht.
hostname Der Host, wenn path genutzt wird. Standard ist die erste Domain der Website.
visitor Eine beliebige ID, die für eine Person gleich bleibt, etwa eine Session-ID. Zeilen mit demselben Besucher, die weniger als dreißig Minuten auseinanderliegen, ergeben einen Besuch. Ohne sie ist jede Zeile ein eigener Besuch.
event Der Name eines eigenen Ereignisses. Eine Zeile mit Namen ist ein Ereignis auf dieser Seite, eine Zeile ohne ist ein Seitenaufruf.
referrer Woher der Besuch kam, als Adresse oder Domain.
title Der Titel der Seite.
country, region, city Ein Ländercode aus zwei Buchstaben, ein Regionscode wie CA-ON und ein Städtename.
browser, os, device Namen wie Chrome, macOS und mobile, tablet oder desktop.
screen, language Etwa 1440x900 und en-CA.

csv

time,url,visitor,referrer,country,device
2024-05-01T12:34:56Z,https://example.com/?utm_source=newsletter,3f9a,news.ycombinator.com,CA,mobile
2024-05-01T12:36:10Z,https://example.com/pricing,3f9a,,CA,mobile

Wie bei Umami kommen nur Zeilen von vor Runlights eigenem erstem Besuch herüber, und Kampagnen werden aus den utm_-Parametern jeder Adresse gelesen. Die Datei wird in deinem Browser gelesen und in Stapeln von 2.000 Zeilen gesendet. Wenn du dieselbe Datei erneut importierst, ersetzt sie die Zeilen, die sie vorher gebracht hat, es wird also nichts doppelt gezählt.

Wege

Der Pfeil-Button in der Box Seiten öffnet Wege. Die Ansicht zeigt die Pfade, die Besuche Seite für Seite durch die Website nehmen. Jede Spalte ist ein Schritt, mit ihren häufigsten Seiten und der Zahl der Besuche, die nicht weitergingen, und die Linien zwischen den Spalten zeigen, wohin Besuche als Nächstes gingen, dicker für mehr. Eine Seite, die zweimal hintereinander gesehen wird, wie bei einem Neuladen, zählt einmal. Wähle, wie viele Schritte angezeigt werden, beginne bei einer Seite wie deiner Preisseite oder ende bei einer wie einer Dankeseite. Klick auf eine beliebige Seite, um nur den Besuchen zu folgen, die bei diesem Schritt dort vorbeikamen. Dieselbe Antwort kommt aus /api/journeys und vom MCP-Tool get_journeys.

Der KI-Assistent

Der Roboter-Knopf neben Filter öffnet einen Assistenten, den du in einfachen Worten zu deinen Statistiken fragen kannst, etwa woher die Besucher letzten Monat kamen oder welche Seiten Leute am Lesen halten. Er liest die Zahlen mit denselben schreibgeschützten Werkzeugen wie der MCP-Server, für die Website und die Daten auf dem Bildschirm, sofern du nicht nach anderen fragst, und er kann nie etwas ändern.

Der Eigentümer oder ein Admin richtet ihn einmal unter Einstellungen, KI-Assistent ein. Wähle Anthropic, OpenAI, Google Gemini, OpenRouter, Ollama, LM Studio oder einen beliebigen Dienst mit einer OpenAI-kompatiblen API, dann ein Modell und einen Schlüssel. Ollama und LM Studio führen ein Modell ohne Schlüssel auf deinem eigenen Rechner aus, solange der Server, auf dem Runlight läuft, es erreichen kann. Der Schlüssel bleibt auf dem Server, verschlüsselt mit RUNLIGHT_SECRET (oder dem Token, wenn es kein Secret gibt), und wird nie an einen Browser zurückgeschickt.

Jede Frage geht an den Dienst, den du gewählt hast, zusammen mit den Zahlen, die der Assistent zum Antworten liest. Runlight behält nichts über einzelne Besucher, also wird nichts Persönliches gesendet. Alle, die im Dashboard angemeldet sind, können ihn fragen, API-Tokens und Freigabelinks dagegen nicht. Jede Frage verbraucht dein KI-Guthaben, deshalb kann jede Person dreißig pro Stunde stellen und jeder Betrachter 50 pro Tag. Diese Zahl kann der Eigentümer oder ein Admin unter KI-Assistent ändern oder auf 0 setzen, um den Assistenten Betrachtern vorzuenthalten. Das Gespräch lebt im Browser-Tab und ist weg, wenn der Tab geschlossen wird.

Daten behalten

Jede Website behält jeden Besuch, sofern du nichts anderes wählst. Unter Einstellungen, Daten bietet Besuche behalten für 6 Monate oder 1, 2, 3 oder 5 Jahre an. Wenn du eine kürzere Dauer speicherst, werden ältere Besuche und Ereignisse endgültig gelöscht, und das Dashboard sagt dir vor dem Speichern, ab welchem Datum. Danach löscht der stündliche Check jeden Tag, was über die Grenze hinausgeht. Ziele, Links und Einstellungen bleiben. Im selben Bereich gibt es Alles exportieren, ein ZIP mit allen Berichten seit dem ersten Besuch der Website, das sich herunterzuladen lohnt, bevor du die Dauer verkürzt.

Einstellungen

Das Zahnrad neben dem Namen der Website öffnet die Einstellungen. Allgemein enthält den Namen und die Zeitzone der Website, dazu die Sprache und das Design des Dashboards, die jeder Browser für sich behält. Die anderen Bereiche sind Einbinden, Ziele, Funnels, E-Mail-Dienst, E-Mail-Berichte, Teilen, API und KI, Eigene Domains, Import, Daten und KI-Assistent, und der Eigentümer und die Admins sehen außerdem Personen, wenn Konten aktiv sind, wie es auf dem eigenständigen Server immer der Fall ist. Der Design-Schalter ist auch in der Fußzeile, und Shift+Cmd+D (Shift+Strg+D) schaltet ihn von überall um.