Müssen Sie ein Drittanbieter-Skript oder eine iFrame blockieren, die WPConsent nicht automatisch erkennt? Mit benutzerdefinierten Skripten können Sie Blockierregeln für jeden Tracking-Code oder eingebettete Inhalte hinzufügen, sodass diese erst geladen werden, nachdem Besucher der richtigen Cookie-Kategorie zugestimmt haben. Benutzerdefinierte Skripte und Iframes geben Ihnen die volle Kontrolle über Drittanbieter-Ressourcen, die außerhalb der integrierten Blockierliste liegen.

Pro-Funktion: Diese Funktion erfordert WPConsent Pro.

Inhaltsverzeichnis

• Voraussetzungen
• Verständnis, wann benutzerdefinierte Skripte verwendet werden sollen
• Navigation zum Abschnitt für benutzerdefinierte Skripte
• Hinzufügen eines neuen benutzerdefinierten Skripts oder iFrames
• Bearbeiten eines vorhandenen Skripts
• Löschen eines Skripts
• Verständnis, wie benutzerdefinierte Skripte blockiert werden
• Durcharbeiten von praktischen Beispielen
• Einrichtung überprüfen
• Fehlerbehebung
• FAQ
• Schlussfolgerung

Voraussetzungen

Stellen Sie vor Beginn sicher, dass Sie Folgendes haben:

• WPConsent Pro installiert und aktiviert
• Skriptblockierung aktiviert in WPConsent >> Einstellungen >> Einstellungen Tab
• Mindestens 1 Dienst wurde unter der Cookie-Kategorie Statistik oder Marketing erstellt (Sie können Dienste über den Tab Cookies hinzufügen oder die Dienstbibliothek verwenden)

Verständnis, wann benutzerdefinierte Skripte verwendet werden sollen

Sie benötigen eine benutzerdefinierte Skriptregel, wenn:

• Ihre Website einen Tracking-Pixel oder ein Analyse-Skript lädt, das WPConsent nicht automatisch blockiert.
• Sie Drittanbieter-Widgets (Chat, Karten, soziale Feeds) über Iframes einbetten, die Cookies setzen.
• Sie einen Nischen-Marketing- oder Analyse-Dienst verwenden, der nicht in der integrierten Blockierliste enthalten ist.
• Sie benutzerdefinierten Tracking-Code über ein Code-Snippet-Plugin oder den benutzerdefinierten Codebereich Ihres Themes hinzufügen.

Wenn Sie unsicher sind, ob ein Skript bereits blockiert ist, führen Sie zuerst den Website-Scanner aus. Der Scanner erkennt aktive Skripte und Iframes auf Ihrer Website und meldet, welche WPConsent bereits verarbeitet.

Navigation zum Abschnitt für benutzerdefinierte Skripte

1. Gehen Sie zu WPConsent >> Einstellungen in Ihrem WordPress-Admin.
2. Wählen Sie den Tab Erweitert.
3. Scrollen Sie nach unten zum Abschnitt Benutzerdefinierte Iframes/Skripte.

Dieser Abschnitt zeigt ein Akkordeon mit 2 Kategorien: Statistik-Skripte und Marketing-Skripte. Um vorhandene Einträge anzuzeigen, klicken Sie auf den Pfeil neben einem Kategorienamen, um ihn zu erweitern.

Jeder Skript-Eintrag zeigt die folgenden Spalten an:

Spalte	Beschreibung
Dienst	Der Dienst, zu dem dieses Skript gehört
Typ	Entweder Skript oder iFrame
Skript	Die Kennzeichnungszeichenfolge, die zum Abgleichen des Skripts oder iFrames verwendet wird
Blockierte Elemente	Zusätzliche Schlüsselwörter (für Skripte) oder CSS-Selektoren (für iframes)
Aktionen	Bearbeiten und Löschen von Schaltflächen

Hinzufügen eines neuen benutzerdefinierten Skripts oder iFrames

1. Klicken Sie auf die Schaltfläche Benutzerdefinierten iFrame/Skript hinzufügen unter den Kategorie-Akkordeons. Dies öffnet das Modal Neues Skript oder iFrame hinzufügen.

