OBS Plugins » OBS KTM SPF Connector » OBS KTM SPF Connector: Content-Blocker für externes KTM-Skript

OBS KTM SPF Connector: Content-Blocker für externes KTM-Skript

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

  1. Borlabs: Blocker -> Script Blocker öffnen
  2. „Neu hinzufügen“, ID und Name ausfüllen (z.B. ID: obs-ktm-spf und Name: KTM Spare Parts Finder).
  3. Seite auswählen, auf der der SPF Block verbaut ist, Scan-Modus: Gast, Suchphrase oneboxshop-ktm-spf-connector-webcomponent eingeben, „Scannen starten“
  4. Passendes, gefundenes Handle zum Blockieren auswählen
  5. Status unter der ID auf aktiv setzen, Script Blocker erstellen mit „Alle Einstellungen speichern“
  6. 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!

2. Provider & Service anlegen

  1. Borlabs: Consent-Managemeint -> Provider öffnen
  2. Provider anlegen unter „Neu hinzufügen“: KTM als Bereitsteller des Spare Part Finders
  3. Borlabs: Consent-Managemeint -> Services öffnen
  4. 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
  5. 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.
  6. „Alle Einstellungen speichern“ klicken

3. Content-Blocker erstellen

  1. Borlabs: Blocker -> Content-Blocker öffnen
  2. „Neu hinzufügen“, ID und Name ausfüllen (z.B. ID: obs-ktm-spf-connector und Name: KTM SPF Connector, Status auf aktiv setzen
  3. Als Service den eben angelegten Service KTM Spare Parts Finder auswählen
  4. Als Provider den eben angelegten Provider KTM auswählen
  5. 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“
  6. unter „JavaScript“ -> „Global“ im Text-Editor den vom Script-Blocker gespeicherten Code „Content-Blocker Global-JavaScript“ einfügen
  7. „Alle Einstellungen speichern“ klicken
  8. 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:

  1. 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
  2. zwischen den beiden Shortcode-Blöcken – statt der „URL“ – den Block „KTM Spare Parts Finder“ einfügen, mit dem der Ersatzteilkatalog geladen wird.
  3. Die Seite speichern und testen, ob der KTM Spare Parts Finder blockiert wird und freigeschaltet werden kann

Inhalt

Hilfecenter: