← Wszystkie wpisy
zgoda na pliki cookie3 mar 20263 min czytania

Zgoda na pliki cookie w trybie headless: jak zacząć

Zgoda na pliki cookie w trybie headless to logika zgody bez gotowego banera: małe API blokuje pliki cookie i zapisuje wybory, a interfejs budujesz samodzielnie.

Zespół Katli

Banery zgody na pliki cookie są wszędzie, ale większość z nich wyrządza więcej szkody niż pożytku. Blokują renderowanie, psują Core Web Vitals i ładują setki kilobajtów JavaScriptu, zanim Twoi użytkownicy w ogóle zobaczą treść.

Jest lepszy sposób: zgoda na pliki cookie w trybie headless.

Czym jest zgoda na pliki cookie w trybie headless?

Tradycyjne narzędzia do zgody na pliki cookie dostarczają gotowy widget z interfejsem, który sam wstrzykuje się na stronę. Masz ograniczoną kontrolę nad wyglądem, położeniem i zachowaniem, a płaci za to wydajność.

Podejście headless oddziela logikę zgody od warstwy prezentacji. Dostajesz lekkie API, które zajmuje się:

  • Skanowaniem i klasyfikacją plików cookie
  • Zarządzaniem stanem zgody
  • Prowadzeniem dokumentacji na potrzeby zgodności z przepisami
  • Mapowaniem wymogów prawnych (opt-in według RODO, opt-out według CCPA/CPRA, wzmocniona zgoda według DMA)

A interfejs? Ten należy w całości do Ciebie: budujesz go we własnym frameworku, z własnym design systemem i w ramach własnego budżetu wydajności.

Dlaczego wydajność ma znaczenie przy zgodzie

Core Web Vitals od Google to czynnik rankingowy. Każdy zewnętrzny skrypt, który ładujesz, konkuruje o główny wątek. Tradycyjne menedżery zgód często dodają 200-500 ms do Largest Contentful Paint (LCP), ponieważ:

  1. Ładują blokujący pakiet JavaScriptu
  2. Pobierają konfigurację ze zdalnego serwera
  3. Renderują nakładkę mocno obciążającą DOM
  4. Czekają na interakcję użytkownika, zanim wypuszczą inne skrypty

W podejściu headless wywołanie API zgody odbywa się asynchronicznie, a strona renderuje się normalnie. Nie ma nakładki blokującej renderowanie ani przesunięcia układu przez wstrzyknięty baner.

Jak robi to Katla

Katla udostępnia REST API i lekkie SDK w JavaScripcie, które dają Ci pełną kontrolę:

import { KatlaConsent } from "@katla/widget";
 
const consent = new KatlaConsent({ siteId: "your-site-id" });
 
// Check current consent state
const state = await consent.getState();
 
// Present your own UI, then record the decision
await consent.grant(["functional", "analytics"]);

Twój baner, Twoje zasady. Katla zajmuje się warstwą zgodności z przepisami: automatycznym skanowaniem plików cookie, potwierdzeniami zgody i panelem dla Twojego działu prawnego.

Pierwsze kroki

Wskazówka

Katla może działać na Twojej stronie w mniej niż 10 minut. Bez żadnej migracji: zacznij od darmowego skanowania plików cookie, które już masz.

  1. Zarejestruj się na katla.app i utwórz pierwszą stronę
  2. Uruchom skanowanie: Katla automatycznie wykrywa i klasyfikuje każdy plik cookie
  3. Zainstaluj SDK: jeden tag script albo pakiet npm
  4. Zbuduj interfejs: użyj własnych komponentów albo zacznij od naszych przykładów
  5. Uruchom na produkcji: zapisy zgód są przechowywane i dostępne na potrzeby audytów

A co z plikami cookie, które już masz?

Skaner Katli oparty na AI rozpoznaje pliki cookie znanych usług zewnętrznych i automatycznie je klasyfikuje. Nieznane pliki cookie są oznaczane do ręcznego przeglądu, więc w kwestii zgodności z przepisami nigdy nie działasz na ślepo.

Informacja

Skaner Katli korzysta z przeglądarki headless, by wykrywać pliki cookie ustawiane przez JavaScript, a nie tylko przez nagłówki odpowiedzi HTTP. Dzięki temu wyłapuje piksele analityczne, trackery reklamowe i mechanizmy sesji, które inne narzędzia przeoczają.

Podsumowanie

Jeśli zależy Ci na wydajności i zgodności z przepisami, zgoda na pliki cookie w trybie headless nie jest opcją, tylko nowoczesnym standardem. Oddziel logikę zgody od interfejsu, utrzymaj lekki bundle i pozwól swojemu działowi prawnemu spać spokojnie.

Chcesz spróbować? Zacznij za darmo.