Analytics-Integration

Erfahren Sie, wie Sie datenschutzfreundliche Analytics zu Ihrer Website hinzufügen.

Skriptinstallation

Nutzen Sie die Methoden in diesem Dokument, um privatestater.js zu installieren.

Überspringen Sie diesen Abschnitt, wenn Sie das Skript bereits installiert haben.

Automatisch erfasste Daten

Nach der Skriptinstallation werden folgende Daten automatisch erfasst:

Daten	Beschreibung	Beispiel
Besucher	Eindeutige Besucher pro Stunde	Stündlich aggregiert
Seitenpfad	Besuchter URL-Pfad	`/`, `/about`, `/blog/post-1`
Browser	Verwendeter Browsertyp	Chrome, Firefox, Safari
Gerätetyp	Geräteklassifikation	Desktop, Mobile, Tablet
Sprache	Browserspracheinstellung	ko, en, ja
Referrer	Traffic-Quelle	google.com, twitter.com

Datenschutzmethoden

IP-Hashing: IP-Adressen werden mit Datum und Uhrzeit kombiniert gehasht. Original-IPs werden nicht gespeichert.
Stündliche Deduplizierung: Mehrere Besuche desselben Besuchers in derselben Stunde zählen als ein Besuch.
Keine Cookies: Ich verwende keine Cookies zur Besucherverfolgung.

Traffic-Quellen-Tracking

Sie können Besucherquellen über URL-Parameter verfolgen.

Unterstützte Parameter

Wenn einer der folgenden Parameter in der URL steht, wird er automatisch als Referrer erfasst:

Parameter	Verwendung	Beispiel-URL
`src`	Allgemeine Quelle	`example.com?src=newsletter`
`source`	Allgemeine Quelle	`example.com?source=twitter`
`ref`	Empfehlung	`example.com?ref=partner`
`utm_source`	UTM-Kampagne	`example.com?utm_source=google`

Verwendungsbeispiele

Link aus einem Newsletter:

https://example.com/landing?src=newsletter

Teilen in sozialen Medien:

https://example.com/blog/post?source=mastodon

Von einer Partner-Website:

https://example.com?ref=partner-website

Liegt ein Quellparameter vor, hat er Vorrang vor dem HTTP-Referer-Header.

Klick-Tracking

Nutzen Sie die JavaScript-API, um Klicks auf bestimmte Buttons oder Links zu erfassen.

Grundlegende Verwendung

window.PrivateStater.statsClick("button_id");

Praxisbeispiel

<button onclick="window.PrivateStater.statsClick('signup_button')">
  Sign Up
</button>

<a href="/pricing" onclick="window.PrivateStater.statsClick('pricing_link')">
  View Pricing
</a>

Methode mit Event Listener

document.getElementById('cta-button').addEventListener('click', function() {
    window.PrivateStater.statsClick('cta_main');
});

Regeln für Button-IDs

Alphanumerische Zeichen, Bindestriche (-), Unterstriche (_) erlaubt
Keine Leerzeichen
Maximal 100 Zeichen

Statistiken im Dashboard ansehen

Abfragezeitraum

Im Dashboard können Sie Statistiken für folgende Zeiträume ansehen:

Zeitraum	Beschreibung
1 Stunde	Letzte 1-2 Stunden
12 Stunden	Letzte 12 Stunden
1 Tag	Letzte 24 Stunden
3 Tage	Letzte 3 Tage
7 Tage	Letzte 1 Woche
14 Tage	Letzte 2 Wochen
30 Tage	Letzter 1 Monat
6 Monate	Letzte 6 Monate
1 Jahr	Letztes 1 Jahr

Statistiktypen

Statistik	Beschreibung
Besucher	Besucheranteil und -anzahl nach Zeit
Browser	Besucheranteil und -anzahl nach Browser
Gerät	Anteil und Anzahl für Desktop/Mobile/Tablet
Sprache	Sprachanteil und -anzahl der Besucher
Seite	Anteil und Anzahl der aufgerufenen Seiten
Referrer	Anteil und Anzahl der Traffic-Quellen
Klicks	Klickanteil und -anzahl

Bot-Erkennung

PrivateStater erkennt bekannte Bots automatisch und klassifiziert sie separat:

Suchmaschinen-Crawler (Googlebot, Bingbot usw.)
Monitoring-Tools (Pingdom, UptimeRobot usw.)
SNS-Vorschau-Bots (Mastodon, Twitter usw.)

Bot-Traffic wird von normalen Besucherstatistiken getrennt und im Gerätetyp als Bot-Name angezeigt.

Fehlerbehebung

Statistiken werden nicht angezeigt

Prüfen Sie, ob das Skript korrekt installiert ist.
Prüfen Sie, ob YOUR_SITE_ID mit der Website-ID im Dashboard übereinstimmt.
Prüfen Sie die Browser-Entwicklertools auf Fehler in der Konsole.
Prüfen Sie, ob ein Werbeblocker das Skript blockiert.

Test auf localhost funktioniert nicht

Für lokale Entwicklungsumgebungen oder unsichere Verbindungen werden keine Statistiken erfasst.
Echte Statistiken werden nur in Produktionsumgebungen erfasst.