Dokumentationsmenü
Regionale Regeln (Geo-IP)
Das Einwilligungsmodell nach dem Standort des Besuchers: Regionen EWR/UK/CH/USA/Kalifornien/Brasilien, Geo-Quelle, Caching und Fallbacks.
Regionale Regeln (Geo-IP)
Statt eines einzigen Einwilligungsmodells für die ganze Welt können Sie das Modell an den Standort des Besuchers anpassen: Opt-in, wo das Gesetz es verlangt (der EWR), und Opt-out oder Notice-only, wo es zulässig ist (z. B. Teile der USA). Die Funktion ist standardmäßig deaktiviert — ohne sie gilt das eine für die Domain konfigurierte Modell.
Regionen und Auflösungsreihenfolge
| Region | Umfasst | Fallback ohne eigene Regel |
|---|---|---|
| EWR | 27 EU-Staaten + Norwegen, Island, Liechtenstein | Rest der Welt → Domain-Modell |
| Vereinigtes Königreich | GB | EWR-Regel → Rest der Welt → Domain-Modell |
| Schweiz | CH | EWR-Regel → Rest der Welt → Domain-Modell |
| USA (außer Kalifornien) | US ohne CA | Rest der Welt → Domain-Modell |
| USA — Kalifornien | US, Bundesstaat CA | US-Regel → Rest der Welt → Domain-Modell |
| Brasilien | BR (LGPD) | Rest der Welt → Domain-Modell |
| Rest der Welt | alle übrigen Länder | Domain-Modell |
Für jede Region wählen Sie Opt-in, Opt-out oder Notice-only — oder Sie belassen es beim „Domain-Modell“. Das gewählte Modell verhält sich exakt wie das globale: Es bestimmt den Ausgangszustand der Kategorieschalter und das Verhalten des Banners.
Woher das Banner den Standort kennt
Sind die Regeln aktiviert, fragt das SDK einmal täglich den Endpunkt /api/geo ab; dieser liest Land (und US-Bundesstaat) auf CookieHug-Serverseite aus den Netzwerk-Headern des CDN. Die IP-Adresse des Besuchers wird nie gespeichert — die Antwort enthält nur einen Länder- und Regionscode und wird 24 Stunden im Browser des Besuchers zwischengespeichert.
Absicherungen:
- Ein hartes Timeout von 800 ms — antwortet die Geo-Abfrage nicht rechtzeitig, startet das Banner ohne Verzögerung.
- Ist die Geo-Abfrage nicht verfügbar, nutzt das SDK die Zeitzone des Browsers als Näherung (EWR / Kalifornien / Brasilien).
- Lässt sich der Standort gar nicht bestimmen, gilt das Domain-Modell (sicherer Fallback).
- Domains mit deaktivierter Funktion senden keinerlei zusätzliche Anfrage.
Aktivierung
- Dashboard → Domain → Erweitert → Einwilligungsrichtlinie → Karte Regionale Regeln (Geo-IP).
- Legen Sie den Schalter um und weisen Sie den benötigten Regionen Modelle zu; den Rest lassen Sie auf „Domain-Modell“.
- Gespeichert wird automatisch; das Banner-Skript aktualisiert sich innerhalb von ca. 5 Minuten.
Und was ist mit Google Consent Mode?
Regionale Regeln steuern das Einwilligungsmodell des Banners. Die Signale des Google Consent Mode starten weiterhin konservativ auf denied und ändern sich erst nach der Entscheidung des Besuchers — regionale GCM-Standardwerte sind eine eigene Konfiguration im Google-Bereich (Consent Mode v2). Mit aktivierter Geo-Erkennung enthält das Objekt `CookieHug.regulations` genauere Werte (gdprApplies, ccpaApplies, region).