WPConsent Dokumentation

Dokumentation, Referenzmaterialien und Tutorials für WPConsent

Einwilligungsprotokolle / Einwilligungsnachweise

Müssen Sie nachweisen, dass Ihre Besucher tatsächlich zugestimmt haben, bevor Sie deren Daten verarbeitet haben? Die Zustimmungs-Protokolle von WPConsent zeichnen jede Banner-Interaktion automatisch auf und speichern, wer zugestimmt hat, wozu und wann. Diese Anleitung führt Sie durch die Aktivierung, Anzeige, Filterung, den Export und die Bereinigung von Zustimmungs-Protokollen.

Pro-Funktion: Diese Funktion erfordert WPConsent Pro.

Inhaltsverzeichnis

Voraussetzungen

  • WPConsent Pro installiert und aktiviert
  • Ein konfiguriertes Zustimmungs-Banner, das auf Ihrer Website angezeigt wird

WPConsent zeichnet standardmäßig keine Zustimmungs-Interaktionen auf. Sie müssen die Funktion zuerst aktivieren.

  1. Navigieren Sie zu WPConsent >> Einstellungen.
  2. Der Standard-Tab Einstellungen wird automatisch geladen.
  3. Scrollen Sie zum Schalter Zustimmungs-Protokolle.
  4. Aktivieren Sie Aufzeichnungen der Zustimmung für alle Besucher, die zustimmen, aktivieren.
  5. Klicken Sie auf Speichern.

Nach der Aktivierung registriert WPConsent einen REST-API-Endpunkt unter /wp-json/wpconsent/v1/log-consent. Das Frontend-Banner sendet jedes Mal eine POST-Anfrage an diesen Endpunkt, wenn ein Besucher seine Zustimmungs-Auswahl speichert.

Verständnis dessen, was erfasst wird

Jeder Protokoll-Eintrag wird in der Datenbanktabelle wpconsent_consent_logs gespeichert. Hier ist, was WPConsent aufzeichnet:

FeldBeschreibung
BenutzerWordPress-Benutzer-ID für angemeldete Besucher oder 0 für Gäste
IP-AdresseAnonymisierte Besucher-IP-Adresse (siehe unten)
Ländercode2-stelliger Ländercode aus Geolocation-Lookup oder XX, falls nicht verfügbar
Zustimmungs-DatenJSON-Objekt mit jeder Cookie-Kategorie und jedem Dienst, eingestellt auf akzeptiert oder abgelehnt
ZeitstempelDatum und Uhrzeit der Zustimmungs-Interaktion (gespeichert in lokalen und UTC-Formaten)

IP-Anonymisierung

WPConsent anonymisiert IP-Adressen, bevor es sie speichert. Keine vollständige IP-Adresse wird jemals in die Datenbank geschrieben.

  • IPv4: Das letzte Oktett wird durch 000 ersetzt. Zum Beispiel wird aus 192.168.1.45 192.168.1.000.
  • IPv6: Die letzten 5 Gruppen (Positionen 3 bis 7) werden durch 0000 ersetzt. Zum Beispiel wird 2001:0db8:85a3:0000:0000:8a2e:0370:7334 zu 2001:0db8:85a3:0000:0000:0000:0000:0000.

Dieser Ansatz bewahrt genügend Informationen für die regionale Analyse und schützt gleichzeitig die Privatsphäre des Einzelnen.

Um alle aufgezeichneten Einwilligungsinteraktionen zu überprüfen, navigieren Sie zu WPConsent >> Consent Logs. Stellen Sie sicher, dass der Tab Consent Logs ausgewählt ist.

Seite mit Zustimmungs-Protokollen, die aufgezeichnete Zustimmungs-Interaktionen anzeigt

Die Tabelle zeigt 20 Einträge pro Seite mit 4 Spalten:

  • Benutzer: Der WordPress-Benutzername oder „Gast“ für Besucher, die nicht angemeldet waren.
  • IP-Adresse: Die anonymisierte IP mit einem Länderflaggen-Symbol (sofern Geodaten verfügbar sind).
  • Einwilligungsdetails: Eine Zusammenfassung der Entscheidungen auf Kategorieebene (Essentiell, Statistik, Marketing), angezeigt als Akzeptiert oder Abgelehnt. Wenn der Besucher GPC (Global Privacy Control) aktiviert hatte, wird auch dieser Status angezeigt. Klicken Sie auf Dienste anzeigen, um einzelne Entscheidungen auf Dienstebene zu erweitern.
  • Datum: Formatiert gemäß Ihren WordPress-Datums- und Zeiteinstellungen.

