Fehlerbehebung

Fehlerbehebung

Hier findest du Lösungen für die häufigsten Probleme mit KaaTai Consent Manager. Wenn dein Problem nicht aufgeführt ist, nutze den Ticket-Support über das SaaS-Dashboard.

Banner wird nicht angezeigt

Symptom: Die Seite lädt, aber kein Cookie-Banner erscheint.

Mögliche Ursachen und Lösungen:

1. Banner ist deaktiviert

   • Prüfe unter KaaTai Consent Manager → Einstellungen, ob "Banner aktivieren" eingeschaltet ist

2. Caching-Plugin liefert alte Version

   • Leere den Cache deines Caching-Plugins (WP Super Cache, W3 Total Cache, LiteSpeed, etc.)
   • Leere den Browser-Cache (Strg+Shift+Entf)
   • Prüfe CDN-Cache (Cloudflare, etc.)

3. Cookie bereits gesetzt

   • Öffne die Seite im Inkognito-Modus — wenn das Banner dort erscheint, ist bei dir bereits ein Consent-Cookie gesetzt
   • Lösche das Cookie kccm_consent in den Browser-Einstellungen

4. Theme-Konflikt

   • Manche Themes überschreiben die wp_head und wp_footer Actions
   • Prüfe, ob dein Theme wp_head() und wp_footer() in der header.php bzw. footer.php aufruft

5. Plugin-Konflikt

   • Deaktiviere andere Plugins probeweise und prüfe, ob das Banner dann erscheint
   • Häufige Konflikte: andere Cookie-Banner-Plugins, Minifier, Script-Optimizer

Cache-Probleme

Symptom: Änderungen an den Einstellungen werden nicht sichtbar.

Lösung:

1. Plugin-Cache leeren:

   • Nach jeder Einstellungsänderung sendet das Plugin automatisch eine neue Config an das SaaS
   • Der lokale Transient-Cache wird bei Settings-Save zurückgesetzt

2. WordPress-Cache leeren:

   • WP Super Cache: Einstellungen → WP Super Cache → Cache leeren
   • W3 Total Cache: Performance → Dashboard → Alle Caches leeren
   • LiteSpeed: LiteSpeed Cache → Toolbox → Alles purgen

3. CDN-Cache leeren:

   • Cloudflare: Caching → Purge Everything
   • Andere CDNs: Cache-Purge über das jeweilige Dashboard

4. Browser-Cache leeren:

   • Chrome: Strg+Shift+Entf → "Bilder und Dateien im Cache" → Löschen
   • Oder: Inkognito-Modus zum Testen nutzen

Scanner hängt / lädt nicht

Symptom: Der Scanner-Button wurde geklickt, aber es passiert nichts oder der Scan bricht ab.

Mögliche Ursachen und Lösungen:

1. Lokaler Scanner (auch ohne Konto):

   • Prüfe, ob JavaScript-Fehler in der Browser-Konsole angezeigt werden (F12 → Konsole)
   • Deaktiviere Browser-Erweiterungen (Ad-Blocker blockieren oft den Scanner)
   • Versuche einen anderen Browser
   • Prüfe, ob deine Seite im iframe geladen werden kann (manche Security-Plugins blockieren iframes)

2. Deep-Scan (mit kostenlosem Konto):

   • Prüfe die Internetverbindung
   • Warte 5 Minuten (Scan-Cooldown zwischen Scans)
   • Prüfe, ob dein API-Key im Plugin eingetragen und gültig ist (Tab Lizenz)
   • Prüfe, ob das tägliche Scan-Limit erreicht ist (Fair Use: 5 Scans pro Domain und Tag)

3. Seite nicht erreichbar:

   • Stelle sicher, dass deine Website von außen erreichbar ist (nicht nur lokal)
   • Prüfe, ob eine Firewall oder .htaccess den Scanner-User-Agent blockiert
   • Prüfe, ob eine Maintenance-Seite aktiv ist

API-Key ungültig

