WPConsent-Dokumentation

Dokumentation, Referenzmaterialien und Tutorials für WPConsent

Geolokalisierungsregeln einrichten

Möchten Sie Besuchern aus verschiedenen Ländern unterschiedliche Einwilligungsbanner anzeigen? Mit der Geolokalisierungsfunktion von WPConsent können Sie standortbasierte Regeln erstellen, die Ihre Standard-Bannereinstellungen für bestimmte Regionen überschreiben. Diese Anleitung führt Sie durch die Konfiguration von Geolokalisierungsregeln in WPConsent.

Pro-Funktion: Für diese Funktion ist WPConsent Pro erforderlich.

Inhaltsverzeichnis

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:

  • Eine aktive WPConsent Pro-Lizenz
  • Grundlegendes Verständnis von Datenschutzbestimmungen wie DSGVO, CCPA oder LGPD
  • Ihr Einwilligungsbanner, konfiguriert unter WPConsent >> Banner-Design (siehe Anleitung zu den allgemeinen Einstellungen)

Verstehen, wie Geolokalisierung funktioniert

Wenn die Geolokalisierung aktiv ist, folgt WPConsent für jeden neuen Besucher diesem Prozess:

  1. Das Frontend-JavaScript überprüft, ob ein zwischengespeichertes wpconsent_geolocation Keks.
  2. Wenn kein Cookie vorhanden ist, ruft es den REST-API-Endpunkt unter /wp-json/wpconsent/v1/geolocation.
  3. Der Server sucht die IP-Adresse des Besuchers über geo.wpconsent.comDie IP-Adresse wird vor der Abfrage anonymisiert.
  4. Der Server vergleicht das Land und den Bundesstaat/die Provinz des Besuchers mit Ihren konfigurierten Standortgruppen.
  5. Wenn eine Übereinstimmung gefunden wird, gibt der Server die Einstellungen dieser Gruppe zurück. Das Frontend speichert die Antwort im Cache. wpconsent_geolocation Cookie für 30 Tage.
  6. Das Frontend wendet die Einstellungen der übereinstimmenden Gruppe an. Diese überschreiben das Standardverhalten des Banners, einschließlich Einwilligungsmodus, Skriptblockierung, Sichtbarkeit der Schaltflächen, Schaltflächentext, Reihenfolge der Schaltflächen und Banner-Meldung.

Wenn keine Standortgruppe übereinstimmt, greift das System auf Ihre Standard-Plugin-Einstellungen zurück. Das Gleiche gilt, wenn die Geolokalisierung aufgrund eines Netzwerkfehlers oder einer blockierten Anfrage fehlschlägt, sodass Ihre Website immer eine funktionierende Einwilligungserfahrung bietet.

Auf die Geolokalisierungsseite zugreifen

Um zu beginnen, navigieren Sie in Ihrem WordPress-Admin-Menü zu WPConsent >> Geolocation.

Seite mit den Geolokalisierungseinstellungen

Die Seite besteht aus zwei Abschnitten. Im oberen Abschnitt werden vordefinierte Regelvorlagen und eine Schaltfläche für benutzerdefinierte Regeln angezeigt. Darunter sind in einer Tabelle alle vorhandenen Standortgruppen aufgelistet.

Ausgangspunkt wählen

Sie haben zwei Möglichkeiten, Standortregeln zu erstellen.

Verwendung vordefinierter Vorlagen

Klicken Sie auf eine der Vorlagen-Schaltflächen für eine sofortige Einrichtung:

  • DSGVO-Konformität: Gilt für alle europäischen Länder. Stellt den Zustimmungsmodus auf Opt-in ein, aktiviert die Skriptblockierung, zeigt das Banner an und zeigt die Schaltfläche „Einstellungen“ an.
  • CCPA: Zielt auf Kalifornien (US-Bundesstaat) ab. Stellt den Zustimmungsmodus auf „Opt-out” ein, aktiviert die Skriptblockierung, zeigt das Banner an und zeigt die Schaltfläche „Einstellungen” an.
  • LGPD: Zielt auf Brasilien ab. Stellt den Zustimmungsmodus auf Opt-in, aktiviert die Skriptblockierung, zeigt das Banner an und zeigt die Schaltfläche „Einstellungen“ an.

Jede Vorlage erstellt mit einem Klick eine vollständige Standortgruppe. Nach Verwendung einer Vorlage ändert sich die Schaltfläche zu „Hinzugefügt“. Dadurch werden doppelte Regeln für denselben Standort verhindert.

Erstellen einer benutzerdefinierten Regel

