Um dem Spare Parts Finder von KTM einzubinden, wird ein externes Skript von KTM geladen, um den Ersatzteilkatalog anzuzeigen. Sobald Sie in den Optionen einen API-Key eingetragen haben, wird auf jeder Seite, auf der Sie den Block „KTM Spare Parts Finder“ einbinden, dieses externe Skript geladen.
Um eine DSGVO-konforme Integration zu gewährleisten, sollte eine Option implementiert werden, die das Laden des Skripts blockiert, falls ein Besucher die Nutzung dieser Funktion nicht über eine Cookie-Opt-in-Lösung bestätigt hat.
Um den rechtlichen Anforderungen gerecht zu werden, existieren zahlreiche WordPress-Lösungen, die mithilfe von Consent-Tools das Blockieren von Skripten ermöglichen. Je nachdem, welche Lösung Sie verwenden, können die Schritte zur Einrichtung variieren.
Pfad:
Eine Seite, auf der Sie den SPF Block verbauen
Skript Aufruf:
<script src="https://sparepartsfinderwebcomponent.dealerhub.com/app/v1/pmag-spare-parts-finder.js?ver=1.0" id="oneboxshop-ktm-spf-connector-webcomponent-js"></script>
Beispiel: Borlabs 3 Cookie Opt-In
Da der Spare Parts Finder direkt in das HTML eingebettet wird und nicht als iframe o.ä. geladen wird, kann nicht einfach ein Content-Blocker erstellt werden. Zuerst wird ein Skript-Blocker angelegt, daraus ein Content-Blocker erstellt, um den Kunden eine Vorschau zeigen zu können.
1. Script-Blocker erstellen
- Borlabs: Blocker -> Script Blocker öffnen
- „Neu hinzufügen“, ID und Name ausfüllen (z.B. ID:
obs-ktm-spf
und Name:KTM Spare Parts Finder
). - Seite auswählen, auf der der SPF Block verbaut ist, Scan-Modus: Gast, Suchphrase
oneboxshop-ktm-spf-connector-webcomponent
eingeben, „Scannen starten“ - Passendes, gefundenes Handle zum Blockieren auswählen
- Status unter der ID auf aktiv setzen, Script Blocker erstellen mit „Alle Einstellungen speichern“
- Durch das Speichern lädt die Seite neu
- unter „Script-Blocker Konfiguration“, „Content-Blocker Global-JavaScript“ den Script-Tag kopieren und für später ablegen (im folgenden Screenshot markiert).
In diesem Beispiel mit der oben gewählten ID lautet der Content-Blocker Global-JavaScript:window.BorlabsCookie.ScriptBlocker.allocateScriptBlockerToContentBlocker(contentBlockerData.id, 'obs-ktm-spf', 'scriptBlockerId');
window.BorlabsCookie.Unblock.unblockScriptBlockerId('obs-ktm-spf');
Wichtig: Bei Ihnen kann der Code ähnlich, aber anders lauten! - unter „Script-Blocker Konfiguration“, „Service Opt-in Script-Tag“ den Script-Tag kopieren und für später ablegen (im folgenden Screenshot markiert).
In diesem Beispiel mit der oben gewählten ID lautet der Script-Tag:<script>window.BorlabsCookie.Unblock.unblockScriptBlockerId('obs-ktm-spf');</script>
.
Wichtig: Bei Ihnen kann der Code ähnlich, aber anders lauten!
- unter „Script-Blocker Konfiguration“, „Content-Blocker Global-JavaScript“ den Script-Tag kopieren und für später ablegen (im folgenden Screenshot markiert).

2. Provider & Service anlegen
- Borlabs: Consent-Managemeint -> Provider öffnen
- Provider anlegen unter „Neu hinzufügen“: KTM als Bereitsteller des Spare Part Finders
- Borlabs: Consent-Managemeint -> Services öffnen
- Service anlegen unter „Neu hinzufügen“ unter „Externe Medien“: KTM Spare Parts Finder anlegen, Status auf aktiv setzen, als Provider den gerade angelegten Provider KTM auswählen, unter „Zusätzliche Einstellungen“ die Option „Cookies vor der Einwilligung blockieren“ aktivieren
- Den Script-Blocker mit dem Service verknüpfen: Unter „HTML & JavaScript“ im ersten Feld „Opt-in-Code“ den vom Script-Blocker gespeicherten Code „Service Opt-in Script-Tag“ einfügen.
- „Alle Einstellungen speichern“ klicken

3. Content-Blocker erstellen
- Borlabs: Blocker -> Content-Blocker öffnen
- „Neu hinzufügen“, ID und Name ausfüllen (z.B. ID:
obs-ktm-spf-connector
und Name:KTM SPF Connector
, Status auf aktiv setzen - Als Service den eben angelegten Service KTM Spare Parts Finder auswählen
- Als Provider den eben angelegten Provider KTM auswählen
- unter „Vorschau gesperrter Inhalte“ -> „Voreinstellung“ entweder „Voreinstellung A – Standard“ (für Blocker ohne Vorschaubild) oder „Voreinstellung B – Standard-Hintergrundbild“ (für Blocker mit Vorschaubild) wählen und den Button „Voreinstellung anwenden“ darunter klicken. Bei gewähltem Hintergrundbild noch ein Bild (z.B. Screenshot des SPF) hochladen und nochmals „Voreinstellung anwenden“
- unter „JavaScript“ -> „Global“ im Text-Editor den vom Script-Blocker gespeicherten Code „Content-Blocker Global-JavaScript“ einfügen
- „Alle Einstellungen speichern“ klicken
- oben rechts, neben der ID des Content-Blockers wird jetzt unter „Wissenswertes“ ein Shortcode angezeigt, diesen Shortcode für den nächsten Schritt kopieren

4. SPF-Block mit Content-Blocker einbinden
Um den Block des SPFs nur mit Content-Blocker-Freigabe zu laden, wird der SPF-Block im Editor in den eben kopierten Shortcode des Content-Blockers eingefasst:
- Im Editor der Seite, auf der der Spare Parts Finder angezeigt werden soll, zwei „Shortcode“-Blöcke einfügen: Im ersten Shortcode-Block den ersten Teil des Shortcodes, die ersten
[]
, hier im Beispiel:[borlabs-cookie id="obs-ktm-spf-connector" type="content-blocker"]
.
Im zweiten Shortcode den hinteren Teil des Shortcodes, die zweiten[]
:[/borlabs-cookie]
.
Den Teil „URL“ weg lassen - zwischen den beiden Shortcode-Blöcken – statt der „URL“ – den Block „KTM Spare Parts Finder“ einfügen, mit dem der Ersatzteilkatalog geladen wird.
- Die Seite speichern und testen, ob der KTM Spare Parts Finder blockiert wird und freigeschaltet werden kann