Filtern und Suchen von Protokollen

WPConsent bietet integrierte Werkzeuge, um bestimmte Einträge schnell zu finden.

Zustimmungs-Protokoll-Einträge filtern und durchsuchen

Filtern nach Datumsbereich

  1. Klicken Sie auf das Eingabefeld Nach Datumsbereich filtern über der Tabelle.
  2. Wählen Sie ein Start- und Enddatum mit dem Datumsgenerator aus.
  3. Klicken Sie auf Filtern, um die Anwendung zu starten.

Um den Filter zu entfernen, klicken Sie auf Löschen.

Suche nach IP-Adresse

  1. Geben Sie eine vollständige oder teilweise IP-Adresse in das Feld IP-Suche ein.
  2. Klicken Sie auf Logs durchsuchen.

Die Suche unterstützt Teilübereinstimmungen:

  • Eine vollständige IPv4 wie 192.168.1.100 stimmt mit dieser spezifischen anonymisierten Adresse überein.
  • Eine teilweise IPv4 wie 192.168 ersetzt automatisch die verbleibenden Oktette durch Wildcards.
  • Eine teilweise IPv6 wie 2001:db8 ersetzt automatisch die verbleibenden Gruppen durch Wildcards.

Da IP-Adressen bei der Speicherung anonymisiert werden, ist das letzte Oktett einer IPv4-Adresse immer 000. Beachten Sie dies bei der Suche.

Exportieren von Protokollen nach CSV

Sie können Einwilligungsdatensätze für Compliance-Berichte, rechtliche Anfragen oder externe Analysen exportieren.

  1. Navigieren Sie zu WPConsent >> Consent Logs.
  2. Wählen Sie den Tab Export.
  3. Legen Sie ein Von-Datum und ein Bis-Datum für den Bereich fest, den Sie exportieren möchten.
  4. Klicken Sie auf Exportieren.

Zustimmungs-Protokolle in CSV exportieren

Der Export verarbeitet Datensätze in Stapeln von 1.000, um große Datensätze ohne Zeitüberschreitung zu verarbeiten. Ein Fortschrittsbalken zeigt den aktuellen Status an. Wenn die Verarbeitung abgeschlossen ist, wird die CSV-Datei automatisch heruntergeladen.

Die heruntergeladene Datei heißt consent-logs-JJJJ-MM-TT_HH-MM-SS.csv und enthält diese Spalten:

SpalteInhalt
DatumZeitstempel in Ihrer WordPress-Zeitzone
Benutzer-IDWordPress-Benutzer-ID oder „Gast“
IP-AdresseAnonymisierte IP
Essenzielle CookiesAkzeptiert oder abgelehnt
Statistik-CookiesAkzeptiert oder abgelehnt
Marketing-CookiesAkzeptiert oder abgelehnt
DiensteDurch Kommas getrennte Liste einzelner Dienste mit ihrem Status

Bereinigung alter Protokolle

Im Laufe der Zeit kann Ihre Tabelle mit Zustimmungsprotokollen groß werden. WPConsent ermöglicht es Ihnen, veraltete Einträge zu entfernen, um die Datenbankgröße zu verwalten und Datenschutzrichtlinien einzuhalten.

  1. Navigieren Sie zu WPConsent >> Tools.
  2. Wählen Sie die Registerkarte Datenbank.
  3. Scrollen Sie zum Abschnitt Zustimmungsprotokolle löschen.
  4. Wählen Sie einen Zeitraum aus dem Dropdown-Menü Protokolle älter als löschen:

3 Monate6 Monate1 Jahr2 JahreGesamte Zeit

  1. Klicken Sie auf Protokolle löschen.

Alte Zustimmungs-Protokoll-Einträge löschen

Das Löschen erfolgt in Stapeln von 1.000 Einträgen, um Server-Timeouts zu verhindern. Eine Fortschrittsanzeige verfolgt den Vorgang. Diese Aktion ist irreversibel, daher können gelöschte Einträge nicht wiederhergestellt werden.

