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 ungültigen oder abgelaufenen API-Tokens:

1. Token prüfen: Gehe zu Einstellungen > Tracking und prüfe, ob alle Felder korrekt ausgefüllt sind.
2. Token erneuern: Manche Plattformen (z.B. Meta) haben Tokens mit begrenzter Gültigkeit. Generiere in diesem Fall einen neuen Token im jeweiligen Werbe-Manager.
3. Berechtigungen: Stelle sicher, dass der Token die nötigen Berechtigungen hat (z.B. "Conversions API" bei Meta).
4. Erneut speichern: Manchmal hilft es, die Credentials 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 — Token-Berechtigungen: Stelle sicher, dass der API-Token die nötigen Schreibberechtigungen hat und nicht abgelaufen ist. Bei Meta und TikTok: Prüfe ob der Token noch gültig ist.

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 erscheinen nicht bei Meta

Im Webhook-Only Modus können Cart-Events (AddToCart) nicht an Meta gesendet werden, da Shopify bei Cart-Webhooks keine Kundendaten mitliefert. Meta erfordert 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, sendet das Pixel keine Events. Prüfen Sie die Consent-Konfiguration.
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.