Artikel über: Einstellungen
Dieser Artikel ist auch verfügbar in:

Eigenes Storefront

Übersicht


Pandectes funktioniert auch auf Headless- und individuellen Shopify-Storefronts: Hydrogen, Next.js oder jedes Frontend, das Sie mit der Storefront API bauen. Statt der Theme-App-Einbindung fügen Sie einige Skripte in Ihren Storefront ein. Das Banner erfasst dann die Einwilligung und übergibt sie an die Customer Privacy API von Shopify, die sie auf Analysen, Pixel und Checkout von Shopify anwendet.


Wie Sie es installieren, hängt von Ihrem Framework ab. Hydrogen 2026.10 oder neuer lädt die Consent-Werkzeuge von Shopify über ShopifyScripts automatisch, daher unterscheidet sich die Einrichtung von älteren Hydrogen-Versionen und anderen Frameworks. Dieser Artikel behandelt beide.


Bevor Sie beginnen


  • Plan: Die Aktivierung der Unterstützung für individuelle Storefronts erfordert den Tarif Premium. Die Installationsschnipsel und die Einstellungen Access token & domains erfordern den Tarif Enterprise.
  • Banner version: folgen die Schnipsel dem Banner, das Ihr Shop verwendet (Legacy-Banner oder das neue Banner). Banner v2 hat einen zusätzlichen Schnipsel für den Seitenkörper.
  • Your framework version: bei Hydrogen prüfen Sie die Version @shopify/hydrogen in Ihrem package.json.


Unterstützung für individuelle Storefronts aktivieren


  1. Gehen Sie zu Shopify Admin > Apps > Pandectes GDPR Compliance > All settings und öffnen Sie Custom/Headless support.
  2. Klicken Sie auf Enable.
  3. Die Seite zeigt jetzt die Banner snippets und die Widget-Schnipsel, die Sie kopieren können.


Wenn Sie die Einstellungen auf dieser Seite speichern, veröffentlicht Pandectes außerdem die Einstellungsdatei Ihres Shops. Wenn Sie die Banner-Einstellungen später ändern, übernimmt der Storefront sie aus dieser Datei.


Wählen Sie Ihre Einrichtung


Ihr Storefront

Anleitung

Hydrogen 2026.10 oder neuer, mit ShopifyScripts

Hydrogen 2026.10 oder neuer

Hydrogen vor 2026.10, Next.js oder ein anderes individuelles Frontend

Älteres Hydrogen und andere Frameworks


Hydrogen 2026.10 oder neuer


ShopifyScripts lädt die Customer Privacy API von Shopify und wartet im Modus custom-banner auf Ihr Consent-Banner, bevor Analyseereignisse freigegeben werden. Pandectes teilt ihr mit, wenn sich der Besucher entschieden hat.


  1. Kopieren Sie in Banner snippets den Code aus Step 1 in den <head> Ihres Root-Layouts, vor <ShopifyScripts>.
  2. Skip the consent-tracking-api script tag am Anfang des Schnipsels. ShopifyScripts lädt die Customer Privacy API bereits, und eine zweite Kopie ersetzt die von Hydrogen.
  3. Nur Legacy-Banner auf Hydrogen 2026.10.0 bis 2026.10.2: Entfernen Sie die Auskommentierung der Zeile <script>window.pandectesShopifyScripts = true;</script>. Ab 2026.10.3 erkennt Pandectes Hydrogen selbstständig. Banner v2 benötigt diese Zeile nicht.
  4. Banner v2 only: fügen Sie den Schnipsel Step 2 (<pandectes-cmp>) direkt nach dem öffnenden <body>-Tag ein. Siehe Banner-v2-Komponente.
  5. Setzen Sie den Consent-Modus von ShopifyScripts auf custom-banner, mit einem setup, der auf Pandectes wartet:


<ShopifyScripts
consent={{
mode: 'custom-banner',
setup: () =>
new Promise((resolve) => {
const tick = () =>
window.Pandectes?.whenDecided
? window.Pandectes.whenDecided().then(() => resolve())
: setTimeout(tick, 50);
tick();
}),
}}
/>


  1. Entfernen Sie alte Consent-Konfigurationen aus Ihrer Hydrogen-App: checkoutDomain, storefrontAccessToken und withPrivacyBanner, die an Analysen oder useCustomerPrivacy übergeben werden.
  2. Lassen Sie Storefront access token, Storefront root domain und Checkout root domain in Pandectes leer. Shopify verwendet sie in dieser Einrichtung nicht.


Verwenden Sie mode: 'default-banner' nicht. Es zeigt den eigenen Datenschutzhinweis von Shopify neben dem Pandectes-Banner an.


Pandectes.whenDecided() wird aufgelöst, sobald Shopify die Entscheidung des Besuchers kennt. Auf einer Seite, auf der das Banner nicht fragt (etwa wenn das Banner ausgeschaltet ist oder der Besucher außerhalb der von Ihnen ausgewählten Regionen liegt), wird sofort mit dem aufgelöst, was Shopify gespeichert hat. In jedem Fall sendet Hydrogen Analyseereignisse nur, wenn Shopify Analysen für diesen Besucher erlaubt.


Bei Hydrogen 2026.10 folgt der Checkout der neuesten Entscheidung des Besuchers: Der Checkout-Link trägt die aktuelle Einwilligung, sodass eine Änderung nach einem ersten Besuch im Checkout auch dort ankommt.


Wenn Ihre App eine Content-Security-Policy sendet, erlauben Sie https://*.pandect.es für Skripte, Verbindungen und Bilder. Wenn Ihr Banner ein in Pandectes hochgeladenes Logo anzeigt, erlauben Sie zusätzlich das CDN Ihres Shops für Bilder.


Älteres Hydrogen und andere Frameworks


Bei Hydrogen vor 2026.10, Next.js und anderen individuellen Frontends lädt Ihr Storefront die Customer Privacy API von Shopify selbst.


  1. Kopieren Sie in Banner snippets den Code aus Step 1 so weit oben wie möglich in den <head> jeder Seite, einschließlich des Skript-Tags consent-tracking-api.
  2. Banner v2 only: fügen Sie den Schnipsel Step 2 direkt nach dem öffnenden <body>-Tag ein.
  3. Füllen Sie in Access token & domains die Felder aus, die Shopify benötigt, um die Einwilligung zwischen Ihrem Storefront und dem Checkout zu teilen. Siehe Zugriffstoken und Domains.
  4. Klicken Sie auf Save.


Bei Hydrogen-Versionen vor 2026.10 behält der Checkout von Shopify die Einwilligung, die er beim ersten Checkout-Besuch des Besuchers gesehen hat, und ignoriert spätere Änderungen im Storefront. Das ist das Verhalten von Shopify und keine Pandectes-Einstellung. Ein Upgrade auf Hydrogen 2026.10 und die oben beschriebene Einrichtung beheben das.


Zugriffstoken und Domains


Diese Felder gelten nur für Storefronts, die die Customer Privacy API von Shopify selbst laden. Bei Hydrogen 2026.10 oder neuer mit ShopifyScripts lassen Sie alle drei leer.


Feld

Was Sie eintragen

Storefront access token

Ihr öffentliches Storefront-API-Zugriffstoken aus dem Verkaufskanal Headless (oder Hydrogen) im Shopify-Admin.

Storefront root domain

Die Root-Domain Ihres Storefronts, zum Beispiel hydrogen.shop. Leer lassen, um die Standard-Seitendomain zu verwenden.

Checkout root domain

Die Domain Ihres Checkouts, zum Beispiel checkout.hydrogen.shop. Leer lassen, wenn Sie live sind.


Banner-v2-Komponente


Banner v2 wird über ein Element <pandectes-cmp> dargestellt, das Sie direkt nach dem öffnenden <body>-Tag platzieren. Die Attribute:


  • data-locale: zweistelliger Sprachcode der Seite. Erforderlich.
  • data-region: der Ländercode oder Bundesstaatscode des Besuchers, zum Beispiel IT, US oder USCA. Erforderlich, wenn Sie Use Pandectes Geo-IP database ausschalten.
  • data-customer: die ID des angemeldeten Kunden, gespeichert zusammen mit seiner Einwilligung. Optional.
  • data-preview: true oder false, um den Admin-Modus zu berücksichtigen. Optional.


Country/state detection (nur Banner v2): Wenn Use Pandectes Geo-IP database eingeschaltet ist, erkennt Pandectes Land und Bundesstaat des Besuchers selbst. Wenn Sie es ausschalten, übergeben Sie die Region über data-region aus Ihrem Framework.


Widgets hinzufügen


Die Seite enthält außerdem Schnipsel für die Seiten EU Withdrawal, Customer data requests, Do not sell my data und Cookies declaration. Fügen Sie jeden Schnipsel auf der Seite ein, auf der das Widget erscheinen soll.


Bei Hydrogen 2026.10 oder neuer lassen Sie auch in diesen Schnipseln das Skript-Tag consent-tracking-api weg.


Im Storefront prüfen


  1. Öffnen Sie Ihren Storefront in einem privaten Fenster. Das Banner wird angezeigt.
  2. Wählen Sie Accept oder Reject.
  3. Öffnen Sie die Browser-Konsole und führen Sie aus:


Shopify.customerPrivacy.currentVisitorConsent()


Sie sollte yes oder no für Analyse, Marketing und Präferenzen anzeigen, passend zu Ihrer Auswahl.


  1. Bei Hydrogen 2026.10 oder neuer führen Sie außerdem aus:


Pandectes.whenDecided().then(console.log)


Sie gibt die Entscheidung aus, die Shopify hat.


  1. Legen Sie ein Produkt in den Warenkorb, gehen Sie zum Checkout, kehren Sie zum Storefront zurück, ändern Sie Ihre Auswahl und gehen Sie erneut zum Checkout. Bei Hydrogen 2026.10 oder neuer folgt der Checkout der neuen Auswahl.


Verwandte Artikel


Aktualisiert am: 13/11/2026

War dieser Beitrag hilfreich?

Teilen Sie Ihr Feedback mit

Stornieren

Danke!