Fehlerbehebung

Häufige Probleme und Lösungen bei der Nutzung von PrivateStater.

Allgemeine Probleme

Skript lädt nicht

Symptom: Fehler [privatestater.js] Missing prstSite config in der Konsole

Ursache: PrivateStaterConfig ist nicht vor dem Skript definiert

Lösung:

<!-- Must be in this order -->
<script>
  window.PrivateStaterConfig = { prstSite: "YOUR_SITE_ID" };
</script>
<script src="https://privatestater.com/privatestater.js"></script>

host_mismatch-Fehler

Symptom: Fehler host_mismatch in der Konsole

Ursache: Request-Origin stimmt nicht mit dem im Dashboard registrierten Host überein

Lösung:

1. Prüfen Sie den Host-Wert der Website im Dashboard
2. Prüfen Sie die Übereinstimmung mit der tatsächlichen Zugriffs-Domain
3. Prüfen Sie Subdomains (z. B. www.example.com vs. example.com)

Funktioniert nicht auf localhost

Ursache: localhost-Zugriff ist standardmäßig blockiert

Lösung:

1. Dashboard > Website > [Funktion] > Einstellungen
2. Option Localhost erlauben aktivieren

Hinweis: Muss für jede Funktion separat gesetzt werden (Captcha, Feedback).

Blockiert durch Werbeblocker

Symptom: Skript lädt nicht oder API-Anfrage wird blockiert

Ursache: Manche Werbeblocker blockieren analytics-bezogene Skripte

Lösung:

• Nutzer anleiten, privatestater.com zu erlauben
• Oder Freischaltung beim Filter-Maintainer anfragen

Analytics-Probleme

Besucherstatistiken werden nicht angezeigt

Checkliste:

1. Skriptinstallation prüfen

   console.log(window.PrivateStater); // Object should be printed
   

2. websiteId prüfen

   • Muss mit der im Dashboard erstellten ID übereinstimmen

3. Netzwerkanfragen prüfen

   • Browser-Entwicklertools > Netzwerk
   • Anfrage /api/analytics/collect/visit prüfen
   • Antwort sollte 204 sein

4. Wartezeit

   • Statistiken erscheinen innerhalb von etwa einer Minute

Doppelte Besucher werden gezählt

Kein Fehler: Dieses Verhalten ist normal.

Erklärung: PrivateStater dedupliziert stündlich. Besuche desselben Besuchers zu unterschiedlichen Zeiten werden separat gezählt.

Beispiel:

• Besuch um 10:00 Uhr → Zählt als 1
• Erneuter Besuch um 10:30 Uhr → Dedupliziert (gleiche Stunde)
• Erneuter Besuch um 11:00 Uhr → +1 (andere Stunde)

Klick-Tracking funktioniert nicht

Checkliste:

1. Funktionsaufruf prüfen

   window.PrivateStater.statsClick("button_id");
   

2. buttonId-Format prüfen

   • Nur alphanumerisch, Bindestriche, Unterstriche
   • Keine Leerzeichen

Captcha-Probleme

Captcha-Widget erscheint nicht

Checkliste:

1. Aktivierung prüfen

   • Dashboard > Captcha > Einstellungen > Aktivierungsstatus

2. data-captcha-Attribut prüfen

   <div data-captcha="prst"></div>
   

3. Konsolenfehler prüfen

   • captcha_not_enabled: Captcha nicht aktiviert
   • website_not_found: Ungültige websiteId

Puzzle-Verifizierung schlägt fehl

Ursache:

• Puzzleteil nicht genau genug positioniert (Toleranz: ±8px)
• Sitzung abgelaufen (5 Minuten)

Lösung: Puzzleteil exakt an die richtige Position setzen.

PoW dauert zu lange

Ursache: PoW-Schwierigkeit zu hoch oder PoW aktiviert

Lösung:

1. Dashboard > Captcha > Einstellungen
2. PoW-Schwierigkeit auf low setzen oder PoW aktiviert deaktivieren, um Proof-of-Work zu überspringen (schneller, weniger Bot-Schutz)

Geschätzte Dauer nach Schwierigkeit:

• low: ~1s
• medium: ~2s
• high: ~3s

Token-Validierung schlägt fehl

Checkliste:

1. Token-Ablauf prüfen

   • Token läuft nach 5 Minuten ab

2. Doppelte Nutzung prüfen

   • Token nur einmal verwendbar
   • Bereits geprüfte Tokens nicht wiederverwendbar

3. websiteId-Übereinstimmung prüfen

   • Gleiche websiteId auf Client und Server

4. API-Anfrageformat prüfen

   {
       "websiteId": "my-site",
       "verifyToken": "session-id:signature"
   }
   

honeypot_triggered-Fehler

Ursache: Honeypot-Feld ausgefüllt (als Bot erkannt)

Checkliste:

• Auto-Ausfüll-Tools deaktivieren
• Browser-Erweiterungen prüfen

Feedback-Probleme

Feedback-Button erscheint nicht

Checkliste:

1. Aktivierung prüfen

   • Dashboard > Feedback > Einstellungen > Aktivierungsstatus

2. z-index-Konflikt

   • Button kann von anderen Elementen verdeckt sein
   • z-index des Feedback-Buttons: 999998

Screenshot-Anhang schlägt fehl

Ursache:

• Bildgröße über 1MB
• Manche Elemente nicht erfassbar (CORS-Bilder usw.)

Lösung:

• Screenshots werden mit der html2canvas-Bibliothek erstellt
• Externe Bilder können wegen CORS nicht erfasst werden

Feedback wird nicht gesendet

Checkliste:

1. Pflichtdaten prüfen

   • Mindestens eine von Bewertung, Text oder Screenshot erforderlich

2. Rate Limit prüfen

   • Limit 10 pro Minute

3. Netzwerkanfragen prüfen

   • Antwort von /api/feedback/submit prüfen

4. Feld technicalAttachment prüfen (direkte API-Aufrufe)

   • technicalAttachment als Boolean senden (true oder false)

Fehlercode-Referenz

Weiterer Support

Wenn nichts davon hilft:

• E-Mail: hello@privatestater.com
• Bitte Beschreibung, Fehlermeldung und Browser-Konsolen-Logs mitschicken.