Przejdź do głównej zawartości

Podstawowe pojęcia

Szybki przewodnik po elementach składowych ConsentForge.

Tenant​

Twoje konto. Wszystko należy do tenanta — użytkownicy, właściwości, dostawcy, rozliczenia. Kiedy się rejestrujesz, tenant jest tworzony dla Ciebie.

Właściwość​

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

  • 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 współdzielą ten sam token).

Polityka​

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

  • Jakie kategorie istnieją (Niezbędne, Analityka, Marketing itd.)
  • Jakie cele są objęte
  • Do jakich regionów polityka ma zastosowanie (UE, USA, Globalne)
  • Którzy dostawcy podlegają każdej kategorii

Polityki mają wersjonowanie. Każdy paragon zgody odwołuje się do dokładnej wersji polityki aktywnej w momencie podjęcia decyzji przez użytkownika.

Konfiguracja banera​

Wizualna i behawioralna konfiguracja Twojego banera zgody:

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

Dostawca​

Usługa strony trzeciej, która przetwarza dane na Twojej stronie. Google Analytics, Meta Pixel, HubSpot, YouTube — to wszystko są dostawcy. ConsentForge utrzymuje bibliotekę 300+ wstępnie skonfigurowanych dostawców z wielojęzycznymi opisami.

Paragon zgody​

Odporny na manipulacje zapis pojedynczej decyzji o zgodzie. Zawiera:

  • Znacznik czasu (UTC)
  • User agent (zahashowany)
  • Adres IP (zahashowany)
  • Dokonane wybory (zaakceptowane/odrzucone według kategorii)
  • Wersja polityki w momencie podjęcia decyzji
  • Wersja banera w momencie podjęcia decyzji

Paragony są połączone łańcuchem HMAC — możesz zweryfikować, że żaden paragon nie został zmieniony.

Token osadzania​

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

Nigdy nie ujawniaj swojego klucza API w przeglądarce. Token osadzania jest bezpieczny do publicznego użytku — jest ograniczony do operacji środowiska uruchomieniowego tylko do odczytu.

Cel dystrybucji​

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

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

Skanowanie / Wynik​

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