Klicken Sie auf „Benutzerdefinierte Regel hinzufügen“, um das Standortgruppen-Modal zu öffnen und eine Regel von Grund auf neu zu erstellen. Verwenden Sie diese Option, wenn Sie bestimmte Länderkombinationen, eine Ausrichtung auf US-Bundesstaaten außerhalb Kaliforniens, eine Ausrichtung auf kanadische Provinzen oder benutzerdefinierte Einwilligungseinstellungen benötigen.

Konfigurieren einer Standortgruppe

Wenn Sie auf „Benutzerdefinierte Regel hinzufügen“ klicken, öffnet sich ein modales Fenster mit dem Konfigurationsformular.

Standortgruppe hinzufügen

Festlegen des Gruppennamens

Geben Sie zunächst einen aussagekräftigen Namen ein, der diese Regel identifiziert. Gute Namen beschreiben den Ort und den Zweck, z. B. „Europäische Union – DSGVO“ oder „Kalifornien + Colorado Datenschutz“.

Standorte auswählen

Der Standortwähler verwendet eine hierarchische Baumstruktur, die nach Kontinenten organisiert ist.

  1. Verwenden Sie das Suchfeld, um Standorte nach Namen zu filtern. Passende Ergebnisse werden automatisch erweitert.
  2. Aktivieren Sie das Kontrollkästchen eines Kontinents, um alle Länder innerhalb dieses Kontinents auszuwählen.
  3. Klicken Sie auf den Pfeil neben einem Kontinent, um ihn zu erweitern und einzelne Länder auszuwählen.
  4. Erweitern Sie „Vereinigte Staaten (US)“, um einzelne US-Bundesstaaten auszuwählen. Durch Aktivieren des Kontrollkästchens „Land: USA“ werden alle Bundesstaaten ausgewählt.
  5. Erweitern Sie Kanada, um einzelne kanadische Provinzen und Territorien auszuwählen. Durch Aktivieren des Kontrollkästchens „Kanada“ werden alle Provinzen ausgewählt.
  6. Verwenden Sie die Schaltflächen „Alle erweitern“, „Alle reduzieren“ und „Alle löschen“, um die Baumstruktur schnell zu verwalten.

Ausgewählte Standorte werden in der Zusammenfassung „Ausgewählte Standorte“ unterhalb der Baumstruktur angezeigt. Um einen Standort zu entfernen, klicken Sie auf das X-Symbol daneben.

Jeder Standort kann nur zu einer Gruppe gehören. Standorte, die bereits einer anderen Gruppe zugewiesen sind, werden mit „(Verwendet)“ gekennzeichnet und sind deaktiviert. Sie müssen zuerst die andere Gruppe löschen, um diesen Standort neu zuzuweisen.

Als Nächstes konfigurieren Sie, wie sich das Banner für Besucher aus diesen Regionen verhält:

  • Skripte vor Zustimmung blockieren: Wenn diese Option aktiviert ist, werden Tracking-Skripte blockiert, bis der Besucher seine Zustimmung erteilt hat. Dies ist für die Einhaltung der DSGVO erforderlich und wird für die LGPD empfohlen.
  • Einwilligungsbanner anzeigen: Schalten Sie das Banner für diese Besucher ein oder aus. Deaktivieren Sie diese Option für Regionen, in denen kein Einwilligungsbanner erforderlich ist.
  • Einstellungen anzeigen-Schaltfläche: Steuert die Sichtbarkeit der schwebenden Einstellungs-Schaltfläche, über die Besucher ihre Einwilligungsoptionen später ändern können.
  • Zustimmungsmodus: Wählen Sie zwischen:

Opt-in (Benutzer muss aktiv zustimmen): Skripte werden standardmäßig blockiert. Der Besucher muss auf „Akzeptieren“ klicken, bevor nicht essentielle Cookies gesetzt werden. Erforderlich gemäß DSGVO und LGPD. – Opt-out (Zustimmung wird vorausgesetzt, sofern nicht abgelehnt): Skripte werden standardmäßig ausgeführt. Der Besucher kann auf „Ablehnen“ klicken, um seine Zustimmung zu widerrufen. Wird für die Einhaltung der CCPA verwendet.

Anpassen des Banner-Inhalts

In zwei optionalen Abschnitten können Sie Bannerelemente für diese Standortgruppe überschreiben. Beide sind standardmäßig ausgeblendet.

Anpassen von Banner-Schaltflächen

Um die Schaltflächen anzupassen, aktivieren Sie die Option „Banner-Schaltflächen anpassen “. Dadurch werden die Konfigurationsoptionen für die Schaltflächen angezeigt.