1. Wählen Sie eine Kategorie. Wählen Sie entweder Statistik oder Marketing, je nach Zweck des Skripts. Die Kategorie bestimmt, welcher Zustimmungs-Schalter das Skript im Präferenzbereich des Besuchers steuert.

1. Wählen Sie einen Dienst. Das Dienst-Dropdown aktualisiert sich basierend auf der ausgewählten Kategorie und zeigt alle Dienste an, die Sie unter dieser Kategorie erstellt haben. Wenn das Dropdown leer ist, gehen Sie zum Tab Cookies und erstellen Sie zuerst einen Dienst.
2. Wählen Sie einen Typ. Wählen Sie Skript für JavaScript-Tracking-Code oder iFrame für eingebettete Inhalte. Die nachstehenden Formularfelder ändern sich je nach Ihrer Auswahl.

Ausfüllen der Felder für den Skripttyp

Wenn Sie Skript auswählen, erscheinen 2 Felder:

• Skript-Tag: Geben Sie eine eindeutige Zeichenfolge ein, die das zu blockierende Skript identifiziert. Dies ist typischerweise Teil der URL des Skripts. Um beispielsweise den Facebook Pixel zu blockieren, würden Sie connect.facebook.net/en_US/fbevents.js eingeben. WPConsent gleicht diese Zeichenfolge mit script-Tags im Seiten-HTML ab.
• Skript-Schlüsselwörter: Geben Sie JavaScript-Funktionsnamen ein, die vom Hauptskript abhängen, getrennt durch Kommas. Zum Beispiel fbq, fbq.push. WPConsent blockiert Inline-Skripte, die auf diese Funktionsnamen verweisen. Dies verhindert Fehler durch blockierte Skripte und stellt sicher, dass keine Daten vor der Zustimmung gesendet werden.

Ausfüllen der Felder für den iFrame-Typ

Wenn Sie iFrame auswählen, erscheinen 2 Felder:

• iFrame-Tag: Geben Sie eine eindeutige Zeichenfolge ein, die die zu blockierende iFrame-Quelle identifiziert. Zum Beispiel youtube.com/embed. WPConsent gleicht diese Zeichenfolge mit dem src-Attribut von iframe-Elementen ab.
• Blockierte Elemente: Geben Sie CSS-Selektoren für HTML-Elemente ein, die ausgeblendet und durch einen Platzhalter ersetzt werden sollen, bis die Zustimmung erteilt wird, getrennt durch Kommas. Zum Beispiel #my-chat-widget, .social-embed. Dies ist nützlich, wenn ein Drittanbieter-Widget sichtbare HTML-Elemente neben seinem iFrame rendert.

1. Klicken Sie auf Speichern. Das neue Skript erscheint sofort im entsprechenden Kategorie-Akkordeon.

Bearbeiten eines vorhandenen Skripts

1. Erweitern Sie zuerst das Kategorie-Akkordeon, das das Skript enthält.
2. Klicken Sie auf das Bearbeiten-Symbol (Stift) in der Spalte Aktionen.
3. Das Modal öffnet sich mit den aktuellen Werten, die vorausgefüllt sind. Nehmen Sie Ihre Änderungen vor.
4. Klicken Sie auf Speichern.

Der Skripteintrag wird in der Liste aktualisiert, ohne dass die Seite neu geladen werden muss.

Löschen eines Skripts

1. Erweitern Sie zuerst das Kategorie-Akkordeon, das das Skript enthält.
2. Klicken Sie auf das Löschen-Symbol (Mülleimer) in der Spalte Aktionen.
3. Bestätigen Sie die Löschung im Browser-Dialog.

Das Skript wird sofort aus der Liste entfernt.

Verständnis, wie benutzerdefinierte Skripte blockiert werden

Benutzerdefinierte Skripte integrieren sich direkt in dieselbe Blockierungs-Engine, die auch integrierte Dienste handhabt. Wenn Sie ein benutzerdefiniertes Skript speichern, fügt WPConsent es der internen Liste der blockierten Skripte hinzu. Beim nächsten Laden der Seite:

