hello@datascale.de+49 89 921 35 623cookiefrei getrackt · /openDEEN

Suchen Sie nach Leistungen, Integrationen und Blog-Beiträgen.

DatascaleRessourcenShopify Custom-Pixel-Vorlage

Kostenlos · Vorlage zum Mitnehmen

Shopify Custom-Pixel-Vorlage plus GTM-Container

Das kommentierte Custom-Pixel-Skript für Shopify Web Pixels mit CONFIG-Block, dazu Web- und Server-Container importfertig. Der Ersatz für checkout.liquid, das am 26. August 2026 abgeschaltet wird.

Der komplette Custom Pixel für Shopify Web Pixels, kommentiert und mit einem CONFIG-Block oben, dazu Web- und Server-Container als importfertiges JSON. Gebaut für Shops, die vor dem 26. August aus checkout.liquid heraus müssen und dabei die Attribution nicht verlieren wollen.

Warum jetzt

Ab dem 26. August 2026 feuern checkout.liquid und das Feld Additional Scripts für Basic-, Shopify- und Advanced-Stores nicht mehr. Tracking, das dort hängt, hört an diesem Tag auf zu arbeiten, ohne Fehlermeldung und ohne Rückfrage. Web Pixels über Kundenereignisse sind danach der einzige unterstützte Weg.

Der Umzug allein reicht aber nicht. Der Custom Pixel läuft in einer Sandbox, und drei ihrer Eigenheiten kosten Daten, wenn man sie nicht kennt.

Was die Vorlage löst

  • Die iframe-URL in GA4. document.location liefert in der Sandbox die URL der iframe, nicht die des Shops. Die Vorlage liest event.context.window.location.
  • Die frische client_id pro Kauf. document.cookie wirft in der Sandbox einen SecurityError. Ohne Zugriff auf _ga bekommt jeder Kauf eine neue Identität, und die Attribution zerfällt. Die Vorlage liest über browser.cookie.get().
  • Verlorene Add-to-Carts. Der App-generierte Pixel lädt seinen Code per fetch und abonniert die Ereignisse erst nach dem Netzwerk-Roundtrip. Was vorher passiert, ist weg, und bei Adblockern fällt alles aus. Die Vorlage abonniert synchron.
  • Doppelte Käufe. Browser- und Server-Event sind dasselbe Event. Ohne gemeinsame transaction_id zählt GA4 beide. Die Vorlage setzt eine einheitliche Order-ID in allen Pfaden.
  • Shop Pay und Express. Beide verlieren client-seitig die client_id über die Domain-Grenze. Die Vorlage holt sie über Cart-Attribute zurück.

Was drin ist

DateiInhalt
custom-pixel.jsDas vollständige Skript, kommentiert, mit CONFIG-Block für Measurement-ID, Server-Endpunkt und Consent-Gruppen
web-container.jsonWeb-GTM-Container, importfertig, inklusive Trigger und Variablen
server-container.jsonServer-Container mit GA4- und Meta-CAPI-Tags plus Consent-Mapping
qa-checkliste.mdDie Prüfschritte, mit denen Sie beweisen, dass es zählt

So gehen Sie vor

  1. CONFIG-Block ausfüllen, Measurement-ID und Server-Endpunkt eintragen.
  2. Skript im Shopify-Admin unter Kundenereignisse als Custom Pixel anlegen.
  3. Beide Container importieren, Consent-Gruppen an Ihr CMP anpassen.
  4. Testbestellung im Inkognito-Modus, purchase mit transaction_id muss genau einmal ankommen.
  5. Nach 48 Stunden GA4-Bestellzahl gegen Shopify prüfen, Abweichung sollte im niedrigen einstelligen Bereich liegen.

Die ausführliche Herleitung mit allen Fallstricken steht im Begleitartikel: Shopify Server-Side Tracking mit Stape.

Vorlage anfordern

Arbeits-E-Mail eintragen, die Dateien kommen per Mail. Soft-Gate, keine Wand, der Artikel bleibt vollständig lesbar.

Zuletzt aktualisiert:

Alle Ressourcen →

Häufige Fragen

Was passiert am 26. August 2026 genau?

Für Basic-, Shopify- und Advanced-Stores hören checkout.liquid und das Feld Additional Scripts auf zu feuern. Tracking, das dort hängt, fällt ohne Vorwarnung aus. Web Pixels über Kundenereignisse sind danach der einzige unterstützte Weg. Plus-Stores hatten eine eigene Frist, prüfen Sie Ihren Plan im Shopify-Admin.

Brauche ich Stape dafür?

Nein. Die Vorlage schreibt in den dataLayer und an einen Server-Container; ob der bei Stape, auf Cloud Run oder auf einem eigenen Server läuft, ist der Vorlage egal. Der CONFIG-Block trägt die Endpunkt-URL, sonst ändert sich nichts.

Warum landet ohne die Vorlage die falsche URL in GA4?

Der Custom Pixel läuft in einer Sandbox-iframe. Wer dort document.location liest, bekommt die iframe-URL statt der Seite, die der Kunde sieht. Die Vorlage liest event.context.window.location. Denselben Grund hat der Cookie-Zugriff: document.cookie wirft in der Sandbox einen SecurityError, _ga muss über browser.cookie.get() kommen, sonst entsteht pro Kauf eine frische client_id.

Deckt die Vorlage Consent ab?

Sie feuert consent-gated und liest den Zustand aus Shopifys Customer-Privacy-API. Die Banner-Logik selbst bleibt bei Ihrem CMP. Server-Side ändert, wo Tags laufen, nicht ob Einwilligung gebraucht wird.

Ist das eine Rechtsberatung?

Nein. Die Vorlage ist technisches Handwerkszeug. Die datenschutzrechtliche Bewertung sollte mit qualifizierten Beratern erfolgen.

Danach: funktioniert es auch?

Der Tracking-Check prüft Tracking, Consent und Security-Header live gegen Ihre Seite.

Tracking-Check starten →

Von der Vorlage zum Setup

Dokumentiert ist nicht gemessen.

Wenn die Vorlage Lücken zeigt, verdrahtet die Measurement-Leistung sie mit Abnahmekriterium.