zgoda na cookies dla SvelteKit
cookiecrumbsHandle wstawia tag jako pierwszy element head każdej odpowiedzi HTML i ustawia event.locals.consent dla Twoich funkcji load.
zasada
Aplikacja SvelteKit ładuje trackery z +layout.svelte po stronie klienta. Bez kroku zgody, bez zapisu.
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
SvelteKit renderuje HTML przez hooks.server.ts i to najczystsze miejsce na runtime zgody: handle, który przekształca każdą odpowiedź HTML i zapisuje tag jako pierwszy w head, niezależnie od tego, co robi strona czy layout. Połącz go z innymi hookami przez sequence(); umieść %cookiecrumbs.head% w app.html, jeśli chcesz sam wybrać dokładną pozycję.
Ten sam hook ustawia event.locals.consent, więc funkcja load w +page.server.ts może po stronie serwera zdecydować, czy dołączyć osadzenie, czy jego placeholder. Po stronie klienta store’y zgody utrzymują każdy komponent w rytmie: $consent dla kategorii, $regime dla obowiązującej reguły i akcje do otwierania, akceptacji, odmowy lub wycofania.
onMount w SvelteKit to miejsce, gdzie zwykle startują trackery. Opakuj poddrzewo w ConsentGate albo sprawdź store przed inicjalizacją. Wszystko, co skan znajdzie na wdrożonej domenie bez tagu, obsługuje mapa blokowania, więc zapomniany skrypt w starym layoucie i tak czeka.
konfiguracja
Pięć kroków. CLI wykonuje większość z nich, a każdy to także jedno kliknięcie w panelu.
Wykrywa SvelteKit, łączy stronę, zapisuje konfigurację.
npx cookiecrumbs login
npx cookiecrumbs initPołącz go z innymi hookami przez sequence(). Umieść %cookiecrumbs.head% w src/app.html, aby samodzielnie wybrać dokładną pozycję.
npm i @cookiecrumbs/sveltekit
// src/hooks.server.ts
import { cookiecrumbsHandle } from '@cookiecrumbs/sveltekit/server';
export const handle = cookiecrumbsHandle({ site: 'pk_live_…', env: 'production' });Komponenty Svelte ConsentGate, CookieDeclaration i ManageCookiesLink oraz store’y zgody są w pakiecie.
<script>
import { ConsentGate } from '@cookiecrumbs/sveltekit';
</script>
<ConsentGate category="marketing">
<MetaPixel />
</ConsentGate>Funkcja load może odczytać zgodę i pominąć osadzenie dla odwiedzających, którzy odmówili, zanim uruchomi się jakikolwiek kod kliencki.
// +page.server.ts
export const load = ({ locals }) => ({
showMap: locals.consent?.isGranted('marketing') ?? false,
});Skanuj, przypisz raz na dostawcę, opublikuj.
npx cookiecrumbs scan --wait
npx cookiecrumbs push --env productionAplikacje SvelteKit z Google Ads zwykle dodają gtag w app.html. Poniżej runtime ładuje się z wartościami domyślnymi „denied” i aktualizuje w chwili wyboru.
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 SvelteKit, a dziennik zgód zaczyna rejestrować w UE.