Für Skripttypen: WPConsent durchsucht die Seiten-HTML nach script-Tags, die die von Ihnen in Skript-Tag eingegebene Zeichenfolge enthalten. Übereinstimmende Skripte haben ihr type-Attribut geändert zu text/plain und ihr src wurde nach data-wpconsent-src verschoben, was verhindert, dass der Browser sie ausführt. Wenn Sie Skript-Schlüsselwörter angegeben haben, werden auch Inline-Skripte, die diese Funktionsnamen enthalten, blockiert.

Für iFrame-Typen: WPConsent sucht nach iframe-Elementen, deren src-Attribut die von Ihnen in iFrame-Tag eingegebene Zeichenfolge enthält. Der src wird entfernt und in data-wpconsent-src gespeichert. Wenn Sie Blockierte Elemente angegeben haben, verbergen diese CSS-Selektoren zusätzliche Elemente und zeigen einen Zustimmungsplatzhalter an.

Wenn der Besucher die entsprechende Cookie-Kategorie (Statistiken oder Marketing) akzeptiert, stellt WPConsent die blockierten Skripte und iFrames wieder her, damit sie normal geladen und ausgeführt werden.

Durcharbeiten von praktischen Beispielen

Blockieren eines benutzerdefinierten Analyse-Pixels

Wenn Ihr Marketingteam einen Nischen-Analyse-Dienst hinzugefügt hat, der ein Skript von tracker.example.com/pixel.js lädt:

1. Öffnen Sie das Modal Neues Skript oder iFrame hinzufügen.
2. Setzen Sie Kategorie auf Statistiken.
3. Wählen Sie den entsprechenden Dienst aus (oder erstellen Sie ihn zuerst im Tab Cookies).
4. Setzen Sie Typ auf Skript.
5. Geben Sie tracker.example.com/pixel.js in Skript-Tag ein.
6. Wenn das Skript eine globale Funktion wie trackEvent definiert, geben Sie trackEvent in Skript-Schlüsselwörter ein.
7. Klicken Sie auf Speichern.

Blockieren eines Drittanbieter-Chat-Widgets als iFrame

Wenn ein Chat-Widget in einem iFrame von chat.example.com/widget geladen wird:

1. Öffnen Sie das Modal Neues Skript oder iFrame hinzufügen.
2. Setzen Sie Kategorie auf Marketing.
3. Wählen Sie den entsprechenden Dienst aus.
4. Setzen Sie Typ auf iFrame.
5. Geben Sie chat.example.com/widget in iFrame-Tag ein.
6. Geben Sie #chat-widget-container in Blockierte Elemente ein, um den umgebenden Container zu verbergen und einen Platzhalter anzuzeigen.
7. Klicken Sie auf Speichern.

Einrichtung überprüfen

Nachdem Sie ein benutzerdefiniertes Skript hinzugefügt haben, überprüfen Sie, ob es korrekt funktioniert:

1. Öffnen Sie Ihre Website in einem privaten oder Inkognito-Browserfenster.
2. Öffnen Sie die Entwicklertools des Browsers (F12) und wechseln Sie zum Tab Netzwerk.
3. Suchen Sie nach dem Skript oder iFrame in den Netzwerkanfragen. Es sollte erst erscheinen, nachdem Sie mit dem Banner interagiert haben.
4. Akzeptieren Sie die entsprechende Cookie-Kategorie im Zustimmungsbanner.
5. Überprüfen Sie erneut den Tab Netzwerk. Das Skript oder der iFrame wird jetzt geladen.

Sie können auch den Tab Elemente in den Entwicklertools überprüfen. Suchen Sie vor der Zustimmung nach script-Tags mit den Attributen type="text/plain" und data-wpconsent-src. Dies sind blockierte Skripte, die auf Zustimmung warten.

Fehlerbehebung

Skript wird immer noch ohne Zustimmung geladen

