Modifikatoren

Übersicht #

Mit Modifiers können Sie Daten nach dem Sync ändern, ohne Ihren Datenfeed anzupassen oder einen Entwickler einzubeziehen. Modifiers unterstützen derzeit Products, Categories, Customers und Pages.

Modifiers werden von oben nach unten ausgewertet, daher ist die Reihenfolge in der Liste entscheidend. Die folgenden Beispiele verwenden Produktdaten, aber die Modifier-Funktion kann auch mit anderen unterstützten Datentypen verwendet werden.

Es gibt zwei Möglichkeiten, einen Modifier zu erstellen: mit AI Modifiers (empfohlene Methode) oder durch Auswahl eines der Standard-Modifier-Typen für einfachere, vordefinierte Transformationen.

Modifier-Reihenfolge #

Legen Sie die Reihenfolge fest, wenn ein Modifier von einer Änderung eines anderen abhängt. Clerk.io wertet die Liste von oben nach unten aus.

In Data > Modifiers greifen Sie das gepunktete Griffsymbol eines Modifiers und ziehen ihn an die gewünschte Position. Ein gestrichelter Kasten zeigt an, wo er landen wird. Lassen Sie die Zeile los, um sie zu verschieben.

Sie können auch eine Modifier-Zeile fokussieren und mit Alt + ↑ oder Alt + ↓ per Tastatur verschieben. Screenreader geben die Bewegung aus.

Testen Sie die Reihenfolge in der Before & After preview, bevor Sie auf Save & Run klicken, um sie für Ihren Katalog anzuwenden.

AI Modifiers #

AI Modifiers sind die standardmäßige und empfohlene Methode zur Erstellung von Modifiers. Anstatt einzelne Felder und Regeln zu konfigurieren, beschreiben Sie einfach in Alltagssprache, was der Modifier tun soll, und die KI erzeugt eine Python-Funktion, die Ihre Produktdaten entsprechend transformiert.

Dieser Ansatz ist wesentlich flexibler als die Standard-Modifier-Typen. Sie können komplexe Logik beschreiben, mehrere Bedingungen kombinieren, neue Werte aus bestehenden Attributen berechnen und Sonderfälle handhaben – alles ohne selbst Code zu schreiben.

1. Klicken Sie auf Add Modifier und wählen Sie als Typ AI Modifier (dies ist standardmäßig ausgewählt).
2. Klicken Sie auf der Modifier-Seite die Schaltfläche, um die Ask-Seitenleiste zu öffnen.
3. Beschreiben Sie in der Ask-Seitenleiste, was der Modifier tun soll. Seien Sie so spezifisch wie möglich hinsichtlich Logik, einbezogener Attribute und des erwarteten Outputs.
4. Die KI generiert eine Python-Funktion auf Basis Ihrer Beschreibung.
5. Testen Sie den Modifier mit der Before & After-Ansicht, bevor Sie speichern.

Beispiel-Prompts:

• “Create an attribute called variant_stock_percentage that shows how many of a product’s variants are currently in stock, as a percentage between 0 and 100.”
• “Set availability to In stock if stock is greater than 0, otherwise set it to Out of stock.”
• “Create a discount_percentage attribute by calculating the percentage difference between list_price and price, rounded to the nearest integer.”

Die von der KI erzeugte Python-Funktion ist schreibgeschützt – Sie können sie nicht direkt bearbeiten. Um die Logik zu ändern, führen Sie die Unterhaltung in der Ask-Seitenleiste weiter, und lassen Sie die Funktion aktualisieren. Ask Clerk.io kann Ihren Shop und das Setup vor Erstellung des Modifiers analysieren, was hilft, den Kontext Ihres Anliegens besser zu verstehen.

Standard-Modifier-Typen #

Für einfachere Transformationen stehen Standard-Modifier-Typen zur Verfügung. Sie decken eine Reihe vordefinierter Operationen ab und sind einfach zu konfigurieren, bieten jedoch weniger Möglichkeiten als AI Modifiers.

Alle Standard-Modifier haben ein if-Eingabefeld. Wird eine Bedingung hinzugefügt, läuft der Modifier nur bei Produkten, bei denen diese Bedingung zutrifft.

Hier finden Sie eine Beschreibung der einzelnen Standard-Modifier-Typen.

Create new attribute #

Akzeptiert ein new_value, das angibt, welchen Wert das Attribut bekommen soll. Es kann sowohl für ganz neue Attribute als auch zum Überschreiben bestehender Attribute genutzt werden.

Delete attribute #

Löscht das angegebene Attribut bei allen Produkten oder gezielt anhand einer if-Bedingung.

Delete product #

Löscht die angegebenen Produkte basierend auf einer if-Bedingung.

Update attribute #

Dieser Modifier verwendet regex mit der Python Bibliothek. Wenn Sie mit Regex nicht vertraut sind, nutzen Sie am besten AI Modifiers – diese können die gleichen Transformationen auch ohne Regex-Kenntnisse erledigen.

Update nimmt das Attribut regexp, das ein Regex-Ausdruck ist, der auf Teile des Attributs matched und jede gefundene Gruppe mit dem Inhalt von replace_by ersetzt. Hier finden Sie ein hilfreiches Tool zur Erstellung Ihres Regex-Ausdrucks.

Ein Beispiel-Regex könnte []+ mit einem replace_by von ’/’ sein. Damit werden alle Stellen im Attribut, an denen mehrere / hintereinander stehen, durch ein einzelnes / ersetzt. Aus https://test//tests würde so https:/test/tests.

