Fehlerbehebung

Events werden nicht im Dashboard angezeigt

Wenn du keine Events im Dashboard siehst, prüfe folgende Punkte:

1. Web Pixel aktiv? Gehe zu Shopify Admin > Einstellungen > Customer Events und stelle sicher, dass ShopiPixel als "Verbunden" angezeigt wird.
2. Zeitraum prüfen: Stelle sicher, dass der richtige Zeitraum im Dashboard ausgewählt ist. Standardmäßig werden die letzten 24 Stunden angezeigt.
3. Cache leeren: Öffne deinen Shop in einem Inkognito-Fenster und navigiere durch ein paar Seiten. Events sollten nach 1-2 Minuten erscheinen.
4. App-Version: Stelle sicher, dass die App aktuell ist. Deinstalliere und installiere das Web Pixel neu, falls nötig.

Der Tracking Debugger zeigt dir für jede Plattform ob Events erfolgreich ankommen.

Plattform zeigt "Verbindungsfehler"

Wenn eine Plattform einen Verbindungsfehler meldet, liegt das meist an einer unterbrochenen Verbindung oder unvollständigen Zugangsdaten:

1. Verbindung prüfen: Gehe zu Einstellungen > Tracking und prüfe, ob die Plattform als "Verbunden" markiert ist bzw. alle Felder korrekt ausgefüllt sind.
2. Neu verbinden: Bei OAuth-Plattformen (Meta, TikTok, Pinterest, LinkedIn, Google Ads, Microsoft Ads) klicke auf "Neu verbinden" und autorisiere ShopiPixel erneut, falls die Berechtigung widerrufen wurde.
3. Berechtigungen: Stelle sicher, dass dein Konto die nötigen Berechtigungen hat (z.B. Admin- oder Operator-Rechte für das Werbekonto).
4. Erneut speichern: Bei manuell konfigurierten Plattformen (GA4, Klaviyo, Custom Webhook) hilft es manchmal, die Zugangsdaten erneut einzugeben und zu speichern.

Events kommen bei der Werbeplattform nicht an

Wenn Events im ShopiPixel Dashboard erscheinen, aber nicht in der Werbeplattform:

1. Verzögerung: Manche Plattformen zeigen Events erst nach 15-30 Minuten an. Warte etwas ab.
2. Test-Event senden: Verwende die Test-Funktion im Meta Events Manager oder im entsprechenden Plattform-Tool.
3. Event-Match-Quality: Im ShopiPixel Health-Dashboard siehst du die EMQ pro Plattform. Bei Meta kannst du die EMQ zusätzlich im Events Manager prüfen. ShopiPixel sendet automatisch alle verfügbaren Parameter für optimale Zuordnung.
4. Deduplizierung: ShopiPixel verwendet automatische Deduplizierung. Wenn du gleichzeitig Browser-Pixel und Server-Side Events aktiv hast, werden doppelte Events automatisch entfernt.

Events werden empfangen, aber nicht verarbeitet

Wenn die Plattform Events empfängt, diese aber nicht korrekt zuordnet oder verarbeitet:

1. Google Ads — Enhanced Conversions Methode: Unter Ziele > Einstellungen > Enhanced conversions for web muss als Methode "Google Ads API" ausgewählt sein. Wenn "Google Tag" gewählt ist, werden per API gesendete Events nicht verarbeitet.
2. Google Ads — Conversion-Aktion: Die Conversion-Aktion sollte als "Primär" markiert sein, damit sie für Smart Bidding verwendet wird. Zusätzlich müssen die Google Data Processing Terms akzeptiert sein.
3. LinkedIn — Conversion-Typ: Die Conversion Rule muss den Typ "Conversions API" haben. Regeln mit anderem Typ können keine API-Events empfangen.
4. Microsoft Ads — Conversion Goal: Ein Conversion Goal muss existieren und mit dem UET Tag verknüpft sein. Ohne Goal werden Events zwar empfangen, aber nicht für Reporting oder Bidding verwendet.
5. Allgemein — Verbindung & Berechtigungen: Stelle sicher, dass die Verbindung zur Plattform aktiv ist und die nötigen Schreibberechtigungen hat. Bei OAuth-Plattformen (z.B. Meta, TikTok) klicke bei Bedarf in den Einstellungen auf "Neu verbinden".

