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

Key Takeaways

• Shopifys Customer Events API (Einstellungen → Kundenereignisse → Benutzerdefinierten Pixel hinzufügen) ist der richtige Ort für das 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, was theme.liquid-Skripte nicht können.
• Du schreibst Standard-JavaScript im Custom Pixel Editor – es ist keine Shopify-spezifische Syntax erforderlich.

Custom Event Tracking zeigt dir, was Käufer tatsächlich in deinem Shop tun – nicht nur, welche Seiten sie besuchen, sondern wann sie Produkte in den Warenkorb legen, den Checkout starten oder deine Dankesseite erreichen. Die Customer Events API von Shopify macht dies trackbar, ohne dass du in den Theme-Code eingreifen musst.

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 entlang der gesamten Customer Journey eine Reihe von Standard-Events bereit. Dein Custom Pixel kann auf jedes davon reagieren:

Page-Events:

• page_viewed — wird bei jedem Seitenaufruf ausgelöst

Produkt-Events:

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

Checkout-Events:

• checkout_started — wird ausgelöst, wenn der Checkout beginnt
• checkout_address_info_submitted — wird ausgelöst, wenn die Adresse eingegeben wird
• checkout_shipping_info_submitted — wird ausgelöst, wenn die Versandart ausgewählt wird
• payment_info_submitted — wird ausgelöst, wenn die Zahlungsinformationen eingegeben werden
• 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 angesehene Produkt, den Warenkorbwert zu Beginn des Checkouts, die Bestellsumme bei Abschluss.

Mehr dazu: Checkout.liquid in Shopify Plus bearbeiten.

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 nach Abschluss des Checkouts:

Verwandt: Google Tag Manager zu Shopify hinzufügen.

Verwandt: Custom JavaScript in Shopify hinzufügen.

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 Pixels verfügbar.

Browserseitige Meta-Events wie dieses werden durch Ad-Blocker und iOS-Datenschutzeinstellungen gefiltert. Kombiniere sie daher mit Server-Side Tracking – siehe Shopify Meta Conversions API Setup für diese Hälfte.

Schritt für Schritt ein benutzerdefiniertes Pixel einrichten

Schritt 1 - Gehe zu Einstellungen → Kundenereignisse

Schritt 2 - Klicke auf Benutzerdefiniertes Pixel hinzufügen

Schritt 3 - Vergib einen Namen (z. B. “GA4 Custom Events” oder “Meta Purchase Event”)

Schritt 4 - Schreibe dein JavaScript im Code-Bereich unter Verwendung von analytics.subscribe()

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

• Nicht erforderlich — wird bei allen Besuchern unabhängig von ihrer Zustimmung ausgelöst
• Präferenzen — erfordert Zustimmung für Analytics
• Analytics — erfordert Zustimmung für Analytics
• Marketing — erfordert Zustimmung für Marketing

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

Um Ergebnisse zu messen, siehe Tracking-Skripte in Shopify hinzufügen.

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 bietet im Bereich “Kundenereignisse” vorgefertigte Integrationen für Google Analytics, Google Ads, Meta, TikTok, Snapchat und andere. Diese übernehmen automatisch das standardmäßige Purchase-Tracking.

Verwende Custom Pixels, wenn:

• Du Events tracken musst, die von der Standardintegration nicht abgedeckt werden (z. B. spezifische Button-Klicks, Scroll-Tiefe, benutzerdefinierte 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 Standardintegrationen 80 % der Anforderungen ab. Custom Pixels schließen die Lücken.

FAQ