Die meisten Datenschutzbestimmungen empfehlen, Zustimmungsaufzeichnungen so lange aufzubewahren, wie die Zustimmung gültig ist. Prüfen Sie Ihre spezifischen regulatorischen Anforderungen, bevor Sie eine Aufbewahrungsfrist festlegen.

Einrichtung überprüfen

Bestätigen Sie nach der Aktivierung der Zustimmungsprotokollierung, dass alles korrekt funktioniert.

  1. Öffnen Sie Ihre Website in einem Inkognito- oder privaten Browserfenster.
  2. Interagieren Sie mit dem Zustimmungsbanner (akzeptieren, ablehnen oder Auswahlmöglichkeiten anpassen).
  3. Navigieren Sie zu WPConsent >> Consent Logs.
  4. Überprüfen Sie, ob ein neuer Eintrag mit Ihrer anonymisierten IP, den korrekten Zustimmungsentscheidungen und dem aktuellen Zeitstempel angezeigt wird.

Bestätigung des REST-Endpunkts

Besuchen Sie yoursite.com/wp-json/wpconsent/v1/log-consent in Ihrem Browser. Sie sollten eine Fehlermeldung wie diese sehen:

{"code":"rest_missing_callback_param","message":"Missing parameter(s): consent_data"}

Dies bestätigt, dass der Endpunkt aktiv ist. Das Frontend-Banner sendet automatisch die korrekten Daten, wenn Besucher damit interagieren.

Wenn Sie stattdessen einen 404-Fehler sehen, stellen Sie sicher, dass die Protokollierung von Einwilligungen in WPConsent >> Einstellungen aktiviert ist und dass Ihre WordPress-Permalinks gespeichert sind (navigieren Sie zu Einstellungen >> Permalinks und klicken Sie auf Änderungen speichern).

FAQ

Bestätigen Sie zunächst, dass der Schalter in WPConsent >> Einstellungen aktiviert ist. Wenn ja, öffnen Sie die Entwicklertools Ihres Browsers und überprüfen Sie den Netzwerk-Tab auf Anfragen an /log-consent. Eine fehlgeschlagene Anfrage kann auf einen REST-API-Konflikt mit einem anderen Plugin oder eine Server-Firewall, die den Endpunkt blockiert, hinweisen.

Warum fehlen Länderflaggen bei einigen Protokolleinträgen?

Ländercodes werden durch Geolokalisierung bestimmt. Wenn der Geolokalisierungsdienst zum Zeitpunkt der Erstellung eines Protokolleintrags nicht verfügbar ist, speichert WPConsent XX als Ländercode und es wird keine Flagge angezeigt. Wenn Sie die Protokollseite aufrufen, versucht das System, den Ländercode für alle Einträge nachzuschlagen und zu speichern, denen einer fehlt.

Warum reagiert der Export-Button nicht?

Stellen Sie sicher, dass Sie sowohl ein Von- als auch ein Bis-Datum ausgewählt haben, bevor Sie auf Exportieren klicken. Der Export erfordert einen Datumsbereich. Wenn der Fortschrittsbalken angezeigt wird, der Download aber nie beginnt, überprüfen Sie die Popup-Blocker-Einstellungen Ihres Browsers und vergewissern Sie sich, dass das Verzeichnis wp-content/uploads/wpconsent/exports/ beschreibbar ist.

Wenn Sie eine Benachrichtigung sehen, dass die Einwilligungs-Protokolle deaktiviert sind, klicken Sie auf den angegebenen Link, um zur Einstellungsseite zu gelangen. Aktivieren Sie dann den Schalter Einwilligungs-Protokolle und speichern Sie. Die Warnung verschwindet, sobald die Protokollierung aktiv ist.

Schlussfolgerung

Einwilligungs-Protokolle helfen Ihnen, eine Aufzeichnung der Einwilligungsentscheidungen von Besuchern zu führen. Indem Sie die Protokollierung aktivieren, Aufzeichnungen überprüfen und alte Daten periodisch exportieren oder bereinigen, können Sie Ihre Einwilligungsaufzeichnungen im Laufe der Zeit besser verwalten. Weitere Informationen zur Verwaltung der Datenbanktabellen und des Caches Ihres Plugins finden Sie im Leitfaden zur Datenbank- und Cache-Verwaltung.

War dieser Artikel hilfreich?

Verwandte Artikel