Leitfaden zur Fehlerbehebung

Lösungen für häufige CookieBeam-Probleme. Wenn Sie keine Antwort finden, senden Sie eine E-Mail an [email protected]

Schnelleinstieg:

Probleme mit der Banneranzeige Google Tag Manager Probleme Consent Mode v2 Probleme Cookie-Scanning Probleme Leistungsprobleme

Probleme mit der Banneranzeige

Banner wird auf meiner Website nicht angezeigt

Prüfen, ob das Skript geladen wird

1. Öffnen Sie Ihre Website in Chrome
2. Drücken Sie F12, um die Entwicklertools zu öffnen
3. Gehen Sie zum Reiter „Netzwerk“ (Network)
4. Laden Sie die Seite neu
5. Suchen Sie im Filter nach „cookiebeam“
6. Wenn Sie einen Status 200 sehen, wurde das Skript erfolgreich geladen

Banner-ID überprüfen

1. Gehen Sie zu Ihrem CookieBeam-Dashboard
2. Klicken Sie auf Ihr Banner → Reiter Installation
3. Kopieren Sie Ihre Banner-ID
4. Prüfen Sie, ob sie mit der ID in Ihrem Website-Code übereinstimmt
5. Häufiger Fehler: Verwendung der falschen ID oder Verbleib des Platzhalters „YOUR-BANNER-ID“

JavaScript-Fehler prüfen

1. Öffnen Sie die Chrome-Entwicklertools (F12)
2. Gehen Sie zum Reiter „Konsole“ (Console)
3. Suchen Sie nach roten Fehlermeldungen
4. Wenn Sie „CookieBeam is not defined“ oder ähnliches sehen, lädt das Skript nicht
5. Versuchen Sie, das Attribut „defer“ hinzuzufügen: script src="..." defer

Cache leeren

1. Erzwingen Sie eine Aktualisierung Ihres Browsers: Strg+Umschalt+R (Windows) oder Cmd+Umschalt+R (Mac)
2. Oder leeren Sie den Browser-Cache vollständig
3. Testen Sie im Inkognito-/Privatmodus

Banner wird auf dem Desktop, aber nicht auf dem Handy angezeigt

Responsive-Einstellungen prüfen

1. Gehen Sie zu Banner-Designer → Layout
2. Stellen Sie sicher, dass „Mobil-Responsive“ aktiviert ist
3. Testen Sie verschiedene Bildschirmgrößen in den Entwicklertools (F12 → Device Toolbar)
4. Prüfen Sie auf CSS-Konflikte auf mobilen Geräten

Banner erscheint, sieht aber fehlerhaft/ungestylt aus

CSS-Konflikt

1. Das CSS Ihrer Website überschreibt möglicherweise die Banner-Styles
2. Fügen Sie im CookieBeam-Benutzer-CSS die Priorität !important hinzu
3. Oder erhöhen Sie die CSS-Spezifität in den Banner-Einstellungen
4. Prüfen Sie die Browser-Konsole auf CSS-Fehler

Banner wird bei jedem Besuch angezeigt (speichert Auswahl nicht)

Probleme bei der Cookie-Speicherung

1. Prüfen Sie, ob Ihr Browser Drittanbieter-Cookies blockiert
2. Überprüfen Sie, ob localStorage aktiviert ist (erforderlich für die Einwilligungsspeicherung)
3. Prüfen Sie, ob Sie im Privat-/Inkognito-Modus sind (Cookies bleiben dort nicht bestehen)
4. Stellen Sie sicher, dass das Einwilligungs-Cookie nicht von einem anderen Skript gelöscht wird

Google Tag Manager Probleme

Banner wird im GTM-Vorschaumodus nicht ausgelöst

Tag-Konfiguration prüfen

1. Öffnen Sie den GTM-Vorschaumodus
2. Suchen Sie das „CookieBeam Consent“ Tag in der Tag-Liste
3. Überprüfen Sie, ob „Tags Fired“ und nicht „Tags Not Fired“ angezeigt wird
4. Falls nicht ausgelöst, prüfen Sie die Trigger-Konfiguration
5. Verwenden Sie den Trigger „Einwilligungsinitialisierung - Alle Seiten“

Tag wird ausgelöst, aber Banner erscheint nicht

1. Öffnen Sie die Browser-Konsole (F12)
2. Suchen Sie nach dem Laden des CookieBeam-Skripts
3. Prüfen Sie, ob die Banner-ID im GTM-Tag-Code korrekt ist
4. Prüfen Sie, ob die Skript-URL lautet: https://cdn.cookiebeam.com/banner/...

Andere Tags werden weiterhin ohne Einwilligung ausgelöst

Einwilligungsanforderungen konfigurieren

1. Öffnen Sie jedes GA4/Google Ads Tag im GTM
2. Gehen Sie zu Erweiterte Einstellungen → Einwilligungseinstellungen
3. Aktivieren Sie „Zusätzliche Einwilligung für das Auslösen des Tags erforderlich“
4. Für GA4: Wählen Sie „analytics_storage“
5. Für Google Ads: Wählen Sie „ad_storage“ und „analytics_storage“
6. Speichern und veröffentlichen

Sicherstellen, dass CookieBeam zuerst lädt

1. Das CookieBeam-Tag muss den Trigger „Einwilligungsinitialisierung“ verwenden
2. Dies wird VOR allen anderen Tags ausgelöst
3. Andere Marketing-Tags sollten Einwilligungsvoraussetzungen haben

Leistungsprobleme

Banner lädt langsam

Laden optimieren

1. Stellen Sie sicher, dass das Skript das Attribut „defer“ hat
2. Verwenden Sie die CDN-Version (cdn.cookiebeam.com), nicht selbst gehostet
3. Prüfen Sie Ihre Internetgeschwindigkeit
4. Das Banner sollte bei guter Verbindung in < 500ms laden

Banner blockiert das Laden der Seite

Asynchrones Laden

1. Verwenden Sie immer das Attribut „defer“ oder „async“ im Script-Tag
2. Korrekt: script src="..." defer
3. Niemals synchron im Head laden

Erweitertes Debugging

Für Entwickler: Nutzen Sie diese Konsolenbefehle zum Debuggen von CookieBeam

Prüfen, ob CookieBeam geladen ist:

window.CookieBeam !== undefined

Aktuellen Einwilligungsstatus abrufen:

CookieBeam.getConsent()

dataLayer prüfen (GTM):

window.dataLayer

Banner erzwingen (Testen):

CookieBeam.show()

Einwilligung zurücksetzen (Testen):

CookieBeam.reset()

Benötigen Sie weitere Hilfe?

Wenn Sie hier keine Lösung gefunden haben, sind wir für Sie da!

✉️ E-Mail-Support

[email protected]

Antwort innerhalb von 24 Stunden

❓ FAQ

Häufige Fragen

Schnelle Antworten

📚 Wissensdatenbank

Leitfäden & Tutorials

Ausführliche Dokumentation

📊 Beim Melden von Problemen: Geben Sie Ihre Browser-ID (im CookieBeam-Dashboard zu finden), Browserversion und Schritte zur Reproduktion an. Screenshots helfen ebenfalls!