Skip to main content

Übersicht

Hier findest du Antworten auf einige der häufigsten Fragen zur Nutzung der Upcart-API.

Wo füge ich Upcart-API-Skripte hinzu?

Du kannst Skripte in Upcarts Custom-HTML-Einstellungen oder direkt in deinem Shopify-Theme-Code hinzufügen. Die beste Option hängt von deinen Anpassungsbedürfnissen ab.

Wie verwende ich Upcarts Custom HTML?

  1. Navigiere zu Upcart → Settings → Custom HTML
  2. Verwende API-Skripte, um das Warenkorbverhalten zu ändern, etwa den Zeitpunkt des Öffnens oder die Anzeige von Upsells
  3. Passe Elemente außerhalb von Upcart an, etwa das Ausblenden von Buttons auf der Produktseite

💡 Beispiel: Den Sticky-Cart-Button ausblenden, wenn der Warenkorb leer ist

Hinweis zu Legacy-Callbacks: window.upcartOnCartLoaded-Callbacks funktionieren weiterhin, sind aber veraltet und geben Konsolen-Warnungen aus. Verwende für alle neuen Skripte upcartSubscribeCartLoaded. Beachte, dass event.cart keine item_count-Eigenschaft hat — verwende event.cart.items.reduce((total, item) => total + item.quantity, 0), um die Gesamtanzahl der Artikel zu berechnen.

Muss ich Entwickler sein, um die Upcart-API zu nutzen?

Nein! Die Upcart-API ist auch ohne Programmierkenntnisse einfach zu nutzen. Viele Funktionen sind integriert, und unsere Anpassungs-Dokumentation enthält vorgefertigte Skripte, die du in Upcarts Custom-HTML-Einstellungen kopieren kannst — ganz ohne Programmieren! Wenn du eigene Skripte schreiben möchtest, helfen grundlegende JavaScript-Kenntnisse. Wenn JavaScript neu für dich ist, keine Sorge! Diese einsteigerfreundlichen Ressourcen — W3Schools und MDN Web Docs — helfen dir beim Einstieg.

Kann sich die Upcart-API mit anderen Drittanbieter-Apps integrieren?

Ja! Die Upcart-API funktioniert mit Apps für Übersetzungen, Analytics, Upsells und mehr. Manche integrieren sich automatisch, andere benötigen möglicherweise ein kleines Skript. Wenn du zum Beispiel TripleWhale für das Tracking verwendest, musst du das folgende Skript hinzufügen, damit die Warenkorbaktivität korrekt erfasst wird:
Hinweis zu Legacy-Callbacks: window.upcartOnAddToCart-Callbacks funktionieren weiterhin, sind aber veraltet und geben Konsolen-Warnungen aus. Verwende für alle neuen Skripte upcartSubscribeAddedToCart. Beachte, dass die Ereignis-Eigenschaften auf event.item liegen (mit variantId und quantityAdded) und nicht als separate Parameter übergeben werden.
Da jede App anders ist, frage beim Support-Team deiner App nach, ob zusätzlicher Code nötig ist. Upcart bietet keinen Skript-Support für Drittanbieter-Apps, aber dein App-Anbieter hat möglicherweise eine Integrationsanleitung.

Wie teste ich, ob meine API-Änderungen funktionieren?

Nachdem du ein Skript in Upcarts Custom-HTML-Einstellungen hinzugefügt hast, folge diesen Schritten, um sicherzustellen, dass es funktioniert:
  1. Aktualisiere deinen Shop und lege einen Artikel in den Warenkorb.
  2. Leere deinen Cache und versuche es erneut, um die neuesten Änderungen zu sehen.
  3. Füge eine Testnachricht hinzu: Füge console.log("The script works!"); vor </script> ein, um zu prüfen, ob dein Skript ausgeführt wird.
  4. Prüfe deine Browser-Konsole:
    • Öffne die Dev Tools (F12 oder Ctrl + Shift + J unter Windows, Cmd + Option + J auf dem Mac).
    • Gehe zum Tab Console und suche nach “The script works!”
    • Wenn du die Nachricht siehst, läuft dein Skript! Falls nicht, wird das Skript möglicherweise nicht korrekt ausgeführt.
  5. Teste verschiedene Aktionen (z. B. das Entfernen eines Artikels), um das erwartete Verhalten sicherzustellen.
Behebe Probleme, indem du auf Tippfehler oder Konsolenfehler prüfst und den Code bei Bedarf anpasst.

Was mache ich, wenn ein API-Skript nicht funktioniert?

Wenn dein API-Skript nicht funktioniert, probiere diese Schritte zur Fehlerbehebung:
  • Prüfe auf Tippfehler – Schon kleine Fehler können ein Skript zerstören. Suche nach fehlenden Zeichen oder falscher Syntax.
  • Überprüfe die Skript-Platzierung – Stelle sicher, dass das Skript im richtigen Abschnitt unter Upcart → Settings → Custom HTML liegt. Upcart hat zehn Skript-Abschnitte (neun HTML-Einfügepunkte plus einen Scripts-before-load-Abschnitt) — Sieh dir diese Abschnitte hier an.
  • Prüfe die Browser-Konsole – Folge den obigen Schritten, um nach Fehlern zu suchen.
  • Teste ein anderes Skript – Probiere ein anderes vorgefertigtes Upcart-API-Skript aus, um zu sehen, ob das Problem an deinem Code liegt.
  • Kommst du nicht weiter? – Wenn du dein Shopify-Theme änderst oder Drittanbieter-Apps integrierst, kann dir ein Shopify-Experte aus dem Shopify Partner Directory helfen.
Mit diesen Schritten solltest du die meisten Skript-Probleme identifizieren und lösen können!

Wie mache ich Änderungen rückgängig, wenn ein Skript etwas kaputt macht?

Wenn du ein Skript hinzufügst, das nicht wie erwartet funktioniert, kannst du es ganz einfach entfernen oder deaktivieren:
  • Gehe zu Upcarts Custom-HTML-Einstellungen, wo das Skript hinzugefügt wurde.
  • Entferne das Skript oder deaktiviere es vorübergehend, indem du // an den Anfang jeder Zeile setzt (das macht sie zu einem Kommentar und verhindert die Ausführung).
  • Speichere die Änderungen & aktualisiere deinen Shop, um zu prüfen, ob das Problem behoben ist.
Wenn das Problem weiterhin besteht, versuche, deinen Cache zu leeren oder kürzliche Theme-Änderungen rückgängig zu machen — das löst oft versteckte Konflikte.
🚧 Suchst du erweiterte Anpassungen? Brauchst du shop-weite Anpassungen oder Integrationen mit Drittanbieter-Apps? Möglicherweise benötigst du einen Entwickler, der die Upcart-API in dein Shopify-Theme einbaut. Ziehe in Betracht, einen Shopify-Experten über das Shopify Partner Directory zu beauftragen, und teile unsere API-Dokumentation mit ihm, um Unterstützung zu erhalten