Die Zeichenfolge Skript-Tag stimmt nicht mit dem überein, was sich in Ihrer Seiten-HTML befindet. Öffnen Sie die Seitenquelle (Strg+U) und suchen Sie nach der Skript-URL. Kopieren Sie die exakte Teilzeichenfolge und fügen Sie sie in das Feld Skript-Tag ein. Die Übereinstimmung ist Groß-/Kleinschreibung-sensitiv.

iFrame wird immer noch ohne Zustimmung geladen

Prüfen Sie, ob der iFrame-Tag mit dem src-Attribut des iframes übereinstimmt. Einige iframes verwenden protokollrelative URLs (beginnend mit //) oder enthalten Abfrageparameter. Verwenden Sie nur den Domain- und Pfadteil als Identifikator. Verwenden Sie zum Beispiel youtube.com/embed anstelle der vollständigen URL mit Parametern.

Skript-Schlüsselwörter funktionieren nicht

Schlüsselwörter blockieren Inline-Skript-Tags, die auf diese Funktionsnamen verweisen. Sie beeinträchtigen keine Skripte, die von externen URLs geladen werden. Das Feld Skript-Tag behandelt das Blockieren externer Skripte. Verwenden Sie Skript-Schlüsselwörter nur für Inline-Code, der vom externen Skript abhängt.

Dienst-Dropdown ist leer

Das Dienst-Dropdown wird basierend auf der ausgewählten Kategorie gefüllt. Wenn in der gewählten Kategorie keine Dienste vorhanden sind, ist das Dropdown leer. Gehen Sie zur Registerkarte Cookies und fügen Sie zuerst einen Dienst zur Kategorie Statistik oder Marketing hinzu.

FAQ

Kann ich ein Skript blockieren, das bereits in der integrierten Liste enthalten ist?

Das ist nicht nötig. WPConsent verarbeitet automatisch alle Skripte in der integrierten Liste. Das Hinzufügen einer doppelten benutzerdefinierten Regel führt nicht zu Fehlern, ist aber unnötig.

Woher weiß ich, welche Zeichenfolge ich für das Skript-Tag verwenden soll?

Öffnen Sie die Entwicklertools Ihres Browsers, gehen Sie zur Registerkarte Netzwerk und suchen Sie die Anfrage für das Skript, das Sie blockieren möchten. Kopieren Sie einen eindeutigen Teil seiner URL. Die Zeichenfolge muss nur spezifisch genug sein, um dieses Skript abzugleichen, ohne versehentlich andere Ressourcen abzugleichen.

Kann ich ein benutzerdefiniertes Skript der Kategorie "Essentiell" oder "Funktional" zuweisen?

Nein. Benutzerdefinierte Skripte sind auf die Kategorien Statistik und Marketing beschränkt. Skripte in der Kategorie "Essentiell" sind für die Funktion Ihrer Website erforderlich und sollten nicht blockiert werden. Funktionale Cookies werden separat verwaltet.

Muss ich nach dem Hinzufügen eines benutzerdefinierten Skripts den Cache leeren?

Wenn Sie ein Caching-Plugin verwenden, leeren Sie Ihren Seiten-Cache, nachdem Sie benutzerdefinierte Skripte hinzugefügt oder geändert haben. Die Blockierung durch WPConsent erfolgt während des Renderns der Seite, sodass zwischengespeicherte Seiten keine Änderungen widerspiegeln, bis der Cache aktualisiert wird.

Schlussfolgerung

Benutzerdefinierte Skripte ermöglichen es Ihnen, die Blockierungsfunktionen von WPConsent zu erweitern, um alle Drittanbieter-Ressourcen auf Ihrer Website abzudecken. Durch die Erstellung von Regeln mit spezifischen Skript-Tags und Schlüsselwörtern stellen Sie sicher, dass jedes Tracking-Skript und jeder iframe die Zustimmungseinstellungen Ihrer Besucher respektiert.

Weitere Informationen darüber, wie die integrierte Blockierungs-Engine funktioniert, finden Sie in unserem Leitfaden zur automatischen Skriptblockierung. Wenn Sie mit iframes arbeiten und Platzhalterinhalte anpassen möchten, lesen Sie unseren Leitfaden zur Inhaltsblockierung und Platzhaltern.