zgoda na cookies dla Nuxt
@cookiecrumbs/nuxt wstawia tag na początek app.head.script z priorytetem critical, przed chunkiem wejściowym Nuxt, i automatycznie importuje composable useConsent().
zasada
Aplikacja Nuxt z pluginem GA lub piksela uruchamia go na wejściu klienta. Nic nie pyta wcześniej i nic nie może tego cofnąć.
Zasada jest taka sama w całej UE i w Wielkiej Brytanii: bez zgody nie wolno zapisywać na urządzeniu odwiedzającego ani odczytywać z niego niczego poza tym, co ściśle niezbędne. To artykuł 5 ust. 3 dyrektywy ePrivacy, a zgoda musi spełniać definicję z RODO: dobrowolna, konkretna, świadoma i jednoznaczna, z odmową równie łatwą jak akceptacja. Wielka Brytania utrzymuje tę samą zasadę w PECR, z wąskimi wyjątkami dla statystyk niskiego ryzyka od 5 lutego 2026 r. Kalifornia i inne prawa stanowe USA działają odwrotnie: bez opt-in, ale z linkiem opt-out i obsługą sygnału Global Privacy Control.
Dla strony wynikają z tego trzy rzeczy. Skrypty analityczne, reklamowe i społecznościowe muszą poczekać na decyzję. Decyzję trzeba zapisać tak, aby dało się ją później pokazać, bo artykuł 7 ust. 1 przerzuca ciężar dowodu na Ciebie. A wycofanie zgody musi być równie łatwe jak jej udzielenie, co oznacza element na każdej stronie, który ponownie otwiera baner. Baner, który pokazuje dwa przyciski i mimo to ładuje Google Analytics, oblewa pierwszy test, i właśnie za to organy nadzoru nakładają kary, od decyzji CNIL wobec Google i SHEIN po kontrole organów holenderskiego i belgijskiego.
jak to działa
Nuxt zarządza head dokumentu za Ciebie, a to dokładnie tam musi siedzieć runtime zgody. Moduł umieszcza tag w app.head.script z tagPriority: "critical", więc jest renderowany przed chunkiem wejściowym Nuxt na każdej stronie, serwerowej czy statycznej. Bez edycji layoutów, bez wywołań head na każdej stronie.
Pluginy klienckie to zwykłe źródło wczesnych trackerów w Nuxt: plugin gtag, plugin Pixel, moduł firmy trzeciej wstrzykujący własny skrypt. Composable useConsent() daje każdemu z nich isGranted(category) i możliwość subskrypcji zmian, więc plugin może poczekać i zainicjalizować się w chwili nadejścia zgody. Moduły Nuxt firm trzecich wstrzykujące skrypty dostają kategorię na swoim tagu albo ich host jest neutralizowany przez mapę blokowania ze skanu.
Z modułem przychodzą trzy komponenty: ConsentGate dla poddrzew, CookieDeclaration dla strony polityki prywatności i ManageCookiesLink dla stopki. Trasy serwerowe i middleware mogą odczytać cookie zgody tymi samymi helperami, więc strona może wyrenderować placeholder zamiast osadzenia jeszcze przed hydratacją.
konfiguracja
Pięć kroków. CLI wykonuje większość z nich, a każdy to także jedno kliknięcie w panelu.
Wykrywa Nuxt, łączy stronę, zapisuje konfigurację.
npx cookiecrumbs login
npx cookiecrumbs initKlucz strony i środowisko trafiają do nuxt.config.ts.
npm i @cookiecrumbs/nuxt
// nuxt.config.ts
export default defineNuxtConfig({
modules: ['@cookiecrumbs/nuxt'],
cookiecrumbs: { site: 'pk_live_…', env: 'production' },
});useConsent() udostępnia status, consent, regime, country, language, version oraz akcje accept, reject, open i withdraw.
const { isGranted, open } = useConsent();
<ConsentGate category="analytics">
<AnalyticsWidget />
</ConsentGate>Plugin kliencki inicjalizuje tracker tylko wtedy, gdy kategoria zostanie przyznana, i ponownie, jeśli zgoda później się zmieni.
// plugins/pixel.client.ts
export default defineNuxtPlugin(() => {
const { isGranted, onChange } = useConsent();
const start = () => { if (isGranted('marketing')) initPixel(); };
start(); onChange(start);
});Skanuj, przypisz raz na dostawcę, opublikuj.
npx cookiecrumbs scan --wait
npx cookiecrumbs push --env productionSklepy Nuxt korzystające z Google Ads przez plugin gtag dostają wartości domyślne Consent Mode z runtime przed załadowaniem pluginu, więc tag konwersji respektuje wybór bez przepisywania.
Google Consent Mode v2 to warstwa sygnałów między banerem a tagami Google. Zanim uruchomi się jakikolwiek tag, siedem sygnałów (ad_storage, analytics_storage, ad_user_data, ad_personalization, functionality_storage, personalization_storage, security_storage) jest ustawianych na „denied” dla odwiedzających z EOG, Wielkiej Brytanii i Szwajcarii. Gdy tylko ktoś dokona wyboru, runtime je aktualizuje, a tagi Google się dostosowują. Od 15 czerwca 2026 r. Google używa ad_storage jako sygnału decydującego o danych Ads, więc właściwa wartość domyślna liczy się bardziej niż kiedyś.
CookieCrumbs ustawia wartości domyślne synchronicznie, przed jakimkolwiek menedżerem tagów, aktualizuje je przy każdej decyzji i dostarcza szablon Google Tag Manager, dzięki czemu wyzwalacze zgody istnieją bez ręcznie pisanych listenerów. W trybie zaawansowanym bezcookie’owe pingi Google utrzymują modelowane konwersje dla odwiedzających, którzy odmówili. Czego nie robi: nie udaje CMP certyfikowanego przez Google. Do AdSense, Ad Managera lub AdMob w EOG nadal potrzebujesz takiego z IAB TCF, a CookieCrumbs dziś nim nie jest.
uwaga
Każdy z nich pojawia się w pierwszym skanie jako tracker uruchomiony przed zgodą.
przed publikacją
Osiem punktów. Dwa ostatnie panel odhacza na podstawie prawdziwych danych.
type="text/plain" z kategorią, albo host jest w mapie blokowania ze skanu.co dostajesz
Dwie domeny, 100 skanowanych podstron miesięcznie na domenę, wszystkie regulacje, CLI, SDK i serwer MCP.
Każda strona, w każdym stanie zgody, w prawdziwej przeglądarce. Cookies, piksele, iframe’y i klucze storage, wraz ze stroną i skryptem, które je ustawiły. Skanowane ponownie według harmonogramu.
Deklaracja cookies pisze się sama na podstawie wyniku.
Tagi pozostają nieaktywne, dopóki ich kategoria nie zostanie przyznana. „Odrzuć wszystko” jest tak samo widoczne jak „Akceptuj wszystko”. Siedem układów, 25 języków, Consent Mode v2 i właściwa zasada dla każdego regionu.
21 kB, jeden plik, żadnych własnych żądań do firm trzecich.
Każdy wybór jest zapisywany ze znacznikiem czasu, wersją banera i skrótem pokazanych tekstów, powiązany łańcuchowo z poprzednim rekordem. Eksporty są podpisane. Hostowane we Frankfurcie.
Artykuł 7 ust. 1, w darmowym planie.
darmowy test
HTML strony głównej porównany z bazą trackerów. Bez konta, nic nie jest zapisywane. Pełny skan w panelu robi to samo dla każdej strony, w prawdziwej przeglądarce.
pytania
następny krok
Dodaj stronę, uruchom npx cookiecrumbs init w repozytorium Nuxt, a dziennik zgód zaczyna rejestrować w UE.