Skip to main content

​
Überblick

Dieser Leitfaden hilft dir bei der Fehlerbehebung in Situationen, in denen sich Upcart nicht öffnet oder Kunden zur Warenkorbseite weitergeleitet werden, statt den Upcart-Drawer zu sehen. Die meisten dieser Probleme werden durch die Warenkorbtyp-Einstellungen des Themes, die Konfiguration von Enhanced AJAX API Compatibility, Weiterleitungen von Drittanbieter-Apps oder das Routing des Checkout-Buttons verursacht.
Wenn sich Upcart überhaupt nicht öffnet oder zur Warenkorbseite weiterleitet, findest du unter Fehlerbehebung: Upcart öffnet sich nicht oder leitet zur Warenkorbseite weiter einen umfassenderen Leitfaden zur Fehlerbehebung.

​
Welchen Warenkorbtyp du wählen solltest

Bevor du mit der Fehlerbehebung beginnst, überprüfe zuerst die Warenkorbtyp-Einstellung deines Themes, da dies die häufigste Ursache ist.
  • Page – Dies ist in der Regel die beste Option, da Upcart Anfragen an die /cart-Seite abfängt.
  • Drawer – Wähle diese Option, wenn Upcart nicht startet und stattdessen die /cart-Seite ausgelöst wird.
  • Confirmation Popup – Verwende diese Option, wenn dein Theme sie unterstützt und die anderen Optionen das Problem nicht lösen.
Beide Optionen zu testen dauert nur wenige Minuten, aber Page ist typischerweise die effektivste Wahl.

​
So änderst du den Warenkorbtyp in deinem Theme

  1. Gehe in deinem Shopify-Admin zu Online Store > Themes > Customize.
  2. Öffne Theme Settings > Cart > Cart Type.
  3. Wähle je nach dem Verhalten, das du beheben möchtest, entweder Page oder Drawer.
  4. Speichere deine Änderungen und teste den Warenkorb in deinem Storefront.
Warenkorb-Einstellungen im Shopify-Theme-Editor mit der Option für den Warenkorbtyp
Wenn du diese Einstellung nicht finden kannst, kontaktiere deinen Theme-Entwickler. Diese Einstellung wird von deinem Theme gesteuert und Upcart kann sie nicht direkt ändern.

​
Schritte zur Fehlerbehebung

Wenn das Ändern des Warenkorbtyps das Problem nicht löst, arbeite die folgenden Schritte der Reihe nach durch.

​
1. Enhanced AJAX API Compatibility überprüfen

Diese Einstellung steuert, wie Upcart Add-to-Cart-Ereignisse handhabt, und ist eine der häufigsten Ursachen für Weiterleitungsprobleme.
  1. Gehe zu Upcart > Cart Editor > Settings > Cart settings und klappe dann Advanced Settings auf.
  2. Suche Enhanced Ajax API compatibility.
  3. Diese Einstellung ist für die meisten Stores standardmäßig deaktiviert. Wenn sie deaktiviert ist, fängt Upcart Add-to-Cart-Aufrufe ab und verhindert Weiterleitungen.
  4. Wenn sie aktiviert ist, können andere Apps die Kontrolle über das Warenkorbverhalten übernehmen und Kunden zur Warenkorbseite weiterleiten. Versuche, sie zu deaktivieren, und teste.
  5. Wenn das Deaktivieren andere Probleme verursacht, aktiviere sie wieder und verwende stattdessen die manuelle Upcart-API (upcartRegisterAddToCart).
Eine vollständige Anleitung zu dieser Einstellung findest du unter Enhanced AJAX API Compatibility.

​
2. Auf Weiterleitungen durch Drittanbieter-Apps prüfen

Viele Drittanbieter-Apps überschreiben das Warenkorbverhalten und können Kunden vom Upcart-Drawer wegleiten. Wenn dein Add-to-Cart-Button Kunden gezielt zur Warenkorbseite schickt, findest du unter Warum führt „Add to Cart“ zur Warenkorbseite statt zu Upcart? weitere Details. Öffne die Einstellungen aller warenkorbbezogenen Apps und suche nach Optionen wie:
  • Redirect to cart
  • Go to cart after add
  • Automatically open cart page
  • Action after product is added
Ändere diese auf Stay on page oder Do nothing. Häufige app-spezifische Lösungen:
  • PageFly – Deaktiviere Weiterleitungsregeln in den PageFly-App-Einstellungen.
  • Globo Product Options – Deaktiviere die automatische Weiterleitung zum Shopify-Warenkorb.
  • Replo – Passe die „go to page“-Einstellungen an, um den Cart Drawer zu aktivieren.
  • Zepto Product Personalizer – Gehe zu Zepto > Settings > Add to Cart Settings und ändere „Action after a product is added to the cart“ auf „Stay on the product page and show a success message.“