Detaillierte Anleitungen für jede Plattform findest du unter Plattform-Einrichtung.

Purchase-Events fehlen

Purchase-Events werden primär über Shopify Webhooks erfasst:

1. Webhook-Status prüfen: Gehe zu Shopify Admin > Einstellungen > Benachrichtigungen > Webhooks. ShopiPixel sollte dort registriert sein.
2. Testbestellung: Erstelle eine Testbestellung in deinem Shop und prüfe nach 2-3 Minuten, ob der Purchase-Event erscheint.
3. App neu autorisieren: Deinstalliere und installiere ShopiPixel erneut, um die Webhooks neu zu registrieren.

Dashboard lädt nicht oder ist langsam

1. Browser-Cache leeren: Drücke Strg+Shift+R (Windows) oder Cmd+Shift+R (Mac) für einen Hard Refresh.
2. Anderen Browser testen: Manche Browser-Extensions können die App beeinträchtigen.
3. Zeitraum einschränken: Ein kleinerer Zeitraum (z.B. "Heute" statt "Letzten 30 Tage") lädt schneller.

Order-Limit erreicht

Wenn du das Order-Limit deines Plans erreichst:

• Du wirst bei 80% per E-Mail und In-App-Banner benachrichtigt. Bei 100% wird die Benachrichtigung immer angezeigt. Du kannst die 80%-Benachrichtigungen in den Overage-Einstellungen deaktivieren.
• Option 1: Plan upgraden -- Wechsle zu einem höheren Plan mit mehr Orders und Features
• Option 2: Overage aktivieren -- Bei kostenpflichtigen Plänen kannst du Overage aktivieren (gestaffelt nach Plan, z.B. $13 per 1,000 orders im Scale-Plan). Alle Overage-Preise findest du auf der Preisseite

Mehr dazu unter Abrechnung.

Cart-Events werden im Webhook-Only Modus nicht zugeordnet

Im Webhook-Only Modus lassen sich Cart-Events (AddToCart) keiner Kampagne zuordnen, da Shopify bei Cart-Webhooks keine Kundendaten mitliefert. Werbeplattformen benötigen mindestens einen Nutzer-Identifier (E-Mail, Telefon, IP oder Click-ID).

1. Purchase- und Checkout-Events sind nicht betroffen — diese enthalten volle Kundendaten von Shopify
2. Lösung: Aktiviere den Dual-Track Modus unter Tracking-Einstellungen. Das Web Pixel erfasst Browser-Cookies und Click-IDs für Cart-Events
3. TikTok, Pinterest, Snapchat und GA4 empfangen Cart-Events auch im Webhook-Only Modus — nur die Zuordnungsqualität ist geringer

Pixel wird als inaktiv angezeigt

Das Dashboard zeigt ein Banner, dass das Web-Pixel keine Events sendet.

1. Ad-Blocker prüfen: Browser-Erweiterungen können das Web-Pixel blockieren. Testen Sie in einem Inkognito-Fenster ohne Erweiterungen.
2. App-Embed aktiviert? Prüfen Sie in den Shopify Theme-Einstellungen unter App-Embeds ob ShopiPixel aktiviert ist.
3. Theme-Kompatibilität: Einige Drittanbieter-Themes laden App-Embeds nicht korrekt. Kontaktieren Sie den Theme-Entwickler.
4. Consent-Banner: Wenn Ihr Consent-Banner das Tracking standardmäßig ablehnt oder das Signal nicht an Shopify Customer Privacy meldet, sendet das Pixel keine Events. Die anonyme Blockrate im Consent-Dashboard (ab Growth-Plan) zeigt Ihnen, wie viele Seitenaufrufe mangels Banner nicht erfasst werden. Den Live-Test Ihres Banners finden Sie auch im Onboarding-Schritt „Consent-Banner prüfen".
5. Automatischer Schutz: ShopiPixel erkennt den Ausfall automatisch und stellt auf Webhook-Only um, damit keine Daten verloren gehen. Sobald das Pixel wieder funktioniert, wird der Dual-Track-Modus automatisch wiederhergestellt.

