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

Start

Tracking

Das Skript zählt manches von selbst, und diese Seite zeigt, wie du eigene Ereignisse sendest und die Einstellungen am Script-Tag änderst.

Was es von selbst zählt

Allein mit dem Script-Tag zeichnet Runlight Folgendes von selbst auf.

  • Seitenaufrufe, auch Seitenwechsel in Single-Page-Apps (es folgt history.pushState, replaceState und dem Zurück-Button).
  • Aktive Zeit und Scrolltiefe für jeden Seitenaufruf. Zeit zählt nur, solange der Tab sichtbar und im Fokus ist.
  • Ausgehende Links, aufgezeichnet als Ereignis Outbound link mit der url, wenn jemand auf einen Link zu einer anderen Website klickt.
  • Datei-Downloads, aufgezeichnet als Ereignis File download, wenn jemand auf einen Link zu einer PDF-, Zip-, Disk-Image-, Dokument-, Audio- oder Videodatei klickt.
  • 404-Fehler, auf einer Seite, deren Script-Tag data-404 hat (siehe unten). Jeder ist ein Ereignis namens 404, dessen Eigenschaft path die Adresse ist, die nicht gefunden wurde. So listen die Eigenschaften von 404 in der Box Ereignisse die kaputten Adressen auf, die Leute erreicht haben, und wie oft.

Runlight überspringt Besuche von bekannten Bots und von Browsern, die per Automatisierung gesteuert werden, etwa mit Playwright, Selenium und Puppeteer.

Deine eigenen Ereignisse

Ruf runlight mit einem Namen auf, optional mit einigen Eigenschaften.

js

runlight("Newsletter signup", { source: "footer" });
runlight("Purchase", { plan: "pro", revenue: 49 });

Eigenschaften können Strings, Zahlen oder Booleans sein. Jedes Ereignis nimmt bis zu 30 davon, mit Namen bis 60 Zeichen und Werten bis 500. Ereignisse zählen zu Besuchen und können Ziele sein.

Wenn dein Code laufen könnte, bevor das Skript geladen ist, stell die Aufrufe in eine Warteschlange.

html

<script>
  window.runlight = window.runlight || function () { (window.runlight.q = window.runlight.q || []).push(arguments); };
</script>

Klicks ohne JavaScript

Gib einem beliebigen Element ein data-runlight-Attribut, und ein Klick darauf sendet dieses Ereignis. Zusätzliche data-runlight-*-Attribute werden zu Eigenschaften.

html

<button data-runlight="Signup" data-runlight-plan="pro">Sign up</button>

Um Klicks auf etwas zu zählen, das du nicht bearbeiten kannst, füge im Dashboard ein Klickziel hinzu, das gar keinen Code braucht.

Einstellungen am Script-Tag

Attribut Was es tut
data-site="id" Welche Website, wenn eine Installation mehrere zählt und die Hostnamen nicht ausreichen.
data-hash Änderungen an location.hash als Seitenaufrufe zählen (für Hash-Router).
data-404 Diese Seite als 404 markieren, damit der Seitenaufruf auch ein Ereignis 404 mit dem Pfad der Seite aufzeichnet. Setze es auf deine Seite für nicht gefundene Adressen, wie es die Plugins für WordPress, Drupal und Craft für dich tun.
data-dnt Do Not Track respektieren. Standardmäßig aus, weil Runlight nichts Persönliches behält.
data-outbound="false" Klicks auf ausgehende Links nicht aufzeichnen.
data-downloads="false" Datei-Downloads nicht aufzeichnen.
data-exclude="/admin/*,/preview" Auf diesen Seiten nichts aufzeichnen, weder Seitenaufrufe noch Ereignisse. Trenne Muster mit Kommas und nutze * für Beliebiges.
data-manual Keine Seitenaufrufe von selbst senden. Ruf runlight.pageview() auf, wenn eine Seite angezeigt wird, oder runlight.pageview("/checkout/step-2"), um die Seite zu benennen.

Dich selbst ausnehmen

Im Dashboard gibt es unter Einstellungen, Allgemein einen Schalter Diesen Browser ignorieren. Wenn dein Dashboard auf einer anderen Domain als die Website liegt, öffne einmal in jedem Browser, den du nutzt, eine beliebige Seite der Website mit ?runlight=ignore. ?runlight=track macht das rückgängig. Dieses Flag ist das Einzige, was das Skript je speichert, und es existiert nur in Browsern, in denen du es gesetzt hast.