So fügen Sie benutzerdefinierte Events in Shopify hinzu (2026)

Das Wichtigste in Kürze

• Die Customer Events API von Shopify (Einstellungen → Kundenereignisse → Benutzerdefiniertes Pixel hinzufügen) ist der richtige Ort fürs Custom Event Tracking.
• Zu den Standard-Shopify-Events gehören page_viewed, product_viewed, product_added_to_cart und checkout_completed.
• Custom Pixels laufen in einer Sandbox-Umgebung mit Zugriff auf alle Checkout-Events – etwas, das theme.liquid-Skripte nicht können.
• Im Custom Pixel Editor schreibst du ganz normales JavaScript – es ist keine Shopify-spezifische Syntax erforderlich.

Custom Event Tracking verrät dir, was Käufer in deinem Shop tatsächlich tun – nicht nur, welche Seiten sie besuchen, sondern auch, wann sie Produkte in den Warenkorb legen, den Checkout starten oder auf der Dankesseite landen. Mit der Customer Events API von Shopify lässt sich das tracken, ohne im Theme-Code herumzuwühlen.

Wie füge ich Events in Shopify hinzu?

Gehen Sie zu Einstellungen → Kundenereignisse → Benutzerdefiniertes Pixel hinzufügen. Dies öffnet einen JavaScript-Editor, in dem Sie Code schreiben, der auf die Standard-Events von Shopify hört und als Reaktion Ihren eigenen Tracking-Code ausführt.

Zum Messen der Ergebnisse siehe Add Tracking Scripts to Shopify.

Standard-Events von Shopify

Shopify stellt eine Reihe von Standard-Events entlang der Shopping Journey bereit. Dein Custom Pixel kann auf jedes dieser Events hören:

Page-Events:

• page_viewed — wird bei jedem Laden einer Seite ausgelöst

Produkt-Events:

• product_viewed — wird ausgelöst, wenn eine Produktseite aufgerufen wird
• product_added_to_cart — wird ausgelöst, wenn ein Artikel in den Warenkorb gelegt wird
• search_submitted — wird ausgelöst, wenn eine Suchanfrage abgeschickt wird

Checkout-Events:

• checkout_started — wird ausgelöst, wenn der Checkout beginnt
• checkout_address_info_submitted — wird ausgelöst, wenn die Adresse eingegeben wurde
• checkout_shipping_info_submitted — wird ausgelöst, wenn die Versandart ausgewählt wurde
• payment_info_submitted — wird ausgelöst, wenn Zahlungsinformationen eingegeben wurden
• checkout_completed — wird auf der Bestellbestätigungsseite ausgelöst
• order_created — wird ausgelöst, wenn eine Bestellung erfolgreich aufgegeben wurde

Diese Events enthalten kontextbezogene Daten — das aufgerufene Produkt, der Warenkorbwert zu Beginn des Checkouts, der Gesamtbetrag der Bestellung beim Abschluss.

Passend dazu: So passen Sie die checkout.liquid in Shopify Plus an (2026).

Ein benutzerdefiniertes Pixel schreiben

Hier ist ein einfaches Beispiel, das ein GA4-Event sendet, wenn ein Produkt in den Warenkorb gelegt wird:

analytics.subscribe('product_added_to_cart', (event) => {
  const cartLine = event.data.cartLine;

  // Send to GA4 via dataLayer (if GTM is installed)
  window.dataLayer = window.dataLayer || [];
  window.dataLayer.push({
    event: 'add_to_cart',
    ecommerce: {
      currency: cartLine.merchandise.product.vendor,
      items: [{
        item_id: cartLine.merchandise.sku,
        item_name: cartLine.merchandise.product.title,
        price: cartLine.cost.totalAmount.amount,
        quantity: cartLine.quantity
      }]
    }
  });
});

Und für ein Meta-Pixel Purchase-Event beim Checkout-Abschluss:

Passend dazu: So fügen Sie den Google Tag Manager zu Shopify hinzu (2026).

Passend dazu: So fügen Sie benutzerdefiniertes JavaScript in Shopify hinzu (2026).

analytics.subscribe('checkout_completed', (event) => {
  const order = event.data.checkout;

  fbq('track', 'Purchase', {
    value: order.totalPrice.amount,
    currency: order.currencyCode,
    content_ids: order.lineItems.map(item => item.variant.sku),
    content_type: 'product'
  });
});

Wichtig: Die Funktion analytics.subscribe() wird von Shopifys Sandbox-Umgebung bereitgestellt. Du musst sie nicht importieren — sie ist automatisch in allen Custom Pixeln verfügbar.

Schritt für Schritt ein benutzerdefiniertes Pixel einrichten

Schritt 1 - Gehe zu Einstellungen → Kunden-Events

Schritt 2 - Klicke auf Benutzerdefiniertes Pixel hinzufügen

Schritt 3 - Gib ihm einen Namen (z. B. „GA4 Custom Events“ oder „Meta Purchase Event“)

Schritt 4 - Schreibe im Bereich „Code“ dein JavaScript mithilfe von analytics.subscribe()

Schritt 5 - Lege die Berechtigungsstufe für den Datenschutz fest:

• Nicht erforderlich — wird für alle Besucher ausgelöst, unabhängig von der Einwilligung
• Präferenzen — erfordert Einwilligung für Analytics
• Statistik — erfordert Einwilligung für Analytics
• Marketing — erfordert Einwilligung für Marketing

Wähle für das Purchase-Tracking „Marketing“, wenn du Daten an Werbeplattformen sendest, oder „Statistik“ für GA4.

Um Ergebnisse zu messen, siehe add tracking scripts to shopify.

Schritt 6 - Klicke auf Speichern und dann auf Verbinden

Testen Ihres benutzerdefinierten Pixels

Der integrierte Debugger von Shopify. Im Editor für Kundenereignisse gibt es einen Live-Event-Feed, der ausgelöste Events in Echtzeit anzeigt. Öffnen Sie Ihren Storefront in einem anderen Tab und surfen Sie ein wenig herum – Sie sollten sofort page_viewed-Events sehen.

Browser-Konsole. Da benutzerdefinierte Pixel in einem Sandboxed-Iframe laufen, können Sie deren console.log-Ausgaben nicht direkt sehen. Nutzen Sie stattdessen das Debugger-Panel von Shopify.

GA4 DebugView. Gehen Sie in Ihrer GA4-Property auf Konfigurieren → DebugView. Lösen Sie Events in Ihrem Storefront aus und beobachten Sie, wie sie in Echtzeit erscheinen.

Benutzerdefinierte Events vs. Standard-App-Integrationen

Shopify hat vorgefertigte Integrationen für Google Analytics, Google Ads, Meta, TikTok, Snapchat und andere im Bereich Kundenereignisse (Customer Events). Diese übernehmen das Standard-Purchase-Tracking automatisch.

Verwende benutzerdefinierte Pixel, wenn:

• Du Events tracken musst, die die Standard-Integration nicht abdeckt (z. B. bestimmte Button-Klicks, Scrolltiefe, eigene Funnel-Schritte)
• Du Events an eine weniger verbreitete Analytics-Plattform senden musst
• Du zusätzliche benutzerdefinierte Daten zusammen mit Standard-Events senden möchtest (z. B. Customer Lifetime Value, Produktkategorie)

Für die meisten Shops decken die Standard-Integrationen 80 % des Bedarfs ab. Benutzerdefinierte Pixel füllen die Lücken.

FAQ