Dokumentationsmenu

Global Privacy Control

Privatlivssignaler i CookieHug: Global Privacy Control (GPC), DNT og US Privacy-adapteren (USP) — tilstande, brugerens tilsidesættelse, besked og hændelser.

Global Privacy Control (Sprint 1)

CookieHug tjekker navigator.globalPrivacyControl === true på hver side og reagerer ud fra bannerConfig.gpc.mode.

GPC-tilstande

Tilstand	Adfærd
`auto_deny_toaster` (anbefalet)	Afviser automatisk alle ikke-nødvendige kategorier, skjuler banneret og viser en lille besked, hvor valget kan ændres.
`auto_deny_silent`	Samme automatiske afvisning, uden besked.
`preselect_off_banner`	Banneret vises med alle ikke-nødvendige kontakter slået fra som standard.
`ignore`	GPC læses kun til analyse; samtykkestatus påvirkes ikke.

Brugerens tilsidesættelse

Når gpc.allowUserOverride er true (standard), indeholder beskeden knappen «Justér», som åbner det fulde banner igen. Den valgte tilstand gemmes som method="gpc_override".

Beskedens udseende

bannerConfig.gpc.visual styrer beskeden (variant/placering/farver/ikon/animation/knapper/adfærd). Beskeden gengives i en Shadow DOM for at isolere styles og respekterer prefers-reduced-motion.

Hændelser

Hændelse	Detalje
`CookieHugOnGpcDetected`	`{ mode, autoDenied, userOverrideAvailable }`
`CookieHugOnGpcToasterShown`	`{ mode }`
`CookieHugOnGpcToasterDismissed`	`{ reason: 'user' \\| 'auto' }`
`CookieHugOnGpcOverrideRequested`	`{}` — udløses, før banneret åbnes igen. Et sessionsflag sikrer, at næste `setConsent` registreres som `method="gpc_override"`.
`CookieHugOnDntDetected`	`{ autoDenied: false, userOverrideAvailable: true }` — udsendes, når `respectDnt=true`, og den besøgendes browser sender `DNT: 1` (og GPC ikke allerede har haft forrang).

Do Not Track

Når respectDnt er slået til, og navigator.doNotTrack === '1', udløser politikmotoren en blød forudvalgt fra: banneret vises normalt, men alle ikke-nødvendige afkrydsningsfelter starter uden markering. Brugeren kan stadig give udtrykkeligt samtykke. GPC vinder altid over DNT (rækkefølge: GPC > DNT > normalt forløb). Slås respectDnt fra, forbliver doNotTrack udelukkende et telemetrisignal i hændelsesdata og i samtykkecookien.

Hvad CookieHug IKKE gør

Den ændrer ikke Privacy Sandbox-API'er. accounts.google.com/gsi/, FedCM, Topics API, Attribution Reporting og Private State Tokens er udtrykkeligt undtaget fra scriptblokeringen.
Den gemmer hverken den besøgendes IP-adresse eller placering; region afgøres flygtigt pr. forespørgsel.

Samtykkecookie v2

Når afgørelsen ikke er triviel, opgraderes CookieHugConsent til v2 med ekstra felter:

{
  "v": 2,
  "necessary": true,
  "preferences": true,
  "statistics": true,
  "marketing": false,
  "stamp": 1712345678901,
  "method": "gpc_auto_deny",
  "region": "US-CA",
  "signals": {
    "ad_storage": "denied",
    "ad_user_data": "denied",
    "ad_personalization": "denied",
    "analytics_storage": "granted"
  }
}

Læseren er bagudkompatibel med v1 (manglende felter behandles som standardværdier). method udvides til: explicit, gpc_auto_deny, gpc_override, migrated_v1, notice_only.

US Privacy-adapter (USP / CCPA)

En valgfri adapter pr. domæne til IAB's US Privacy API v1 — slå den til under Domæne → Avanceret → Samtykkepolitik → US Privacy (USP). Når den er aktiv, registrerer SDK'et window.__uspapi (kun hvis siden ikke allerede leverer et), så annoncepartnere kan læse CCPA/CPRA-«usp-strengen»:

window.__uspapi('getUSPData', 1, function (data, success) {
  // data.uspString — f.eks. "1YNN"
});

Strengen udledes af den besøgendes valg i banneret: position 2 (information) bliver Y, så snart den besøgende har svaret på banneret, position 3 (fravalg af salg) er Y, når kategorien Markedsføring blev afvist, og N, når den blev accepteret, mens position 4 (LSPA) altid er N. Før enhver beslutning returnerer adapteren 1N-N. Efter hver beslutning (accept, afvisning, tilbagetrækning, gendannelse ved et senere besøg) udsendes en CustomEvent uspChange med detail.uspString på window.