JavaScript-API (neue Version)

Überblick

Mit der JavaScript-API von Pandectes können Sie programmgesteuert aus dem Theme Ihres Shops oder aus eigenen Skripten mit dem Einwilligungsbanner interagieren. Auch ohne selbst komplexen Code zu schreiben, hilft Ihnen ein Überblick über die API dabei zu wissen, was möglich ist und wann Sie eine Entwicklerin oder einen Entwickler mit der Umsetzung beauftragen sollten.
Diese Funktion steht beim neuen Banner zur Verfügung und ist über Settings → JavaScript API erreichbar.

Was können Sie mit der JavaScript-API tun?

Den aktuellen Einwilligungsstatus eines Besuchers auslesen

Über die API weiß Ihr Shop jederzeit in Echtzeit, wozu ein Besucher eingewilligt hat. Sie können prüfen:

• ob ein Besucher Analyse-Tracking erlaubt hat (zum Beispiel Google Analytics, Microsoft Clarity)
• ob ein Besucher Marketing-Cookies erlaubt hat (zum Beispiel Facebook Pixel, TikTok)
• ob ein Besucher Cookies für Präferenzen und Funktionalität erlaubt hat
• die vollständige Einwilligungsentscheidung des Besuchers als ein einziges Objekt

Das ist nützlich, wenn sich andere Teile Ihres Shops je nach Zustimmung des Besuchers unterschiedlich verhalten sollen.

Den Einwilligungsdialog steuern

Die API ermöglicht es Ihnen, den Einwilligungsdialog von jeder Aktion in Ihrem Shop aus zu öffnen oder zu schließen, zum Beispiel über eine Schaltfläche im Footer, einen Link auf der Seite mit der Datenschutzerklärung oder einen eigenen Eintrag "Cookie-Einstellungen" in Ihrem Menü. Das ergänzt die eingebaute Menülink-Funktion und gibt Entwicklern mehr Freiheit, den Dialog von jedem beliebigen Element der Seite aus auszulösen.

Einwilligungen programmgesteuert setzen oder aktualisieren

In fortgeschrittenen Szenarien kann Ihr Shop die Einwilligungsentscheidung eines Besuchers direkt setzen, zum Beispiel wenn ein Besucher seine Entscheidung über eine selbst gebaute Oberfläche trifft oder wenn die Einwilligung über einen anderen Mechanismus erfasst und an Pandectes übergeben werden muss.

Die Sprache des Banners ändern

Über die API lässt sich die Sprache des Einwilligungsdialogs dynamisch umschalten. Wenn Ihr Shop Besucher in mehreren Sprachen bedient und deren Präferenz erkennt, kann der Banner in der richtigen Sprache erscheinen, ohne allein auf die Standardsprache des Browsers angewiesen zu sein.

Auf Einwilligungsereignisse reagieren

Die API kann Ihren Shop in dem Moment informieren, in dem etwas rund um die Einwilligung geschieht, zum Beispiel:

• wenn der Banner vollständig geladen und bereit ist
• wenn der Besucher den Einwilligungsdialog öffnet
• wenn der Einwilligungsdialog geschlossen wird
• wenn der Besucher seine Einwilligungspräferenzen ändert oder absendet

So können Sie Abläufe bauen, die unmittelbar auf die Entscheidung eines Besuchers reagieren, etwa das Laden eines Tracking-Skripts in dem Moment, in dem die Einwilligung erteilt wird, ohne die Seite neu laden zu müssen.

Für wen ist das gedacht?

Die JavaScript-API richtet sich an Händler mit einer Entwicklerin oder einem Entwickler oder an Shops mit einem eigenen Storefront. Sie müssen die API nicht nutzen oder verstehen, damit der Banner funktioniert. Er arbeitet von Haus aus vollständig eigenständig. Wenn Sie den Einwilligungsbanner jedoch enger mit dem übrigen Verhalten Ihres Shops verzahnen möchten, ist die API das richtige Werkzeug.

Erste Schritte

Um die API zu erkunden und die vollständige Referenz zu sehen, gehen Sie in der Pandectes-App zu Settings → JavaScript API. Die Seite enthält die komplette Liste der verfügbaren Eigenschaften, Funktionen und Ereignisse mit Beschreibungen. Wenn Sie Unterstützung bei einem konkreten Anwendungsfall brauchen, wenden Sie sich gerne an unser Supportteam.

Aktualisiert am: 22/09/2026