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/hydrogenin Ihrempackage.json.
Unterstützung für individuelle Storefronts aktivieren
- Gehen Sie zu
Shopify Admin > Apps > Pandectes GDPR Compliance > All settingsund öffnen Sie Custom/Headless support. - Klicken Sie auf Enable.
- 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 | |
Hydrogen vor 2026.10, Next.js oder ein anderes individuelles Frontend |
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.
- Kopieren Sie in Banner snippets den Code aus Step 1 in den
<head>Ihres Root-Layouts, vor<ShopifyScripts>. - Skip the
consent-tracking-apiscript tag am Anfang des Schnipsels.ShopifyScriptslädt die Customer Privacy API bereits, und eine zweite Kopie ersetzt die von Hydrogen. - 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. - Banner v2 only: fügen Sie den Schnipsel Step 2 (
<pandectes-cmp>) direkt nach dem öffnenden<body>-Tag ein. Siehe Banner-v2-Komponente. - Setzen Sie den Consent-Modus von
ShopifyScriptsaufcustom-banner, mit einemsetup, 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();
}),
}}
/>
- Entfernen Sie alte Consent-Konfigurationen aus Ihrer Hydrogen-App:
checkoutDomain,storefrontAccessTokenundwithPrivacyBanner, die an Analysen oderuseCustomerPrivacyübergeben werden. - Lassen Sie Storefront access token, Storefront root domain und Checkout root domain in Pandectes leer. Shopify verwendet sie in dieser Einrichtung nicht.
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.
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.
- 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-Tagsconsent-tracking-api. - Banner v2 only: fügen Sie den Schnipsel Step 2 direkt nach dem öffnenden
<body>-Tag ein. - 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.
- Klicken Sie auf Save.
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 |
Checkout root domain | Die Domain Ihres Checkouts, zum Beispiel |
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 BeispielIT,USoderUSCA. Erforderlich, wenn Sie Use Pandectes Geo-IP database ausschalten.data-customer: die ID des angemeldeten Kunden, gespeichert zusammen mit seiner Einwilligung. Optional.data-preview:trueoderfalse, 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
- Öffnen Sie Ihren Storefront in einem privaten Fenster. Das Banner wird angezeigt.
- Wählen Sie Accept oder Reject.
- Ö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.
- 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.
- 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
- Funktioniert die App auf Headless-Shops?
- So prüfen Sie, dass Pandectes mit der Customer Privacy API von Shopify funktioniert
- So arbeitet die App mit der Customer Privacy API von Shopify
Aktualisiert am: 13/11/2026
Danke!
