Möchten Sie ein Skript oder einen Iframe eines Drittanbieters blockieren, das bzw. der von WPConsent nicht automatisch erkannt wird? Mit benutzerdefinierten Skripten können Sie Blockierungsregeln für beliebige Tracking-Codes oder eingebettete Inhalte hinzufügen, sodass diese erst geladen werden, nachdem Besucher der richtigen Cookie-Kategorie zugestimmt haben. Mit benutzerdefinierten Skripten und Iframes haben Sie die volle Kontrolle über Ressourcen von Drittanbietern, die nicht in der integrierten Blockierungsliste enthalten sind.

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

Inhaltsverzeichnis

• Voraussetzungen
• Verstehen, wann benutzerdefinierte Skripte verwendet werden sollten
• Navigieren zum Abschnitt „Benutzerdefinierte Skripte“
• Hinzufügen eines neuen benutzerdefinierten Skripts oder Iframes
• Bearbeiten eines vorhandenen Skripts
• Ein Skript löschen
• Verstehen, wie benutzerdefinierte Skripte blockiert werden
• Arbeiten anhand praktischer Beispiele
• Überprüfen Ihrer Einrichtung
• Fehlersuche
• Häufig gestellte Fragen
• Schlussfolgerung

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

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

Verstehen, wann benutzerdefinierte Skripte verwendet werden sollten

Sie benötigen eine benutzerdefinierte Skriptregel, wenn:

• Ihre Website lädt ein Tracking-Pixel oder ein Analyseskript, das WPConsent nicht automatisch blockiert.
• Sie binden Widgets von Drittanbietern (Chat, Karten, Social Feeds) mithilfe von Iframes ein, die Cookies setzen.
• Sie verwenden einen Nischen-Marketing- oder Analysedienst, der nicht in der integrierten Sperrliste enthalten ist.
• Sie fügen benutzerdefinierten Tracking-Code über ein Code-Snippets-Plugin oder den benutzerdefinierten Code-Bereich Ihres Themes hinzu.

Wenn Sie sich nicht sicher sind, ob ein Skript bereits blockiert ist, führen Sie zunächst den Website-Scanner aus. Der Scanner erkennt aktive Skripte und Iframes auf Ihrer Website und meldet, welche davon bereits von WPConsent verarbeitet werden.

Navigieren zum Abschnitt „Benutzerdefinierte Skripte“

1. Gehen Sie in Ihrem WordPress-Adminbereich zu „WPConsent >> Einstellungen “.
2. Wählen Sie die Registerkarte „Erweitert “.
3. Scrollen Sie nach unten zum Abschnitt „Benutzerdefinierte Iframes/Skripte “.

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

Jeder Skripteintrag zeigt die folgenden Spalten an:

Spalte	Beschreibung
Dienstleistung	Der Dienst, zu dem dieses Skript gehört
Typ	Entweder Skript oder iFrame
Skript	Die Identifikationszeichenfolge, 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	Schaltflächen zum Bearbeiten und Löschen

Hinzufügen eines neuen benutzerdefinierten Skripts oder Iframes

1. Klicken Sie unterhalb der Kategorie-Akkordeons auf die Schaltfläche „Benutzerdefinierten iFrame/Skript hinzufügen ”. Dadurch wird das Modal „Neues Skript oder iFrame hinzufügen ” geöffnet.

1. Wählen Sie eine Kategorie aus. Wählen Sie je nach Zweck des Skripts entweder „Statistik“ oder „Marketing“. Die Kategorie bestimmt, welcher Einwilligungsschalter das Skript im Einstellungsfenster des Besuchers steuert.

1. Wählen Sie einen Dienst aus. Das Dropdown-Menü „Dienst“ wird entsprechend der ausgewählten Kategorie aktualisiert und zeigt alle Dienste an, die Sie unter dieser Kategorie erstellt haben. Wenn das Dropdown-Menü leer ist, gehen Sie zur Registerkarte „Cookies“ und erstellen Sie zunächst einen Dienst.
2. Wählen Sie einen Typ aus. Wählen Sie „Skript“ für JavaScript-Tracking-Code oder „iFrame“ für eingebettete Inhalte. Die Formularfelder unten ändern sich entsprechend Ihrer Auswahl.

Ausfüllen von Feldern vom Typ „Skript“

Wenn Sie „Skript“ auswählen, werden zwei Felder angezeigt:

• Skript-TagGeben Sie eine eindeutige Zeichenfolge ein, die das Skript identifiziert, das Sie blockieren möchten. Diese ist in der Regel Teil der URL des Skripts. Um beispielsweise das Facebook-Pixel zu blockieren, würden Sie Folgendes eingeben: connect.facebook.net/en_US/fbevents.jsWPConsent gleicht diese Zeichenfolge mit script Tags im HTML-Code der Seite.
• Skript-Schlüsselwörter: Geben Sie die Namen der JavaScript-Funktionen ein, die vom Hauptskript abhängig sind, getrennt durch Kommas. Beispiel: fbq, fbq.pushWPConsent blockiert Inline-Skripte, die auf diese Funktionsnamen verweisen. Dadurch werden Fehler durch blockierte Skripte verhindert und sichergestellt, dass vor der Einwilligung keine Daten gesendet werden.

Ausfüllen von Feldern vom Typ „iframe“

Wenn Sie „iFrame“ auswählen, werden zwei Felder angezeigt:

• iFrame-Tag: Geben Sie eine eindeutige Zeichenfolge ein, die die Quelle des Iframes identifiziert, den Sie blockieren möchten. Beispiel: youtube.com/embedWPConsent gleicht diese Zeichenfolge mit der src Eigenschaft von iframe Elemente.
• 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. Beispiel: #my-chat-widget, .social-embedDies ist nützlich, wenn ein Widget eines Drittanbieters neben seinem Iframe sichtbare HTML-Elemente rendert.

1. Klicken Sie auf „Speichern“. Das neue Skript wird sofort in der entsprechenden Kategorie angezeigt.

Bearbeiten eines vorhandenen Skripts

1. Erweitern Sie zunächst die Kategorie-Akkordeon, die das Skript enthält.
2. Klicken Sie auf das Bearbeitungssymbol (Bleistift) in der Spalte „Aktionen “.
3. Das Modalfenster wird mit den aktuellen Werten geöffnet. Nehmen Sie Ihre Änderungen vor.
4. Klicken Sie auf Speichern.

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

Ein Skript löschen

1. Erweitern Sie zunächst die Kategorie-Akkordeon, die das Skript enthält.
2. Klicken Sie auf das Löschsymbol (Papierkorb) in der Spalte „Aktionen “.
3. Bestätigen Sie die Löschung im Browser-Dialogfeld.

Das Skript wird sofort aus der Liste entfernt.

Verstehen, wie benutzerdefinierte Skripte blockiert werden

Benutzerdefinierte Skripte werden direkt in dieselbe Blockierungs-Engine integriert, die auch für integrierte Dienste zuständig ist. Wenn Sie ein benutzerdefiniertes Skript speichern, fügt WPConsent es zur internen Liste der blockierten Skripte hinzu. Beim nächsten Laden der Seite:

Für SkripttypenWPConsent durchsucht den HTML-Code der Seite nach script Tags, die die von Ihnen eingegebene Zeichenfolge enthalten Skript-TagPassende Skripte haben ihre type Attribut geändert zu text/plain und ihre src umgezogen nach data-wpconsent-src, wodurch der Browser daran gehindert wird, sie auszuführen. Wenn Sie angegeben haben Skript-Schlüsselwörter, werden auch Inline-Skripte, die diese Funktionsnamen enthalten, blockiert.

Für iFrame-TypenWPConsent sucht nach iframe Elemente, deren src Das Attribut enthält die Zeichenfolge, die Sie in iFrame-Tag. Das src wird entfernt und gespeichert in data-wpconsent-srcWenn Sie angegeben haben Blockierte ElementeDiese CSS-Selektoren blenden zusätzliche Elemente aus und zeigen einen Platzhalter für die Einwilligung an.

Wenn der Besucher die entsprechende Cookie-Kategorie (Statistik oder Marketing) akzeptiert, stellt WPConsent die blockierten Skripte und Iframes wieder her, sodass sie normal geladen und ausgeführt werden können.

Arbeiten anhand praktischer Beispiele

Blockieren eines benutzerdefinierten Analyse-Pixels

Wenn Ihr Marketingteam einen Nischen-Analysedienst hinzugefügt hat, der ein Skript von tracker.example.com/pixel.js:

1. Öffnen Sie das Modal „Neues Skript oder iFrame hinzufügen “.
2. Setzen Sie die Kategorie auf „Statistik“.
3. Wählen Sie den entsprechenden Dienst aus (oder erstellen Sie zunächst einen neuen Dienst auf der Registerkarte „Cookies“ ).
4. Typ auf Skript einstellen.
5. Eingeben tracker.example.com/pixel.js in Skript-Tag.
6. Wenn das Skript eine globale Funktion wie trackEvent, eingeben trackEvent in Skript-Schlüsselwörter.
7. Klicken Sie auf Speichern.

Blockieren eines Chat-Widget-Iframes von Drittanbietern

