WPConsent-Dokumentation

Dokumentation, Referenzmaterialien und Tutorials für WPConsent

WP Consent API-Integration

Möchten Sie, dass andere WordPress-Plugins die Einwilligungsentscheidungen Ihrer Besucher automatisch erkennen? WPConsent lässt sich in das WP Consent API-Plugin integrieren, sodass die über Ihr Banner getroffenen Einwilligungsentscheidungen mit jedem kompatiblen Plugin auf Ihrer Website geteilt werden. In diesem Leitfaden wird erklärt, was die WP Consent API ist, warum die Integration wichtig ist und wie WPConsent seine Kategorien dem Standard-API-Format zuordnet.

Inhaltsverzeichnis

Die WP Consent API ist ein kostenloses WordPress-Plugin, das eine gemeinsame Sprache für das Einwilligungsmanagement schafft. Anstatt dass jedes Plugin seine eigenen Einwilligungsprüfungen entwickelt, bietet die WP Consent API einen einzigen Standard, mit dem Plugins fragen können: „Erlaubt dieser Besucher Statistik-Cookies?“ oder „Erlaubt dieser Besucher Marketing-Cookies?“

Jedes Plugin, das die WP Consent API unterstützt, kann den Status der Einwilligung aus jedem kompatiblen Einwilligungsmanagement-Plugin lesen. Das bedeutet, dass Sie nicht an ein bestimmtes Ökosystem gebunden sind – Ihre Einwilligungsentscheidungen werden an jedes Plugin weitergeleitet, das dieselbe Sprache spricht.

Warum diese Integration wichtig ist

Ohne die WP Consent API verarbeitet jedes Plugin die Einwilligung unabhängig. Dies kann zu folgenden Situationen führen:

  • Ein Besucher akzeptiert Cookies über Ihr WPConsent-Banner, aber ein Formular-Plugin weiß nichts davon und blockiert unnötigerweise die Funktionalität.
  • Ein Besucher lehnt Marketing-Cookies ab, aber ein Analyse-Plugin wird trotzdem geladen, da es den Zustimmungsstatus von WPConsent nicht überprüft.
  • Sie müssen die Einwilligungsprüfungen in mehreren Plugins manuell konfigurieren, anstatt alles von einem Ort aus zu verwalten.

Wenn die Integration aktiv ist, wird WPConsent zur einzigen Quelle für die Einwilligung auf deiner Website. Jedes WP Consent API-kompatible Plugin respektiert automatisch die Entscheidungen, die Besucher über dein Banner treffen.

Wie die Integration funktioniert

Wenn sowohl WPConsent als auch das WP Consent API-Plugin aktiv sind, erfolgt die Integration automatisch. Es muss nichts konfiguriert werden.

Das macht WPConsent hinter den Kulissen:

  1. Registriert sich als aktiver Einwilligungsmanager, damit die WP Consent API weiß, welches Plugin die Einwilligung verwaltet.
  2. Legt den Zustimmungstyp (Opt-in oder Opt-out) basierend auf Ihren WPConsent-Einstellungen fest, damit andere Plugins wissen, ob sie standardmäßig blockieren oder zulassen sollen.
  3. Synchronisiert die Einwilligungsoptionen, wenn ein Besucher seine Präferenzen über das Banner speichert. WPConsent übersetzt seine eigenen Kategorien in das Standardformat der WP Consent API.
  4. Vermeidet doppelte Blockierung, indem es die eigene Skriptblockierung für Skripte überspringt, die bereits von der WP Consent API verwaltet werden.

Wenn das WP Consent API-Plugin nicht installiert ist, funktioniert WPConsent genau gleich – die Integration wird lediglich nicht aktiviert.

Kategoriezuordnung

WPConsent verwendet eigene Kategorienamen (Essential, Statistics, Marketing), während die WP Consent API einen anderen Satz von Standardkategorien verwendet. WPConsent ordnet die beiden automatisch einander zu, wenn ein Besucher seine Präferenzen speichert.

WPConsent-KategorieWP Consent API-KategorieZustimmungsstaat
WesentlichfunctionalImmer erlaubt
WesentlichpreferencesImmer erlaubt
StatistikstatisticsBasierend auf der Wahl der Besucher
Statistikstatistics-anonymousBasierend auf der Wahl der Besucher
MarketingmarketingBasierend auf der Wahl der Besucher

