Przejdź do głównej zawartości

Podstawowe pojęcia

Krótki przewodnik po elementach składowych ConsentForge.

Najemca (Tenant)​

Twoje konto. Wszystko należy do najemcy — użytkownicy, właściwości, dostawcy, rozliczenia. Podczas rejestracji tworzony jest dla Ciebie najemca.

Właściwość (Property)​

Pojedyncza strona internetowa lub aplikacja. Jeden token osadzenia na właściwość. Właściwość posiada:

  • Własną konfigurację banera
  • Własną listę dostawców
  • Własną politykę
  • Własną historię skanowań
  • Własne paragony zgody

Przykład: example.com i shop.example.com mogą być dwiema oddzielnymi właściwościami lub jedną (jeśli korzystają z tego samego tokenu).

Polityka (Policy)​

Zbiór zasad określających, co oznacza zgoda na danej właściwości. Polityka definiuje:

  • Jakie kategorie istnieją (Niezbędne, Analityczne, Marketingowe itp.)
  • Jakie cele są objęte
  • W jakich regionach polityka obowiązuje (UE, USA, Globalnie)
  • Którzy dostawcy należą do poszczególnych kategorii

Polityki są wersjonowane. Każdy paragon zgody odwołuje się do dokładnej wersji polityki obowiązującej w momencie podjęcia decyzji przez użytkownika.

Konfiguracja banera (Banner Config)​

Wizualna i behawioralna konfiguracja banera zgody:

  • Układ (dolny pasek, modal, pływający narożnik)
  • Kolory, czcionki, logo
  • Etykiety przycisków i opisy
  • Struktura centrum preferencji

Dostawca (Vendor)​

Usługa zewnętrzna przetwarzająca dane na Twojej stronie. Google Analytics, Meta Pixel, HubSpot, YouTube — to wszystko dostawcy. ConsentForge utrzymuje bibliotekę ponad 300 wstępnie skonfigurowanych dostawców z wielojęzycznymi opisami.

Odporny na manipulacje zapis pojedynczej decyzji dotyczącej zgody. Zawiera:

  • Znacznik czasu (UTC)
  • Identyfikator agenta użytkownika (zahaszowany)
  • Adres IP (zahaszowany)
  • Dokonane wybory (zaakceptowane/odrzucone dla każdej kategorii)
  • Wersję polityki obowiązującą w momencie podjęcia decyzji
  • Wersję banera obowiązującą w momencie podjęcia decyzji

Paragony są powiązane za pomocą HMAC — możesz zweryfikować, że żaden paragon nie został zmieniony.

Token osadzenia (Embed Token)​

Unikalny identyfikator Twojej właściwości, używany w tagu skryptu. Wygląda następująco: cf_live_abc123xyz...

Nigdy nie ujawniaj klucza API w przeglądarce. Token osadzenia jest bezpieczny do użytku publicznego — jest ograniczony do operacji tylko do odczytu w środowisku uruchomieniowym.

Cel dystrybucji (Distribution Target)​

Miejsce, do którego sygnały zgody są wysyłane po podjęciu decyzji przez użytkownika. Przykłady:

  • Google Tag Manager (przekazanie do dataLayer)
  • Google Consent Mode (aktualizacja zgody gtag)
  • Endpoint webhooka (Twój backend)
  • Meta (Consent API)

Skanowanie / Wynik (Scan / Finding)​

Skanowanie przeszukuje Twoją stronę i wykrywa skrypty i pliki cookie stron trzecich. Każdy wykryty tracker to wynik. Wyniki mogą być przypisywane do dostawców w Twojej polityce.