Shopify Scripts-Anforderungen und -Einschränkungen

Es sind einige Shopify Scripts-Einschränkungen vorhanden, um die Sicherheit zu erhöhen und sicherzustellen, dass Skripte ausgeführt werden können, unabhängig davon, wie viele Kunden zu einem bestimmten Zeitpunkt deinen Shop nutzen. Beachte die folgenden Einschränkungen, wenn du Skripte für deinen Shopify-Shop entwickelst.

Auf dieser Seite

Online-Shop und Storefront-API

Wenn du ein Skript erstellst oder bearbeitest, kannst du auswählen, ob es nur in deinem Onlineshop oder in deinem Onlineshop und in den folgenden Apps ausgeführt werden soll:

Benutzerdefinierte Apps, die mit der Storefront-API, dem JavaScript Buy SDK oder den Mobile Buy SDKs (Android und iOS) erstellt wurden
Benutzerdefinierte Apps, die Checkouts generieren
Mobile App Builder für Tapcart und Plobal Apps

Damit Skripte funktionieren, muss deine Website über eine integrierte Warenkorbfunktionalität verfügen. Du kannst also keine Skripte mit Buy Buttons oder dem Vertriebskanal Facebook und Instagram von Meta verwenden.

Veröffentliche Skripte

Es kann nur ein Skript pro Skripttyp gleichzeitig veröffentlicht werden. Du kannst beispielsweise ein Skript für Einzelartikel und ein Skript für Versandkosten veröffentlichen, aber zwei Skripte für Einzelartikel können nicht gleichzeitig veröffentlicht werden.

Maximale Anzahl von Shopify Scripts

Du kannst bis zu 200 Shopify Scripts erstellen.

Bestellentwürfe

Skripte für Positionen, Versandtarife und Zahlungen funktionieren nicht mit Bestellentwürfen oder dem Checkout von Bestellentwürfen.

Metafelder

Shopify Scripts kann nicht auf Metafelder zugreifen.

Warenkorb-/Checkout-Attribute

Shopify Scripts können nicht auf Warenkorbattribute von Shopify Liquid zugreifen. Du kannst diese Attribute zu deinen Warenkorbseiten hinzufügen, um zusätzliche Informationen von deinen Kunden zu erfassen, aber du kannst kein Skript erstellen, das diese verwendet.

Rabattcodes

Skripte können darauf zugreifen, ob ein Rabattcode angewendet wird, den Betrag des Rabatts und die Art des Rabatts, z. B. Festbetrag, Prozentsatz oder Versand. Skripte haben keinen Zugriff darauf, wie der Rabattcode angewendet wird, z. B. ob er warenkorb- oder positionsspezifisch ist. Das bedeutet, dass Skripte keinen Zugriff auf Gesamtsummen nach dem Rabatt oder automatische Rabatte haben.

Skripte für Position und Versand, die auf Rabatte zugreifen, die auf einen Warenkorb angewendet werden, sind nicht mit Rabattkombinationen kompatibel. Die .discount_code-Methode kann nuru einen einzelnen Rabattcode zurückgeben. Warenkörbe, die mehrere Rabattcodes mit Rabattkombinationen enthalten, werden nicht unterstützt.

Positionen

Skripte können keine Artikel zum Warenkorb hinzufügen oder den Preis eines Artikels erhöhen.

Versandkosten

Skripte können den Preis eines Versandtarifs nicht erhöhen.

Mehrere Währungen

Deine Skripte funktionieren mit mehreren Währungen möglicherweise nicht wie erwartet. Um sicherzustellen, dass deine Skripte für Warenkörbe oder Checkouts funktionieren, die in einer anderen Währung als der primären Währung deines Shops angegeben sind, musst du deine Skripte zu Shopify Functions migrieren.

Reguläre Ausdrücke

Der Abgleich regulärer Ausdrücke wird nicht unterstützt. Wenn du ein Positionsskript erstellst, kannst du möglicherweise eine der folgenden Methoden als Zwischenlösung verwenden:

