JavaScript-API (neue Version)

Übersicht

Die Pandectes JavaScript API ermöglicht es Ihnen, programmatisch mit dem Einwilligungsbanner aus dem Theme Ihres Stores oder aus eigenen Skripten zu interagieren. Ohne komplizierten Code hilft Ihnen das Verständnis dessen, was die API bietet, dabei zu erkennen, was möglich ist, und zu wissen, wann Sie einen Entwickler um die Umsetzung bitten sollten.
Diese Funktion ist im Tarif New Banner verfügbar und über All settings > JavaScript API erreichbar.

Was können Sie mit der JavaScript API tun?

Den aktuellen Einwilligungsstatus des Besuchers auslesen

Die API ermöglicht es Ihrem Store, jederzeit in Echtzeit zu wissen, wozu ein Besucher seine Einwilligung gegeben hat. Sie können prüfen:

• Ob ein Besucher Analyse-Tracking erlaubt hat (z. B. Google Analytics, Microsoft Clarity)
• Ob ein Besucher Marketing-Cookies erlaubt hat (z. B. Facebook Pixel, TikTok)
• Ob ein Besucher Präferenz- bzw. Funktionscookies erlaubt hat
• Die vollständige Einwilligungsentscheidung des Besuchers als einzelnes Objekt

Das ist nützlich, wenn andere Bereiche Ihres Stores sich abhängig davon verhalten sollen, wozu der Besucher zugestimmt hat.

Den Einwilligungsdialog steuern

Die API ermöglicht es Ihnen, den Einwilligungsdialog von jeder Aktion in Ihrem Store aus zu öffnen oder zu schließen. Zum Beispiel über eine Schaltfläche im Footer, einen Link auf einer Datenschutzseite oder eine eigene Option "Cookie-Einstellungen" in Ihrem Menü. Dies funktioniert zusätzlich zur integrierten Menülink-Funktion und gibt Entwicklern mehr Flexibilität, den Dialog von jedem Element der Seite aus auszulösen.

Einwilligung programmatisch setzen oder aktualisieren

In fortgeschrittenen Szenarien kann Ihr Store die Einwilligungsentscheidung eines Besuchers direkt setzen. Zum Beispiel, wenn ein Besucher seine Wahl über eine eigene Benutzeroberfläche trifft oder wenn die Einwilligung über einen anderen Mechanismus erfasst und an Pandectes übergeben werden muss, damit sie angewendet wird.

Die Sprache des Banners ändern

Die API ermöglicht es, die Sprache des Einwilligungsdialogs dynamisch umzuschalten. Wenn Ihr Store Besucher in mehreren Sprachen bedient und deren Präferenz erkennt, kann der Banner in der richtigen Sprache angezeigt werden, ohne sich allein auf die Standardeinstellung des Browsers zu verlassen.

Auf Einwilligungsereignisse reagieren

Die API kann Ihren Store sofort benachrichtigen, wenn etwas Einwilligungsrelevantes passiert, 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

Das bedeutet, dass Sie Abläufe erstellen können, die unmittelbar auf die Entscheidung eines Besuchers reagieren. Zum Beispiel das Laden eines Tracking-Skripts in dem Moment, in dem die Einwilligung erteilt wird, ohne dass die Seite neu geladen werden muss.

Für wen ist das?

Die JavaScript API richtet sich an Händler mit einem Entwickler oder an Betreiber eines individuellen Storefronts. Für die Funktion des Banners müssen Sie die API nicht verwenden oder verstehen, er arbeitet von Haus aus vollständig eigenständig. Wenn Sie jedoch eine tiefere Integration zwischen dem Einwilligungsbanner und dem restlichen Verhalten Ihres Stores wünschen, ist die API das richtige Werkzeug.

Erste Schritte

Um die API kennenzulernen und die vollständige Referenz einzusehen, navigieren Sie in der Pandectes-App zu All settings > JavaScript API. Die Seite enthält die vollständige Liste der verfügbaren Eigenschaften, Funktionen und Ereignisse mit Beschreibungen. Wenn Sie Unterstützung bei der Umsetzung eines bestimmten Anwendungsfalls benötigen, wenden Sie sich gern an unser Support-Team.

Aktualisiert am: 27/10/2026