Konfiguration der Banner-Schaltfläche

Für jede Schaltfläche (Akzeptieren, Ablehnen, Einstellungen) können Sie:

  • Bearbeiten Sie den Text der Schaltfläche, um eine standortgerechte Formulierung anzuzeigen.
  • Schalten Sie die Taste mit dem Status-Schalter ein oder aus.
  • Ziehen Sie die Schaltflächen mithilfe des Griffs, um sie neu anzuordnen.

Wenn Sie mehrsprachige Übersetzungen konfiguriert haben, überschreibt der hier festgelegte Schaltflächentext diese Übersetzungen für Besucher, die dieser Standortgruppe entsprechen.

Anpassen der Banner-Meldung

Um eine benutzerdefinierte Nachricht zu verwenden, aktivieren Sie die Option „Bannernachricht anpassen “. Geben Sie dann eine benutzerdefinierte Nachricht für diese Standortgruppe ein. Lassen Sie das Textfeld leer, um Ihre Standard-Bannernachricht zu verwenden.

Wie der Text der Schaltfläche „Gefällt mir“ überschreibt auch eine benutzerdefinierte Banner-Meldung hier alle mehrsprachigen Übersetzungen für Besucher, die dieser Gruppe entsprechen.

Speichern und Verwalten von Standortgruppen

Nachdem Sie Ihre Einstellungen konfiguriert haben, klicken Sie auf „Standortgruppe speichern“. Die Seite wird neu geladen und Ihre neue Regel wird in der Tabelle „Standortgruppen“ angezeigt.

Die Tabelle zeigt diese Spalten für jede Gruppe an:

SpalteBeschreibung
NameDer von Ihnen eingegebene Gruppenname
StandorteDurch Kommas getrennte Liste ausgewählter Standorte
Art der EinwilligungDSGVO, CCPA, LGPD oder benutzerdefiniert
Einstellungen für die EinwilligungHäkchen, die den Status von „Skript blockieren“, „Banner anzeigen“ und „Einstellungen-Schaltfläche anzeigen“ anzeigen
EinwilligungsmodusAnmelden oder Abmelden
AktionSchaltflächen „Bearbeiten“ und „Löschen“

Um eine bestehende Gruppe zu bearbeiten, klicken Sie auf das Bearbeitungssymbol, um das Modalfenster mit den geladenen Einstellungen erneut zu öffnen. Um eine Gruppe zu entfernen, klicken Sie auf das Löschsymbol und bestätigen Sie den Löschvorgang.

Hinzufügen zusätzlicher Regeln

Wiederholen Sie die oben genannten Schritte, um weitere Standortgruppen hinzuzufügen. Jede Gruppe muss eindeutige Standorte verwenden. Das System verhindert, dass Sie dasselbe Land, denselben Bundesstaat oder dieselbe Provinz mehreren Gruppen zuweisen.

Wenn der Standort eines Besuchers mit einer Gruppe übereinstimmt, wird die erste übereinstimmende Gruppe wirksam. Es werden keine weiteren Gruppen überprüft.

Das Banner standardmäßig ausblenden

Ein gängiges Muster besteht darin, das Einwilligungsbanner global auszublenden und es nur in regulierten Regionen anzuzeigen. So richten Sie dies ein:

  1. Gehen Sie zu WPConsent >> Einstellungen und deaktivieren Sie das Einwilligungsbanner.
  2. Gehen Sie zu WPConsent >> Geolocation und erstellen Sie Standortgruppen für regulierte Regionen, wobei „Show Consent Banner“ aktiviert ist.

Das Geolokalisierungssystem erzwingt das Laden des Banners im Frontend, sobald mindestens eine Standortgruppe die Option „Einwilligungsbanner anzeigen“ aktiviert hat, selbst wenn die Haupteinstellung für das Banner deaktiviert ist. Das Frontend nutzt dann die Geolokalisierung, um zu entscheiden, ob das Banner jedem Besucher angezeigt wird.

Dieser Ansatz bedeutet, dass Besucher außerhalb Ihrer Standortgruppen überhaupt kein Banner sehen. Besucher innerhalb Ihrer Gruppen sehen die entsprechende Einwilligungserklärung.

Geolocation-Caching verstehen

WPConsent speichert Geolokalisierungsergebnisse in einem Browser-Cookie namens wpconsent_geolocationDieses Cookie speichert die Einstellungen der übereinstimmenden Gruppe als JSON und läuft nach 30 Tagen ab.

Caching reduziert die Serverlast, indem wiederholte API-Aufrufe für wiederkehrende Besucher vermieden werden. Der REST-Endpunkt unter geo.wpconsent.com wird nur einmal pro Besucher aufgerufen, wenn keine zwischengespeicherten Daten vorhanden sind oder das Cookie abgelaufen ist.

Wenn Sie die Einstellungen einer Standortgruppe ändern, sehen bestehende Besucher mit einem zwischengespeicherten Cookie weiterhin die alten Einstellungen, bis ihr Cookie abläuft. Sie können den Benutzern empfehlen, ihre Cookies zu löschen, oder sie erhalten die aktualisierten Einstellungen automatisch innerhalb von 30 Tagen.

WPConsent fügt automatisch das wpconsent_geolocation Cookie zu Ihrer Kategorie „Essential Cookies“, wenn Sie Ihre erste Standortgruppe erstellen.

Häufige Anwendungsfälle

Nur für die EU geltende Konformität

Verwenden Sie die DSGVO-Vorlage, um nur europäischen Besuchern ein Opt-in-Einwilligungsbanner anzuzeigen. Deaktivieren Sie anschließend das Banner in WPConsent >> Einstellungen, damit Besucher außerhalb Europas überhaupt kein Banner sehen.

Kalifornischer CCPA

Verwenden Sie die CCPA-Vorlage für Einwohner Kaliforniens. Der Opt-out-Modus erlaubt Cookies standardmäßig, bis Nutzer sie aktiv ablehnen. Dies entspricht den Anforderungen des CCPA.

Brasilien LGPD

Verwenden Sie die LGPD-Vorlage, um von brasilianischen Besuchern eine ausdrückliche Zustimmung einzuholen, bevor Sie nicht essentielle Cookies setzen. Die LGPD verlangt eine Opt-in-Zustimmung, ähnlich wie die DSGVO.

Mehrere Regionen mit unterschiedlichen Regeln

Erstellen Sie separate Gruppen für jedes Regelwerk. Fügen Sie beispielsweise eine DSGVO-Regel für Europa (Opt-in), eine CCPA-Regel für Kalifornien (Opt-out) und eine benutzerdefinierte Regel für Quebec, Kanada (Opt-in) hinzu, um das Gesetz 25 von Quebec einzuhalten.

Kanadische Provinzebene

Erweitern Sie Kanada in der Standortauswahl, um bestimmte Provinzen anzusprechen. Auf diese Weise können Sie strengere Regeln für Provinzen wie Quebec anwenden, während Sie für andere kanadische Provinzen weniger strenge Regeln verwenden.

Regionsspezifischer Bannertext

Verwenden Sie die Schaltfläche und die Nachrichtenanpassung, um eine für die Region geeignete Sprache anzuzeigen. Für Besucher aus Kalifornien können Sie den Text der Ablehnungsschaltfläche in „Meine Daten nicht verkaufen“ ändern und eine Banner-Meldung verwenden, die auf die Rechte gemäß CCPA verweist.

Überprüfen Ihrer Einrichtung

Testen Sie Ihre Geolokalisierungsregeln, um sicherzustellen, dass sie korrekt funktionieren.

  1. Besuchen Sie Ihre Website von einem Standort aus, der in einer Regel enthalten ist, oder verwenden Sie ein VPN, um einen anderen Standort zu simulieren.
  2. Überprüfen Sie, ob das Banner gemäß Ihren Regeleinstellungen angezeigt oder ausgeblendet wird.
  3. Überprüfen Sie, ob der Zustimmungsmodus (Opt-in oder Opt-out) mit Ihrer Konfiguration übereinstimmt.
  4. Wenn Sie Schaltflächen angepasst haben, überprüfen Sie, ob der Text und die Reihenfolge korrekt sind.
  5. Überprüfen Sie die Browser-Cookies, um die wpconsent_geolocation Cookie mit den übereinstimmenden Gruppendaten.
  6. Löschen Sie die wpconsent_geolocation Cookie und neu laden, um eine neue Suche auszulösen.

Um ohne VPN zu testen, fügen Sie Ihren aktuellen Standort vorübergehend zu einer Regel hinzu. Denken Sie daran, ihn nach dem Testen wieder zu entfernen.

Fehlersuche

Banner zeigt falsche Einstellungen für einen Standort an

Überprüfen Sie, ob Regelkonflikte vorliegen. Jeder Standort kann nur in einer Gruppe vorhanden sein, wobei die erste übereinstimmende Gruppe Vorrang hat. Überprüfen Sie, ob der Zustimmungsmodus und die Einstellungen Ihrer Regel Ihren Erwartungen entsprechen. Bearbeiten oder löschen Sie anschließend widersprüchliche Regeln aus der Standortgruppentabelle.