split Methode
start_with und end_with-Methoden
include Methode

Themes

Du musst unter Umständen das Liquid-Theme aktualisieren, damit es deine Skripte unterstützt und du, was noch wichtiger ist, die Kunden nicht verwirrst. So zeigen beispielsweise nicht alle Themes im Warenkorb Rabatte für Positionen an. Falls dies der Fall ist, musst du das Theme entsprechend bearbeiten, damit im Warenkorb die Rabatte für Positionen angezeigt werden. Erfahre mehr über die Modifizierungsarten, die du in den Liquid-Themes anwenden kannst.

Ressourcen

Die für ein Skript verfügbare CPU- und Speicherkapazität ist begrenzt. Die reservierten Ressourcen hängen von der Größe des Warenkorbs und der Anzahl der Berechnungen ab, die das Skript benötigt. Shopify verfolgt diese Einschränkungen sorgfältig, um sicherzustellen, dass dein Skript wie vorgesehen funktioniert.

Wenn du ein Skript testest, druckt die Script Editor-Konsole den Prozentsatz der zugewiesenen Ressourcen, die das Skript verwendet.

Input/Output

Abgesehen von einigen wenigen Ausnahmen sind Shopify Scripts nicht für Input/Output geeignet. Dies bedeutet, dass Skripte keine Webanforderungen oder Datenbankaufrufe ausführen können und darüber hinaus keinen Input von einem Benutzer erhalten können.

Die puts-Methode kann angewandt werden, um in der Script Editor-App Texte auf der Konsole zu drucken.

Zeit und Zufälligkeit

Skripte können keine zufälligen oder zeitbasierten Berechnungen beinhalten. Auf das Time-Objekt und die rand-Methode kann nicht von Shopify Scripts zugegriffen werden.

Da bei jeder Neuberechnung einer Warenkorbsumme Skripte ausgeführt werden, können auf Zeit oder Generierung eines Zufallswertes basierende Skripte unvorhersehbare oder verwirrende Ergebnisse erzeugen, wenn Kunden ihren Warenkorb häufig ändern. Du kannst jedoch mit der Launchpad-App die Ausführung von Skripten während Ereignissen planen.

Skript-Zeichenbeschränkung

Du kannst Skripte mit einer maximalen Länge von 40 960 Zeichen erstellen.

Abonnementbestellungen

Wenn deine Positions- und Versandskripte einen Rabatt für ein Abonnementprodukt erstellen, gilt der Rabatt für die folgenden Zahlungen:

nur die erste Zahlung einer pro Lieferung bezahlten Bestellung; wird nicht auf geplante Bestellungen angewendet
den gesamten Betrag einer im Voraus bezahlten Abonnementbestellung

Mehr Informationen zu Abonnements und Skripten.

Beschleunigte Checkouts

Wenn du Shopify Scripts für beschleunigte Checkouts verwendest, werden Versandrabatte angewendet, nachdem dein Kunde eine beschleunigte Zahlungsmethode ausgewählt hat. Aus diesem Grund werden Änderungen am Bestellpreis nicht auf dem Gerät oder im Browser des Kunden widergespiegelt. Kunden sehen den ursprünglichen Preis beim beschleunigten Checkout, ihnen wird jedoch der richtige reduzierte Preis berechnet.

Shopify Point of Sale (POS)

Shopify Scripts funktionieren nicht mit Shopify Point of Sale (POS).

Zahlungs-Gateways umbenennen

Du kannst Zahlungs-Gateways, die Bilder oder Logos beinhalten, die als der Name des Gateways angezeigt werden, nicht umbenennen. Zahlungs-Gateways mit Logo-Bildern neben dem Namen können nicht umbenannt werden.

Aufgeteilter Versand beim Checkout

Versand-Skripte sind im Shopify-Checkout nicht mit dem aufgeteilten Versand kompatibel. Wenn du Versand-Skripte verwendest und aufgeteilten Versand aktivierst, werden deinen Kunden beim Checkout keine aufgeteilten Lieferungen angezeigt.