Wenn du unsicher bist, welche App den Konflikt verursacht, deaktiviere die warenkorbbezogenen Apps nacheinander und teste nach jeder, bis Upcart korrekt funktioniert.

​
3. Routing des Checkout-Buttons überprüfen

Wenn Kunden auf den Checkout-Button in Upcart klicken und zur Warenkorbseite statt zum Checkout weitergeleitet werden:
  1. Gehe zu Upcart > Cart Editor > Settings > Cart settings.
  2. Suche “Go to cart page when pressing checkout button”.
  3. Schalte diese Option AUS.
  4. Speichere und teste.
Die Weiterleitung zu einer benutzerdefinierten Checkout-Seite erfordert fortgeschrittene Programmierung und wird von Upcart nicht direkt unterstützt. Wenn du Kunden zu einer benutzerdefinierten Checkout-Seite leiten musst, musst du mit einem Entwickler zusammenarbeiten.

​
4. Weiterleitungseinstellungen des Theme-Warenkorbs überprüfen

Manche Themes leiten Kunden nach dem Hinzufügen eines Produkts automatisch weiter und umgehen Upcart dabei vollständig.
  1. Gehe zu Online Store > Themes > Customize.
  2. Öffne Theme Settings > Products (oder Cart).
  3. Suche nach Einstellungen wie:
    • Enable cart redirection
    • Redirect to cart after add
    • Go to cart after add
  4. Schalte diese AUS.
  5. Speichere und teste.

​
5. Browser-Cache leeren

Alte zwischengespeicherte Skripte können früheres Warenkorbverhalten beibehalten und verhindern, dass Upcart korrekt lädt.
  1. Öffne deine Browser-Einstellungen.
  2. Gehe zu Datenschutz und Sicherheit.
  3. Wähle Browserdaten löschen.
  4. Lösche zwischengespeicherte Bilder, Dateien und Cookies.
  5. Aktualisiere deinen Store und teste.

​
6. Mit einem Standard-Shopify-Theme testen

Wenn das Problem weiterhin besteht, wechsle vorübergehend zu einem Standard-Shopify-Theme wie Dawn, um einen theme-spezifischen Konflikt auszuschließen.
  1. Gehe zu Shopify Admin > Online Store > Themes.
  2. Füge ein kostenloses Theme wie Dawn hinzu und aktiviere es.
  3. Teste Upcart mit dem Standard-Theme.
Wenn Upcart mit Dawn korrekt funktioniert, liegt das Problem an deinem benutzerdefinierten Theme. Kontaktiere deinen Theme-Entwickler für Unterstützung.

​
Vorbeugende Maßnahmen

  • Konfigurationen nach Updates überprüfen – Theme- und App-Updates können Warenkorbeinstellungen zurücksetzen oder überschreiben. Überprüfe deinen Warenkorbtyp und deine App-Konfigurationen nach jedem größeren Update.
  • App-Kompatibilität vor der Installation testen – Bevor du neue Drittanbieter-Apps hinzufügst, stelle sicher, dass sie mit Upcart kompatibel sind.
  • Ein Draft-Theme zum Testen verwenden – Teste Änderungen auf einem Draft-Theme, bevor du sie veröffentlichst, um Störungen deines Live-Stores zu vermeiden. Eine Anleitung findest du unter Upcart nur in einem Draft-Theme aktivieren.

​
Häufig gestellte Fragen

Nein, die Weiterleitung zu einer benutzerdefinierten Checkout-Seite erfordert fortgeschrittene Programmierung und wird von Upcart nicht direkt unterstützt. Wenn du das brauchst, musst du mit einem Entwickler zusammenarbeiten.
Stelle sicher, dass Upcart im Cart Editor aktiv und veröffentlicht ist. Leere außerdem deinen Browser-Cache, damit das aktualisierte Verhalten wirksam wird. Wenn das Problem weiterhin besteht, prüfe mit den obigen Schritten auf Konflikte mit Drittanbieter-Apps.
Öffne die Einstellungen der Add-on-App und suche nach Konfigurationen für automatische Weiterleitungen oder „go to cart“. Deaktiviere sie, wenn sie mit Upcart in Konflikt stehen. App-spezifische Beispiele findest du in Schritt 2 oben.
Brauchst du Hilfe? Wenn du alle obigen Schritte durchgearbeitet hast und das Problem weiterhin besteht, wende dich an unser Support-Team über den In-App-Chat oder per E-Mail an support@upcart.app.