Symptom: Fehlermeldung "API-Key ungültig" oder "Lizenz konnte nicht validiert werden".

Mögliche Ursachen und Lösungen:

1. Falscher API-Key:

   • Kopiere den Key erneut aus dem SaaS-Dashboard (consent-management.kaatai.de)
   • Achte auf Leerzeichen am Anfang oder Ende

2. Domain stimmt nicht überein:

   • Der API-Key ist an eine Domain gebunden
   • Prüfe, ob die Domain im SaaS mit deiner WordPress-Adresse übereinstimmt
   • Beachte: www.example.com und example.com sind verschiedene Domains

3. Key im Dashboard gelöscht oder Domain entfernt:

   • Prüfe im Dashboard, ob der Key und die Domain noch existieren
   • Ein gelöschter Key wird sofort ungültig

4. Server kann SaaS nicht erreichen:

   • Prüfe, ob consent-management.kaatai.de von deinem Server erreichbar ist
   • Manche Hosting-Provider blockieren ausgehende HTTPS-Verbindungen
   • Prüfe mit: Werkzeuge → Website-Zustand → REST-API-Verfügbarkeit

Dienste werden nicht geladen

Symptom: Tracking-Skripte (Analytics, Pixel, etc.) werden nicht geladen, obwohl Consent erteilt wurde.

Lösung:

1. Prüfe, ob der Dienst im Dienste-Tab aktiviert ist (Toggle grün)
2. Prüfe, ob der Auto-Blocker den Dienst blockiert (Einstellungen → Auto-Blocker)
3. Prüfe in der Browser-Konsole, ob JavaScript-Fehler auftreten
4. Leere den Cache (siehe oben)
5. Prüfe, ob ein Minifier die Skripte verändert (Autoptimize, WP Rocket JS-Optimierung)

Rechtstexte (DSE/Impressum) werden nicht angezeigt

Symptom: Der Shortcode [kccm_datenschutz] oder [kccm_impressum] zeigt keinen Inhalt.

Lösung:

1. Kein Konto: Der Impressum-Generator und der Abgleich mit dem Dashboard brauchen ein (kostenloses) Konto. Die Datenschutzerklärung funktioniert auch ohne Konto.
2. Unternehmensdaten fehlen: Prüfe unter KaaTai Consent Manager → Rechtstexte, ob alle Pflichtfelder ausgefüllt sind
3. Transient-Cache: Die Texte werden 24 Stunden gecacht. Unter Rechtstexte → "Aktualisieren" klicken
4. Shortcode-Syntax: Prüfe auf Tippfehler — korrekt ist [kccm_datenschutz] und [kccm_impressum]. Die alten Varianten ohne k ([ccm_datenschutz]) wurden mit Version 3.35.0 entfernt und erzeugen keinen Inhalt mehr.

Google Consent Mode funktioniert nicht

Symptom: In Google Analytics/Ads fehlen Consent-Signale.

Lösung:

1. Prüfe in der Browser-Konsole (F12), ob der GCM v2 Block geladen wird ("Google Consent Mode v2 - KaaTai Consent Manager")
2. Stelle sicher, dass der GCM-Code vor dem GA/GTM-Code geladen wird
3. Prüfe, ob ein anderes Plugin ebenfalls Consent Mode setzt (Doppelte Defaults führen zu Konflikten)
4. Nutze den Google Tag Assistant zur Diagnose

Allgemeine Tipps

• Inkognito-Modus nutzen: Zum Testen immer ein neues Inkognito-Fenster öffnen
• Browser-Konsole prüfen: F12 → Konsole zeigt JavaScript-Fehler
• WordPress-Gesundheit: Unter Werkzeuge → Website-Zustand prüfen
• Plugin-Updates installieren: Viele Probleme werden in Updates behoben
• Support kontaktieren: Ticket im SaaS-Dashboard erstellen mit Screenshots und Browser-Konsolen-Ausgabe

---

Stand: 01.04.2026