Modifikatoren

Übersicht #

Mit Modifiers können Sie Daten nach dem Abgleich ändern, ohne Ihren Datenfeed zu bearbeiten oder einen Entwickler hinzuzuziehen. Modifiers unterstützen derzeit Produkte, Kategorien, Kunden und Seiten.

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

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

AI Modifiers #

AI Modifiers sind die Standard- und empfohlene Methode, um Modifiers zu erstellen. Anstatt einzelne Felder und Regeln zu konfigurieren, beschreiben Sie einfach in Alltagssprache, was der Modifier tun soll, und die KI generiert eine Python-Funktion, die Ihre Produktdaten entsprechend transformiert.

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

1. Klicken Sie auf Add Modifier und wählen Sie AI Modifier als Typ aus (dies ist standardmäßig ausgewählt).
2. Klicken Sie auf der Modifier-Seite auf die Schaltfläche, um die Ask-Seitenleiste zu öffnen.
3. Beschreiben Sie in der Ask-Seitenleiste, was der Modifier tun soll. Seien Sie dabei so spezifisch wie möglich in Bezug auf die Logik, die beteiligten Attribute und das erwartete Ergebnis.
4. Die KI generiert basierend auf Ihrer Beschreibung eine Python-Funktion.
5. Testen Sie den Modifier mit der Vorher & Nachher-Vorschau, bevor Sie speichern.

Beispielaufforderungen:

• “Erstelle ein Attribut mit dem Namen variant_stock_percentage, das anzeigt, wie viele Varianten eines Produkts aktuell auf Lager sind – als Prozentsatz zwischen 0 und 100.”
• "availability auf In stock setzen, wenn stock größer als 0 ist, ansonsten auf Out of stock."
• “Erstelle ein Attribut discount_percentage, indem du die prozentuale Differenz zwischen list_price und price berechnest, auf die nächste ganze Zahl gerundet.”

Die von der KI generierte 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 fort und lassen Sie die Funktion aktualisieren. Ask Clerk.io kann Ihren Shop und Ihre Konfigurationen analysieren, bevor der Modifier erstellt wird, was dabei hilft, den Kontext Ihrer Anfrage zu verstehen.

Standard-Modifier-Typen #

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

Alle Standard-Modifiers haben ein if-Eingabefeld. Wenn eine Bedingung hinzugefügt wird, wird der Modifier nur bei Produkten ausgeführt, bei denen diese Bedingung zutrifft.

Hier folgt eine Beschreibung der einzelnen Standard-Modifier-Typen.

Create new attribute #

Nimmt einen new_value, der angibt, welchen Wert das Attribut bekommen soll. Kann sowohl als neues Attribut als auch zum Überschreiben eines bestehenden Attributs verwendet werden.

Delete attribute #

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

Delete product #

Löscht das angegebene Produkt/die angegebenen Produkte anhand einer if-Bedingung.

Update attribute #

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

Update verwendet das Attribut regexp, eine Regex-Ausdruck, der auf Teile des Attributs matched und jede gefundene Gruppe durch den Inhalt von replace_by ersetzt. Hier finden Sie ein hilfreiches Tool, um Ihren Regex zu erstellen.

Ein Beispiel für einen Regex könnte []+ mit einem replace_by von ’/’ sein – alle aufeinanderfolgenden / im Attribut werden durch ein einzelnes /* ersetzt. Aus https://test//tests wird dann https:/test/tests.

Beispiel #

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

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

Change attribute type #

Ermöglicht es, den Typ eines Attributs zu ändern. Wenn die Daten z.B. eine Zahl sind und Sie sie als String benötigen, können Sie dies zum Typecasten verwenden. Die Typen sind: string, int, float und boolean.

Split attribute #

Erlaubt es, einen String anhand eines Separators in eine Liste von Strings zu teilen. Standardmäßig wird bei fehlendem Separator durch Komma getrennt.

Beispiel #

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

Append value #

Erlaubt das Hinzufügen neuer Werte zu einem bestehenden Listenattribut.

Dies kann beispielsweise das Hinzufügen zusätzlicher Strings zu einem tags-Attribut oder einer neuen Kategorie zu einem categories-Attribut sein.

Evaluate an expression #

Die Aktion Expression berechnet einen mathematischen Ausdruck, der Attribute, Konstanten und Operatoren enthalten kann. Wenn Sie folgenden Ausdruck definieren: price * 0.8, berechnet das System das Ergebnis, indem es den Wert des price-Attributs mit 0,8 multipliziert, also einen Rabatt von 20 % anwendet.

Beispiel #

Wenn Sie im New Value-Feld den String price * 0.8 eingeben und der Preis 100 beträgt, ist das Ergebnis 80.

New formatted attribute #

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

Um auf ein bestehendes Attribut zu verweisen, schreiben Sie seinen Namen in geschweifte Klammern ohne Leerzeichen: {attributeName}.

• Attribut kopieren: New Value auf {MPN} setzen.
• Text und Attribute verketten: € + {price}.

Wenn Sie Leerzeichen innerhalb der Klammern angeben, wie { attribute }, speichert das System den wörtlichen String (inklusive Klammern), nicht den Attributwert.

Beispiel #

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

If-Statements #

Wenn Sie eine Bedingung im if-Feld hinzufügen, wird der Befehl nur bei 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.

Erstellung von Attributen aus Listen #

Ein häufiger Anwendungsfall ist das Erstellen eines separaten Attributs, das auf Werten eines bestehenden Listenattributs basiert. Wenn Sie z.B. ein tags-Attribut mit den Werten Female, Male und Unisex haben, können Sie daraus ein eigenes gender-Attribut für die Verwendung in Search-Facetten erstellen.

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

"Wert" in attribute_name

Um ein gender-Attribut aus Tags zu erstellen, richten Sie mehrere Modifiers nacheinander ein:

Jeder Modifier wird nur ausgeführt, wenn die jeweilige Bedingung zutrifft. Die Reihenfolge ist wichtig – wenn ein Produkt mehrere passende Tags hat, bestimmt der zuletzt zutreffende Modifier den endgültigen Wert.

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

Bedingungen kombinieren #

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

Produkte finden, bei denen die Marke Nike UND der Lagerbestand größer als 0 ist:

brand == "Nike" and stock > 0

Produkte finden, deren Kategorie Schuhe ODER Stiefel enthält:

"shoes" in categories or "boots" in categories

Produkte finden, die einen bestimmten Tag haben UND deren Preis über 100 liegt:

"premium" in tags and price > 100

Testen & Speichern #

Bevor Sie auf Save & Run klicken, wodurch die Modifiers auf Ihren gesamten Katalog angewendet werden, sollten Sie Ihren neuen Modifier zuerst testen. Das geht im Bereich See how your modifiers impact your product data.

Hier können Sie ein Produkt auswählen und sehen, wie es durch den Modifier mit der Vorher & Nachher-Visualisierung beeinflusst wird.

Sie können einzelne Modifiers in der Vorschau ein- oder ausschließen. Verwenden Sie das Include in preview Kontrollkästchen bei jedem Modifier, um diesen beim Testen eines Produkts vorübergehend von der Vorschau auszuschließen. Diese Auswahl wirkt sich nur auf die Vorschau aus, nicht auf den Live-Modifier – alle Modifiers werden angewendet, wenn Sie auf Save & Run klicken.