Tracking-Script

Ein leichtgewichtiges, datenschutzfreundliches Tracking-Script.

Grundlegende Verwendung

<script
  defer
  data-site-id="YOUR_SITE_ID"
  src="https://glyphex.io/tracker.js"
></script>

Manche Werbeblocker stoppen Anfragen an glyphex.io. Um auch diese Besuche zu zählen, liefern Sie den Tracker über Ihre eigene Domain aus.

Was erfasst wird

Das Tracking-Script erfasst automatisch:

  • Seitenaufrufe - Jede Seite, die Ihre Besucher aufrufen
  • Referrer - Woher Besucher kommen (Google, Social Media usw.)
  • UTM-Parameter - Kampagnen-Tracking (utm_source, utm_medium usw.)
  • Gerätetyp - Desktop, Mobil oder Tablet
  • Browser - Chrome, Firefox, Safari usw.
  • Betriebssystem - Windows, macOS, iOS, Android usw.
  • Land und Stadt - Ungefährer Standort anhand der IP (IP wird nicht gespeichert)
  • Klicks auf ausgehende Links - Links zu externen Websites
  • Datei-Downloads - Downloads von PDFs, ZIPs und anderen Dateien
  • Scrolltiefe - Wie weit Besucher auf jeder Seite scrollen
  • Verweildauer - Auf jeder Seite verbrachte Zeit

Was NICHT erfasst wird

  • Persönliche Informationen (Namen, E-Mails usw.)
  • IP-Adressen (nur für die Geo-Zuordnung verwendet, dann verworfen)
  • Cookies oder dauerhafte Identifikatoren
  • Cross-Site-Tracking
  • Fingerprinting, das Einzelpersonen identifizieren könnte

Konfigurationsoptionen

Tracking deaktivieren

Nutzer können sich abmelden, indem sie ein localStorage-Flag setzen:

// Opt out of tracking
localStorage.setItem('glyphex_ignore', 'true');

// Opt back in
localStorage.removeItem('glyphex_ignore');

Nur in der Produktion tracken

Das Script ignoriert automatisch localhost und file://-URLs. Für bedingtes Laden:

{process.env.NODE_ENV === 'production' && (
  <Script
    defer
    data-site-id="YOUR_SITE_ID"
    src="https://glyphex.io/tracker.js"
  />
)}

Automatisches Tracking

Ausgehende Links

Klicks auf Links zu externen Domains werden automatisch erfasst. Sie sehen diese im Tab „Verhalten“ unter „Ausgehende Links“.

Datei-Downloads

Downloads gängiger Dateitypen werden automatisch erfasst:

pdf, zip, rar, 7z, doc, docx, xls, xlsx, ppt, pptx, csv, mp3, mp4, exe, dmg, apk

So funktioniert die Besucheridentifikation

Glyphex verwendet einen datenschutzfreundlichen Ansatz, um eindeutige Besucher ohne Cookies zu identifizieren:

  1. Ein täglich rotierender Salt wird mit der IP-Adresse und dem User-Agent des Besuchers kombiniert
  2. Dies wird gehasht, um einen temporären Identifikator zu erstellen
  3. Der Identifikator ändert sich täglich und verhindert so langfristiges Tracking
  4. Die ursprüngliche IP wird niemals gespeichert

Dies ermöglicht genaue Zählungen eindeutiger Besucher bei gleichzeitigem Schutz der Privatsphäre.

Module und Script-Größe

Der Tracker besteht aus einem kleinen Kern (Seitenaufrufe, SPA-Navigation, benutzerdefinierte Events, Engagement, Opt-out) plus optionalen Modulen. Das Per-Site-Tag /t/DEINE_SITE_ID.js liefert den Kern und nur die Module, die du unter Einstellungen, Tracking-Code, Funktionen aktivierst. Fehlt eine Einstellung, bleibt ein bisher immer aktives Modul aktiv, bestehende Sites ändern sich also nicht.

  • Ausgehende Links, Datei-Downloads: standardmäßig an, in den Einstellungen abschaltbar
  • Rage-Clicks, Core Web Vitals, JavaScript-Fehler: optional
  • Heatmaps: optional (ab Tarif Starter). Erfasst die Klickposition (Anteil der Seitenbreite, Höhe auf 10 px gerundet), die Geräteklasse und einen Element-Selektor (Tag, ID oder die ersten zwei Klassen), gebündelt und einmal gesendet, wenn die Seite ausgeblendet wird. Kein Text, keine Eingaben, keine Aufzeichnungen
  • Defekte URLs (404): im Kern enthalten, keine zusätzliche Größe
  • Das Script-Tag mit /tracker.js lädt den vollständigen Build mit allen Modulen

beforeSend-Hook

Prüfe, ändere oder verwirf jeden Treffer vor dem Senden. Setze data-before-send am Script-Tag auf den Namen einer globalen Funktion, oder beforeSend in window.__glyphex. Ein falsy-Wert verwirft den Treffer, ein Objekt ersetzt die Payload.

<script defer data-site-id="YOUR_SITE_ID" data-before-send="myFilter" src="https://glyphex.io/tracker.js"></script>

window.myFilter = (type, payload) => {
  if (payload.pathname.startsWith("/admin")) return false; // drop
  return payload; // or return a changed copy
};

Tracker-Optionen

Setze diese als data-Attribute am Script-Tag oder als dieselben Schlüssel (camelCase) in window.__glyphex. Beim Per-Site-Tag findest du sie auch unter Einstellungen, Tracking-Code, Funktionen.

  • data-exclude-search="true": Entfernt den Query-String aus erfassten Referrern und 404-URLs. UTM-Parameter werden vorher weiterhin aus der URL gelesen.
  • data-exclude-hash="true": Hash-Fragmente werden nie erfasst, Hash-Änderungen zählen nie als Seitenaufruf. Das ist bereits das Standardverhalten; die Option macht es explizit.
  • data-auto-track="false": Keine automatischen Seitenaufrufe, kein SPA-Tracking, keine 404-Treffer. Rufe analytics.pageview() und analytics.track() selbst auf.
  • data-tag="variant-b": Hängt ein Label (max. 50 Zeichen) an jeden Seitenaufruf und jedes Event, für A/B-Tests oder zur Trennung von Umgebungen. Im Dashboard danach filterbar.
  • data-domains="example.com,www.example.com": Sendet nur Daten, wenn der Hostname der Seite in dieser kommagetrennten Liste steht (exakter Abgleich, Staging und localhost werden also ignoriert). Ohne die Option sendet der Tracker von jedem Host.

Manueller Seitenaufruf: window.analytics.pageview("/virtual/path")

<script defer data-site-id="YOUR_SITE_ID" data-auto-track="false" data-tag="variant-b" src="https://glyphex.io/tracker.js"></script>

Deklarative Events

Füge data-glyphex-event zu einem beliebigen Element hinzu, um einen Klick ohne JavaScript zu erfassen. Zusätzliche data-glyphex-event-*-Attribute werden zu Event-Eigenschaften.

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

Performance

  • Script-Größe: Kern ca. 2,5 KB gzip-komprimiert. Das Standard-Per-Site-Script neuer Websites hat ca. 3,4 KB, das vollständige /tracker.js ca. 4,6 KB.
  • Lädt asynchron mit defer
  • Minimaler Einfluss auf die Ladegeschwindigkeit der Seite und die Core Web Vitals
  • Sendet mit fetch und keepalive, damit Seitenverlassen und Klicks die Navigation überstehen, mit Wiederholung im Speicher für alles andere