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:
- Ein täglich rotierender Salt wird mit der IP-Adresse und dem User-Agent des Besuchers kombiniert
- Dies wird gehasht, um einen temporären Identifikator zu erstellen
- Der Identifikator ändert sich täglich und verhindert so langfristiges Tracking
- 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.jslä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
fetchundkeepalive, damit Seitenverlassen und Klicks die Navigation überstehen, mit Wiederholung im Speicher für alles andere