Offline-Abschluss erscheint nicht bei der Plattform

Ein erfasster Deal wurde zwar von ShopiPixel akzeptiert, kommt aber z.B. nicht im Meta Events Manager an.

1. Lookback-Fenster geprüft? Meta akzeptiert nur Deals der letzten 7 Tage, Snapchat ebenfalls 7 Tage. Für ältere Deals nutze Google Ads (90 Tage), TikTok (180 Tage), Microsoft Ads (30 Tage Default-Goal-Window) oder LinkedIn (90 Tage).
2. Kein Match trotz vorhandener E-Mail: Das Click-ID-Matching funktioniert nur, wenn ShopiPixel innerhalb der letzten 90 Tage ein form_submitted-Event mit derselben E-Mail gesehen hat (LeadCapture-Tabelle). Ohne Click-ID UND ohne vorherigen Kontakt kann die Plattform den Deal nicht einer Kampagne zuordnen.
3. Credential invalid: Öffne Einstellungen > Tracking und prüfe ob die Plattform als „Verbunden" markiert ist. Bei OAuth-Plattformen (Google Ads, Microsoft Ads) kann der Refresh-Token ablaufen — folge dem „Neu verbinden"-Button.
4. Symbole im Match-Feedback: ✓ sent = erfolgreich, ⚠ skipped_too_old = außerhalb Lookback, ○ not_configured = Plattform nicht verbunden, ✗ error = Versand fehlgeschlagen (vorübergehende Fehler werden automatisch wiederholt), ⏳ pending = Dispatch läuft gerade.
5. Enterprise-Plan aktiv? Offline-Deals sind ausschließlich im Enterprise-Plan verfügbar. Prüfe den Plan in der Abrechnung.

Vollständige Anleitung inkl. Form-Feld-Naming-Hinweise siehe Offline-Abschlüsse-Guide.

Event-Trigger feuert nicht

Du hast einen Custom Event mit Trigger konfiguriert, aber im Live-Events-Feed erscheint nichts.

1. Trigger-Typ passt zum Setup? click-Trigger lesen nur Element-IDs (id="..."), keine CSS-Klassen oder Selektoren. form_submit-Trigger lesen nur das name-Attribut (<form name="...">). Für komplexere Bedingungen nutze Shopify-Webhook-Mapping oder Flow Action.
2. Plattform-Mapping gesetzt? Nur Plattformen mit hinterlegter Event-Name-Zuordnung empfangen das Custom Event. Prüfe den Wizard-Schritt 2 (Per-Platform-Mapping) und nutze ggf. „Smart-Defaults auf alle anwenden".
3. Consent erteilt? Der Trigger feuert nur, wenn der Besucher Marketing-Consent erteilt hat (Shopify Customer Privacy marketingAllowed=true).
4. Webhook-Mapping: Wenn du Shopify-Webhook-Topics (orders/create etc.) zu Custom Events zugeordnet hast, prüfe unter Event-Trigger > Webhooks ob der Topic korrekt gemappt ist.
5. Flow-Action-Setup: In der Shopify-Flow-Action musst du das Custom Event im Dropdown auswählen — danach erscheint eine in die App-Bridge eingebettete Config-Page. Ohne Auswahl sendet der Workflow nichts.

Schritt-für-Schritt-Anleitung für den Wizard siehe Event-Trigger-Guide.