Einige Dinge, die zu beachten sind:

  • Wesentlich zu beiden functional und preferences da WPConsent keine separate Kategorie „Einstellungen“ hat. Beide sind immer auf „zulässig“ gesetzt, da essentielle Cookies für die Funktion Ihrer Website erforderlich sind.
  • Statistik zu beiden statistics und statistics-anonymousDie WP Consent API unterscheidet zwischen regulären und anonymen Analysen, aber WPConsent behandelt sie gleich – beide folgen der Statistikauswahl des Besuchers.
  • Marketing direkt zugeordnet zu marketing ohne zusätzliche Übersetzungen.

Diese Zuordnung bedeutet, dass jedes Plugin, das wp_has_consent( 'statistics' ) oder wp_has_consent( 'marketing' ) beachtet automatisch die Entscheidungen, die Besucher über Ihr WPConsent-Banner treffen.

WPConsent teilt der WP Consent API mit, ob Ihre Website die Opt-in- oder Opt-out-Zustimmung verwendet:

  • Opt-in (Standardmäßig deaktiviert): Skripte und Cookies werden blockiert, bis der Besucher sie ausdrücklich akzeptiert. Dies ist der Standard für die Einhaltung der DSGVO.
  • Deaktivieren (Standardmäßig aktiviert): Skripte und Cookies sind standardmäßig aktiviert, bis der Besucher sie aktiv ablehnt.

Diese Einstellung wird aus Ihrer WPConsent-Konfiguration unter WPConsent >> Einstellungen (der Schalter „Standardmäßig zulassen“ ) gelesen. Andere Plugins, die den Zustimmungstyp überprüfen, können dann ihr Verhalten entsprechend anpassen.

Skript-Blockierungskoordination

Wenn sowohl WPConsent als auch die WP Consent API dasselbe Skript verwalten, kann es zu einer doppelten Blockierung kommen. Um dies zu verhindern, überspringt WPConsent automatisch seine eigene Blockierung für Skripte, die bereits von der WP Consent API verarbeitet werden.

Beispielsweise wird das Attributions-Tracking-Skript von WooCommerce über die WP Consent API verwaltet. WPConsent erkennt dies und lässt die WP Consent API die Blockierung übernehmen, anstatt seine eigenen Regeln darüber zu legen.

Einrichten der Integration

  1. Installieren und aktivieren Sie das WP Consent API-Plugin aus dem WordPress-Plugin-Repository.
  2. Das war's schon. WPConsent erkennt die WP Consent API automatisch und aktiviert die Integration.

Es sind keine zusätzlichen Einstellungen zu konfigurieren. Die Zuordnung der Kategorien, die Synchronisierung der Einwilligungstypen und die Koordination der Skriptblockierung erfolgen automatisch.

Häufig gestellte Fragen

Ja. Die WP Consent API ist ein separates kostenloses Plugin, das im WordPress-Plugin-Repository verfügbar ist. Installieren und aktivieren Sie es zusammen mit WPConsent, um die Integration zu ermöglichen.

Überprüfen Sie zunächst, ob das WP Consent API-Plugin installiert und aktiv ist. Vergewissern Sie sich dann, dass das andere Plugin tatsächlich die WP Consent API unterstützt (siehe Dokumentation). Testen Sie schließlich in einem Inkognito-Fenster, um einen zwischengespeicherten Zustimmungsstatus auszuschließen.

Nein. WPConsent funktioniert vollständig eigenständig. Die Integration der WP Consent API ist eine optionale Ergänzung, die die Interoperabilität mit anderen Plugins verbessert, die den Standard unterstützen.

Muss die Integration konfiguriert werden?

Nein. Sobald beide Plugins aktiv sind, übernimmt WPConsent automatisch alle Aufgaben – Registrierung, Kategoriezuordnung, Synchronisierung der Einwilligungsarten und Koordination der Skriptblockierung.

Schlussfolgerung

Durch die Integration der WP Consent API kann WPConsent Einwilligungsentscheidungen über eine standardisierte Schnittstelle mit allen kompatiblen Plugins auf Ihrer Website teilen. Installieren Sie das WP Consent API-Plugin, und WPConsent erledigt den Rest automatisch. Weitere Informationen zu verwandten Themen finden Sie unter Verwalten von Cookie-Kategorien und Automatisches Blockieren von Skripten.

War dieser Artikel hilfreich?

Verwandte Artikel