Wenn ein Chat-Widget in einem iframe von chat.example.com/widget:

1. Öffnen Sie das Modal „Neues Skript oder iFrame hinzufügen “.
2. Setzen Sie die Kategorie auf „Marketing“.
3. Wählen Sie den entsprechenden Dienst aus.
4. Typ auf iFrame setzen.
5. Eingeben chat.example.com/widget in iFrame-Tag.
6. Eingeben #chat-widget-container in Blockierte Elemente den umgebenden Container ausblenden und einen Platzhalter anzeigen.
7. Klicken Sie auf Speichern.

Überprüfen Ihrer Einrichtung

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

1. Öffnen Sie Ihre Website in einem privaten oder Inkognito-Browserfenster.
2. Öffnen Sie die Entwicklertools Ihres Browsers (F12) und wechseln Sie zur Registerkarte „Netzwerk “.
3. Suchen Sie in den Netzwerkanfragen nach dem Skript oder Iframe. Es sollte nicht erscheinen, bevor Sie mit dem Banner interagieren.
4. Akzeptieren Sie die entsprechende Cookie-Kategorie im Einwilligungsbanner.
5. Überprüfen Sie erneut die Registerkarte „Netzwerk “. Das Skript oder der Iframe wird nun geladen.

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

Fehlersuche

Skript wird weiterhin ohne Zustimmung geladen

Die Zeichenfolge „Script Tag“ stimmt nicht mit dem HTML-Code Ihrer Seite überein. Öffnen Sie den Quellcode der Seite (Strg+U) und suchen Sie nach der Skript-URL. Kopieren Sie die genaue Teilzeichenfolge und fügen Sie sie in das Feld „Script Tag“ ein. Bei der Übereinstimmung wird zwischen Groß- und Kleinschreibung unterschieden.

iFrame wird weiterhin ohne Zustimmung geladen

Überprüfen Sie, ob die iFrame-Tag entspricht dem src Attribut des iframe. Einige iframes verwenden protokollrelative URLs (beginnend mit //) oder Query-Parameter enthalten. Verwenden Sie nur den Domain- und Pfadteil als Identifikator. Verwenden Sie beispielsweise youtube.com/embed anstelle der vollständigen URL mit Parametern.

Skript-Schlüsselwörter funktionieren nicht

Schlüsselwörter-Block inline script Tags, die auf diese Funktionsnamen verweisen. Sie haben keine Auswirkungen auf Skripte, die von externen URLs geladen werden. Die Skript-Tag field übernimmt die Blockierung externer Skripte. Verwenden Sie Skript-Schlüsselwörter nur für Inline-Code, der vom externen Skript abhängt.

Das Dropdown-Menü „Service“ ist leer.

Das Dropdown-Menü „Dienst“ wird basierend auf der ausgewählten Kategorie ausgefüllt. Wenn in der ausgewählten Kategorie keine Dienste vorhanden sind, ist das Dropdown-Menü leer. Wechseln Sie zur Registerkarte „Cookies“ und fügen Sie zunächst einen Dienst zur Kategorie „Statistik“ oder „Marketing“ hinzu.

Häufig gestellte Fragen

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 verursacht keine Fehler, ist aber unnötig.

Woher weiß ich, welche Zeichenfolge ich für das Script-Tag verwenden muss?

Ö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 der URL. Die Zeichenfolge muss nur so spezifisch sein, dass sie mit diesem Skript übereinstimmt, ohne versehentlich mit anderen Ressourcen übereinzustimmen.

Kann ich der Kategorie „Essential“ oder „Functional“ ein benutzerdefiniertes Skript zuweisen?

Nein. Benutzerdefinierte Skripte sind auf die Kategorien „Statistik“ und „Marketing“ beschränkt. Skripte der Kategorie „Essential“ 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, löschen Sie Ihren Seiten-Cache, nachdem Sie benutzerdefinierte Skripte hinzugefügt oder geändert haben. Die Blockierung durch WPConsent erfolgt während der Seitenwiedergabe, sodass zwischengespeicherte Seiten die Änderungen erst nach einer Aktualisierung des Caches anzeigen.

Schlussfolgerung

Mit benutzerdefinierten Skripten können Sie die Blockierungsfunktionen von WPConsent erweitern, um alle Ressourcen von Drittanbietern auf Ihrer Website abzudecken. Durch die Erstellung von Regeln mit bestimmten Skript-Tags und Schlüsselwörtern stellen Sie sicher, dass jedes Tracking-Skript und jeder Iframe die Einwilligungsentscheidungen Ihrer Besucher respektiert.

Weitere Informationen zur Funktionsweise der integrierten Blockierungs-Engine 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 zu Platzhaltern.