Rozwiązywanie problemów

Rozwiązania typowych problemów z CookieBeam. Jeśli nie znajdziesz odpowiedzi, napisz do nas na adres [email protected]

Szybkie przejście:

Problemy z wyświetlaniem banera Problemy z Google Tag Manager Problemy z Consent Mode v2 Problemy ze skanowaniem plików cookie Problemy z wydajnością

Problemy z wyświetlaniem banera

Baner nie wyświetla się na mojej stronie

Sprawdź, czy skrypt jest załadowany

1. Otwórz swoją stronę w Chrome
2. Naciśnij F12, aby otworzyć narzędzia deweloperskie
3. Przejdź do zakładki „Network“
4. Odśwież stronę
5. Wyszukaj „cookiebeam“ w filtrze
6. Jeśli widzisz status 200, skrypt został załadowany pomyślnie

Zweryfikuj identyfikator banera

1. Przejdź do panelu CookieBeam
2. Kliknij na baner → zakładka Instalacja
3. Skopiuj identyfikator banera (Banner ID)
4. Sprawdź, czy jest zgodny z identyfikatorem w kodzie Twojej strony
5. Częsty błąd: Użycie nieprawidłowego ID lub pozostawienie placeholdera „YOUR-BANNER-ID“

Sprawdź błędy JavaScript

1. Otwórz Chrome DevTools (F12)
2. Przejdź do zakładki „Console“
3. Szukaj czerwonych komunikatów o błędach
4. Jeśli widzisz „CookieBeam is not defined“ lub podobny komunikat, skrypt nie jest ładowany
5. Spróbuj dodać atrybut defer: script src="..." defer

Wyczyść pamięć podręczną

1. Wymuś odświeżenie przeglądarki: Ctrl+Shift+R (Windows) lub Cmd+Shift+R (Mac)
2. Lub wyczyść całkowicie pamięć podręczną przeglądarki
3. Przetestuj w trybie incognito/prywatnym

Baner wyświetla się na komputerze, ale nie na urządzeniu mobilnym

Sprawdź ustawienia responsywności

1. Przejdź do Kreator banera → Układ
2. Upewnij się, że opcja „Mobile Responsive“ jest włączona
3. Przetestuj różne rozmiary ekranu w DevTools (F12 → Device Toolbar)
4. Sprawdź, czy CSS mobilny nie powoduje konfliktów

Baner pojawia się, ale wygląda na uszkodzony/nieostylowany

Konflikt CSS

1. CSS Twojej strony może nadpisywać style banera
2. Dodaj priorytet !important w niestandardowym CSS CookieBeam
3. Lub zwiększ specyficzność CSS w ustawieniach banera
4. Sprawdź konsolę przeglądarki pod kątem błędów CSS

Baner pojawia się przy każdej wizycie (nie zapamiętuje wyboru)

Problemy z przechowywaniem plików cookie

1. Sprawdź, czy przeglądarka nie blokuje plików cookie podmiotów trzecich
2. Upewnij się, że localStorage jest włączony (wymagany do przechowywania zgód)
3. Sprawdź, czy nie korzystasz z trybu prywatnego/incognito (pliki cookie nie są zachowywane)
4. Upewnij się, że plik cookie zgody nie jest usuwany przez inny skrypt

Problemy z Google Tag Manager

Baner nie uruchamia się w trybie podglądu GTM

Sprawdź konfigurację tagów

1. Otwórz tryb podglądu GTM
2. Poszukaj tagu „CookieBeam Consent“ na liście tagów
3. Upewnij się, że wyświetla się „Tags Fired“, a nie „Tags Not Fired“
4. Jeśli tag nie został uruchomiony, sprawdź konfigurację wyzwalacza
5. Użyj wyzwalacza „Consent Initialization - All Pages“

Tag uruchamia się, ale baner nie pojawia się

1. Otwórz konsolę przeglądarki (F12)
2. Szukaj ładowania skryptu CookieBeam
3. Sprawdź, czy Banner ID jest prawidłowy w kodzie tagu GTM
4. Zweryfikuj adres URL skryptu: https://cdn.cookiebeam.com/banner/...

Inne tagi nadal uruchamiają się bez zgody

Skonfiguruj wymagania zgody

1. Otwórz każdy tag GA4/Google Ads w GTM
2. Przejdź do Advanced Settings → Consent Settings
3. Włącz opcję „Require additional consent for tag to fire“
4. Dla GA4: Wybierz „Analytics Storage“
5. Dla Google Ads: Wybierz „Ad Storage“ i „Analytics Storage“
6. Zapisz i opublikuj

Upewnij się, że CookieBeam ładuje się jako pierwszy

1. Tag CookieBeam musi używać wyzwalacza „Consent Initialization“
2. Uruchamia się PRZED wszystkimi innymi tagami
3. Inne tagi marketingowe powinny mieć wymagania zgody

Problemy z wydajnością

Baner ładuje się wolno

Optymalizacja ładowania

1. Upewnij się, że skrypt ma atrybut „defer“
2. Korzystaj z wersji CDN (cdn.cookiebeam.com), a nie hostowanej samodzielnie
3. Sprawdź szybkość połączenia internetowego
4. Baner powinien ładować się w mniej niż 500 ms przy dobrym połączeniu

Baner blokuje ładowanie strony

Ładowanie asynchroniczne

1. Zawsze używaj atrybutu defer lub async w tagu script
2. Prawidłowo: script src="..." defer
3. Nigdy nie ładuj synchronicznie w sekcji head

Zaawansowane debugowanie

Dla programistów: Użyj poniższych poleceń w konsoli przeglądarki, aby debugować CookieBeam

Sprawdź, czy CookieBeam jest załadowany:

window.CookieBeam !== undefined

Pobierz aktualny stan zgody:

CookieBeam.getConsent()

Sprawdź dataLayer (GTM):

window.dataLayer

Wymuś wyświetlenie banera (testowanie):

CookieBeam.show()

Resetuj zgodę (testowanie):

CookieBeam.reset()

Nadal potrzebujesz pomocy?

Jeśli nie znalazłeś(-aś) tutaj rozwiązania, chętnie pomożemy!

✉️ Pomoc e-mailowa

[email protected]

Odpowiedź w ciągu 24 godzin

❓ FAQ

Często zadawane pytania

Szybkie odpowiedzi

📚 Centrum wiedzy

Poradniki i samouczki

Szczegółowa dokumentacja

📊 Zgłaszając problemy: Dołącz identyfikator przeglądarki (Browser ID, dostępny w panelu CookieBeam), wersję przeglądarki oraz kroki do odtworzenia problemu. Zrzuty ekranu również są pomocne!