Tracker einbauen
Installieren Sie das Script-Tag Ihrer Website und prüfen Sie, dass Ereignisse eintreffen. Klären Sie Ihre Einwilligungsanforderungen, bevor Sie die Erfassung aktivieren.
1. Snippet kopieren
Melden Sie sich an, öffnen Sie Ihre Website und gehen Sie zu Settings → Installation → Scripts (Einstellungen → Installation → Skripte). Ihr Snippet sieht so aus, mit Ihrem eigenen Website-Token. Der hier gezeigte Stil Minimal liest seine Optionen aus Installation → Dashboard; der Stil Explicit (Explizit) schreibt dieselben Optionen als Skriptattribute (siehe Skriptoptionen).
<script defer src="https://app.seean.io/k.js"
data-site="YOUR_SITE_TOKEN"
data-api="https://app.seean.io"></script>Belassen Sie Skript- und API-Adresse wie oben gezeigt auf https://app.seean.io, es sei denn, die First-Party-Erfassung ist unter Installation aktiviert; dann wird der erzeugte Hostname <slug>-collect.seean.io - oder eine aktive eigene Erfassungsdomain - für beides verwendet. Ein bestehendes Snippet mit diesen Adressen muss sich nicht ändern, wenn Seean seine Infrastruktur aktualisiert.
2. Vor </head> einfügen
Verwenden Sie das gemeinsame HTML-Dokument oder Root-Layout für jede Seite, die Sie messen möchten. Folgen Sie Ihrer Plattformanleitung für die richtige Platzierung. Installieren Sie den Tracker nur einmal: Ein Layout und zusätzlich ein Tag-Manager können Besuche doppelt zählen.
Der Tracker beobachtet unterstützte History-API-Navigation, etwa / → /pricing. Query-Strings gehören nicht zum Seitenpfad; Hash-Fragmente werden ignoriert, sofern Sie nicht data-hash="true" setzen. Eine geänderte getaggte Kampagne oder eine abgelaufene Sitzung kann trotzdem eine neue Sitzung starten und denselben Pfad erneut zählen. Laden Sie den Tracker als klassisches externes Skript; importieren Sie ihn nicht in Ihr Anwendungs-Bundle und fügen Sie kein type="module" hinzu.
3. Prüfen
Öffnen Sie die veröffentlichte Website in einem normalen Browser-Tab und prüfen Sie dann Settings → Installation → Setup health (Einrichtungsstatus) für die passende Website. Last pageview received (Letzter empfangener Seitenaufruf) zeigt die Zeit des neuesten gespeicherten Seitenaufrufs; vor dem ersten Seitenaufruf zeigt Installation verified (Installation verifiziert), wann die veröffentlichte Seite die Prüfung zuletzt bestanden hat. Mit Check installation (Installation prüfen) untersuchen Sie die veröffentlichte Startseite auf Tracker, Token und Sicherheitsrichtlinie. Seean prüft die veröffentlichte Startseite auch automatisch im Hintergrund (jede Minute am ersten Tag der Website), sodass die Installation verifiziert ist, sobald das Snippet veröffentlicht ist, auch wenn das Dashboard geschlossen ist. Der Übersichts-Banner verschwindet dann, ohne auf einen Besuch zu warten.
Eine Referenz im Quelltext oder ein alter Besuch beweist nicht, dass Ihr neuestes Deployment funktioniert. Ordnen Sie einen neuen Seitenpfad und eine neue Zeit in Ereignisse mit den Installationsprüfungen zu. Die Anleitung zur Einrichtungsdiagnose erklärt Ergebnisse, Berechtigungen und Grenzen.
Skriptoptionen
Installation → Dashboard enthält die Tracking-Optionen der Website: UTM-Kampagnen (an), Hash-Seitenpfade (aus), Web Vitals (an), automatische Conversions (an für neue und nie konfigurierte Websites), Debug-Protokollierung (aus) und domainübergreifende Hostnamen. Save tracking options (Tracking-Optionen speichern) speichert sie; ein minimales Snippet übernimmt sie beim nächsten Seitenaufruf. Der Snippet-Stil Explicit schreibt dieselben Entscheidungen stattdessen als Attribute:
| Attribut | Standard | Wirkung |
|---|---|---|
data-conversions="true" |
aus in rohem HTML | Lädt die aktivierten automatischen Conversion-Vorlagen einmal pro Dokument. Erzeugte explizite Snippets enthalten es, solange automatische Conversions an sind. |
data-hash="true" |
aus | Zählt Änderungen von location.hash als Seitenaufrufe und meldet den Pfad mit seinem Fragment, zum Beispiel /docs#install. |
data-utm="off" |
an | Liest utm_source, utm_medium und utm_campaign nicht mehr; ein getaggter Link startet keine neue Sitzung mehr. |
data-vitals="off" |
an | Überspringt die Web-Vitals-Messung vollständig (keine Performance-Observer). |
data-debug="true" |
aus | Gibt jede Payload vor dem Senden mit console.debug aus. Sicher, wenn die Konsole nicht verfügbar ist. |
data-domains="a.com,b.com" |
aus | Domainübergreifende Übergabe: Links zu den aufgeführten Hosts (und ihren Subdomains) tragen die Besucher-ID, und eine Landingpage übernimmt eine eingehende ID. |
Sobald eines dieser Attribute vorhanden ist, werden die Dashboard-Optionen für diese Seite ignoriert. Details und Standardwerte: Skript- und Tracking-Optionen.
Was der Tracker sendet
| Feld | Bedeutung |
|---|---|
| path | der Seitenpfad ohne Query-String (mit Fragment, wenn data-hash an ist) |
| hostname | die gemessene Website |
| referrer | die verweisende URL des Browsers; der Collector behält nur ihren Hostnamen |
| timezone | Länder-Fallback, wenn der Netzwerk-Edge keines meldet |
| visitorId, sessionId | Standardidentitäten werden serverseitig pro Website und UTC-Tag abgeleitet; die optionale domainübergreifende Übergabe trägt die Identität im Session Storage desselben Tages |
| campaign | UTM source, medium, campaign, term und content, wenn vorhanden, sofern nicht data-utm="off" |
| click id | der Name eines Anzeigen-Klick-ID-Parameters in der Landing-URL (gclid, gbraid, wbraid, fbclid, msclkid, ttclid, li_fat_id, twclid); der Wert wird nie gelesen. Aus mit data-utm="off" |
| title | document.title, die ersten 200 Zeichen |
| uid | Ihre eigene Nutzer-ID nach seean.identify(id), nur gespeichert, wenn Identify users (Nutzer identifizieren) für die Website aktiviert ist |
| screen | screen.width x screen.height |
| Web Vitals | LCP, INP, CLS, FCP und TTFB; spätere Messungen können eine Stichprobe aktualisieren. Aus mit data-vitals="off" |
Der Collector liest Land, Region und Stadt aus den Netzwerk-Edge-Headern der Anfrage, nutzt den User-Agent für Browser, Betriebssystem und Gerätekategorien, speichert das erste Accept-Language-Tag des Browsers als Besuchersprache und kann die Region dieser Sprache als Länder-Fallback verwenden. Die IP-Adresse wird nur mit Ausschlussregeln verglichen und nie gespeichert. Query-Strings außer den UTM-Feldern und dem Klick-ID-Namen werden nie erfasst.
Das Standard-Tracking verwendet einen täglichen, website-bezogenen Server-Hash ohne Cookies oder dauerhaften Browser-Messspeicher. Die optionale domainübergreifende Übergabe nutzt sessionStorage desselben Tages. Die Erfassung stoppt bei Do Not Track, Global Privacy Control oder dem in Ausschlüsse beschriebenen Browser-Opt-out. Wo eine Einwilligung oder ein Opt-out gilt, steuern Sie das Laden des Skripts über den Einwilligungsmechanismus Ihrer Website. Siehe technischer Datenschutz und Speicherung und Einwilligung.
Lokale Entwicklung
Der Tracker ignoriert localhost und 127.0.0.1, sofern Sie dem Script-Tag nicht data-local hinzufügen. Verwenden Sie eine separate Seean-Website bzw. ein separates Token für Test-Traffic und kopieren Sie die API-Adresse aus dem Snippet dieser Website. Automatisierte Browser, Do Not Track, Global Privacy Control und das Browser-Opt-out können die Erfassung weiterhin stoppen; data-local deaktiviert diese Prüfungen nicht.
Installation entfernen oder aktualisieren
Entfernen Sie das Skript aus seinem Layout oder Tag-Manager und veröffentlichen Sie die Änderung, um die künftige Erfassung über diese Installation zu stoppen. Bestehende Berichte bleiben erhalten. Das Rotieren des Tracking-Tokens einer Website macht ihre alten Snippets sofort ungültig; aktualisieren Sie jede Installation mit dem neuen Token. Siehe Website-Einstellungen.
Etwas unklar? Support kontaktieren.