Beispiel #

In diesem Beispiel möchten wir den letzten Teil einer URL mit einem Regex-Muster entfernen. Die Ausgangs-URL ist: https://example.domain/product/153//__example. Um den Teil //__example zu entfernen, nutzen wir das Regex: \/\/__example.

Da wir diesen Teil der URL einfach entfernen wollen, bleibt das Feld Replace by leer.

Change attribute type #

Ermöglicht die Änderung des Typs in einem Attribut. Ist der Datentyp z.B. eine Zahl und Sie benötigen einen String, können Sie dies so umwandeln. Folgende Typen stehen zur Verfügung: string, int, float und boolean.

Split attribute #

Ermöglicht das Aufteilen eines Strings durch einen Separator in eine Liste von Strings. Standardmäßig wird nach Komma getrennt, falls kein Separator angegeben ist.

Beispiel #

Hier teilen wir ein Attribut mit Kategorien in eine Liste: "lineman, chute" zu ["lineman","chute"].

Append value #

Erlaubt das Hinzufügen neuer Werte zu einem bestehenden Listen-Attribut.

Damit können Sie beispielsweise zusätzliche Strings zum tags-Attribut hinzufügen oder eine neue Kategorie zum categories-Attribut ergänzen.

Evaluate an expression #

Die Ausdrucksaktion berechnet einen mathematischen Ausdruck, der Attribute, Konstanten und Operatoren enthalten kann. Definieren Sie zum Beispiel diesen Ausdruck: price * 0.8, berechnet das System das Ergebnis, indem der Wert des price-Attributs mit 0.8 multipliziert wird. So wird ein Rabatt von 20 % angewendet.

Beispiel #

Wenn Sie im Feld New Value den String: price * 0.8 und der Preis ist 100 eingeben, ergibt das Ergebnis 80.

New formatted attribute #

Diese Aktion erstellt ein neues Attribut auf Basis bestehender Daten und wendet dabei Formatierungen oder Transformationen auf dessen Wert an.

Um auf ein bestehendes Attribut zuzugreifen, schreiben Sie dessen Namen in geschwungene Klammern ohne Leerzeichen: {attributeName}.

• Kopieren eines Attributs: setzen Sie New Value auf {MPN}.
• Text und Attribute zusammenfügen: € + {price}.

Wenn Sie innerhalb der Klammern Leerzeichen verwenden, wie { attribute }, speichert das System den Literalstring (inklusive Klammern), nicht den Attributwert.

Beispiel #

Sie können Attribute kombinieren, Präfixe oder Suffixe hinzufügen oder das Erscheinungsbild der Daten ändern. Um z.B. einen formatierten Preis wie €100,00 zu erzeugen, setzen Sie New Value auf: € + {price}.

If-Statements #

Wenn Sie eine Bedingung im if-Feld eintragen, wird der Befehl nur auf Attributen ausgeführt, bei denen die Bedingung zutrifft.

Verfügbare Operatoren sind:

Beispiel #

Erstellen Sie ein neues Attribut Availability mit dem Wert Available, If stock > 0.

Attribute aus Listen erstellen #

Ein häufiger Anwendungsfall ist das Erstellen eines separaten Attributs basierend auf Werten in einem bestehenden Listen-Attribut. Wenn Sie z.B. ein tags-Attribut mit Werten wie Female, Male und Unisex besitzen, können Sie ein spezielles gender-Attribut für die Verwendung in Search-Facetten erstellen.

Der in-Operator prüft, ob ein Wert in einer Liste vorhanden ist. Die Syntax lautet:

"value" in attribute_name

Um ein gender-Attribut aus tags zu erstellen, richten Sie mehrere Modifiers hintereinander ein:

Jeder Modifier wird nur ausgeführt, wenn seine Bedingung wahr ist. Die Reihenfolge ist entscheidend – wenn ein Produkt mehrere passende Tags hat, bestimmt der letzte zutreffende Modifier den endgültigen Wert.

Hinweis: Der zu prüfende Wert muss in Anführungszeichen stehen (z.B. "Female"), der Attributname wird ohne Anführungszeichen geschrieben (z.B. tags).

Bedingungen kombinieren #

Sie können mehrere Bedingungen mit and und or kombinieren.

Produkte auswählen, bei denen die Brand Nike UND der Stock größer als 0 ist:

brand == "Nike" and stock > 0

Produkte auswählen, bei denen die Kategorie shoes ODER boots enthält:

"shoes" in categories or "boots" in categories

Produkte auswählen mit einem bestimmten Tag UND Preis über 100:

"premium" in tags and price > 100

Testen & Speichern #

Bevor Sie auf Save & Run klicken, womit die Modifiers auf Ihren gesamten Katalog angewendet werden, ist es empfehlenswert, Ihren neuen Modifier zuerst zu testen. Sie können dies im Bereich See how your modifiers impact your product data tun.

Hier können Sie ein Produkt auswählen und sehen, wie es durch den Modifier mittels Before & After-Visualisierung beeinflusst wird.

Sie können einzelne Modifiers in der Vorschau ein- oder ausschließen. Nutzen Sie die Include in preview Checkbox an jedem Modifier, um ihn bei der Produkt-Vorschau temporär aus der Berechnung zu nehmen. Diese Auswahl betrifft nur die Vorschau und nicht den Live-Modifier – alle Modifiers werden angewendet, wenn Sie Save & Run klicken.