Standortbestimmung fehlgeschlagen

Der Geolokalisierungsdienst erfordert ausgehenden HTTP-Zugriff auf geo.wpconsent.comÜberprüfen Sie die Firewall-Regeln Ihres Servers oder wenden Sie sich an Ihren Hosting-Anbieter, wenn Anfragen blockiert werden. Wenn die Erkennung fehlschlägt, greift das System auf Ihre Standardeinstellungen zurück.

Änderungen sind nach dem Speichern nicht sichtbar

Löschen Sie die wpconsent_geolocation Cookie in Ihrem Browser. Dieses Cookie speichert Standortdaten für 30 Tage. Wiederkehrende Besucher sehen weiterhin die alten Einstellungen, bis ihr Cookie abläuft oder gelöscht wird.

Skriptblockierung funktioniert nicht für eine Standortgruppe

Überprüfen Sie, ob „Skripte vor Zustimmung blockieren“ in den Standortgruppeneinstellungen aktiviert ist. Vergewissern Sie sich außerdem, dass Sie Skripte oder Dienste für die Blockierung in WPConsent >> Inhalt konfiguriert haben. Die Standortgruppe steuert, ob die Blockierung aktiv ist, aber Sie benötigen dennoch Inhalte, die blockiert werden sollen.

Banner wird allen Besuchern angezeigt, nicht nur Besuchern aus bestimmten Regionen.

Stellen Sie sicher, dass Sie das Einwilligungsbanner in WPConsent >> Einstellungen für die Standardeinstellungen deaktiviert haben. Das Geolokalisierungssystem überschreibt die Standardeinstellung, nicht umgekehrt. Wenn das Standardbanner aktiviert ist, sehen es alle Besucher unabhängig von den Standortregeln.

Häufig gestellte Fragen

Kann ich denselben Standort mehreren Gruppen zuweisen?

Nein. Jeder Standort (Land, Bundesstaat oder Provinz) kann jeweils nur einer Gruppe angehören. Standorte, die bereits einer Gruppe zugewiesen sind, werden mit „(Verwendet)“ gekennzeichnet und sind in der Standortauswahl deaktiviert. Um einen Standort neu zuzuweisen, löschen Sie zunächst die Gruppe, zu der er gehört.

Was passiert, wenn der Standort meines Besuchers keiner Gruppe zugeordnet werden kann?

WPConsent greift auf Ihre Standard-Plugin-Einstellungen zurück. Das Banner, der Zustimmungsmodus und die Skriptblockierung richten sich nach Ihren Konfigurationen unter WPConsent >> Einstellungen.

Wie kann ich das Banner nur in bestimmten Ländern anzeigen?

Deaktivieren Sie zunächst das Einwilligungsbanner unter WPConsent >> Einstellungen. Erstellen Sie dann Geolokalisierungsgruppen für die Länder, in denen das Banner angezeigt werden soll, und aktivieren Sie dabei die Option „Einwilligungsbanner anzeigen “. Besucher außerhalb dieser Gruppen sehen kein Banner.

Wie oft überprüft WPConsent den Standort eines Besuchers?

WPConsent überprüft einmal pro Besucher und speichert das Ergebnis im Cache. wpconsent_geolocation Cookie für 30 Tage. Nach Ablauf des Cookies löst das nächste Laden der Seite eine neue Suche aus.

Werden meine Änderungen sofort für alle Besucher wirksam?

Nein. Wiederkehrende Besucher, die bereits einen Cache haben wpconsent_geolocation Cookies zeigen weiterhin die alten Einstellungen an, bis ihr Cookie abläuft (bis zu 30 Tage). Neue Besucher und Besucher mit abgelaufenen Cookies sehen Ihre aktualisierten Einstellungen sofort.

Schlussfolgerung

Geolokalisierungsregeln ermöglichen Ihnen eine präzise Steuerung des Verhaltens Ihres Einwilligungsbanners für Besucher aus verschiedenen Regionen. Durch die Kombination vordefinierter Vorlagen mit benutzerdefinierten Regeln können Sie GDPR, CCPA, LGPD und andere Datenschutzbestimmungen mit einer einzigen WordPress-Installation einhalten.

Weitere Informationen zu den CCPA-spezifischen Compliance-Funktionen finden Sie im Leitfaden zum Einrichten von „Nicht verkaufen“. Sie können auch Ihre Einwilligungsprotokolle überprüfen, um zu verfolgen, wie Besucher aus verschiedenen Regionen mit Ihrem Banner interagieren.

War dieser Artikel hilfreich?

Verwandte Artikel