Tracking-Script

Einbau

Füge das Script in den <head> jeder Seite ein. Seitenaufrufe werden automatisch erfasst; window.trackd steht danach für Custom Events und Umsätze bereit.

<script defer src="https://trackd.one/t.js" data-website="YOUR_WEBSITE_ID"></script>

Das Script funktioniert auf jeder Website — statisches HTML, React, Vue, Next.js, WordPress, Shopify usw. Web Vitals werden über ein optionales Modul (ca. 1,5 KB) nachgeladen.

Attribute

Attribut	Bedeutung
data-website	deine Website-ID (Pflicht)
data-host	zeigt auf deine selbst gehostete Instanz statt trackd.one
data-do-not-track="true"	deaktiviert das Tracking auf dieser Seite
data-heatmap="true"	aktiviert die Klick-Erfassung für Heatmaps
data-vitals="false"	schaltet das Web-Vitals-Modul ab
data-vitals-sample="0.1"	misst Web Vitals nur bei einem Anteil der Seitenaufrufe (hier 10 %)

Single-Page-Apps

Das Script erkennt Client-Routing automatisch: Änderungen über history.pushState, replaceState, popstate und hashchange erzeugen jeweils einen Seitenaufruf. Hash-Router (#/pfad, #!/pfad) werden wie normale Pfade behandelt. Du musst nichts weiter einrichten.

Was gesendet wird

Pro Seitenaufruf genau eine Anfrage an POST /api/collect:

{
  "type": "pageview",
  "website_id": "YOUR_WEBSITE_ID",
  "url": "https://example.com/preise?utm_source=newsletter",
  "referrer": "https://www.google.com/",
  "title": "Preise",
  "utm_source": "newsletter"
}

• Query-Parameter mit sensiblen Namen (z. B. token, email, password) werden vor dem Senden entfernt, E-Mail-Adressen in URLs durch [email] ersetzt.
• Das Script liest keine Geräteeigenschaften wie Bildschirmgröße oder Sprache aus; Sprache und Gerätetyp leitet der Server aus den Request-Headern ab.
• Gespeichert werden von der URL nur Pfad und utm_*-Parameter, vom Referrer nur Herkunft und Pfad.

Domain-Prüfung

Web-Requests müssen von der registrierten Domain oder einer Subdomain kommen (www. wird ignoriert). Andernfalls antwortet der Server mit 403. Lokale Tests unter localhost werden deshalb nicht gezählt — nutze eine eigene Test-Website, wenn du Staging-Umgebungen messen willst.

Opt-out

Besucher können das Tracking über Global Privacy Control oder „Do Not Track“ abschalten, deine Seite zusätzlich per window.trackdOptOut = true. Details unter Datenschutz & DSGVO.