Filters

Filteroberfläche #

Filter können für jeden Content verwendet werden, um die Ergebnisse basierend auf deinen Produktattributen einzugrenzen.

Du findest diese Option in jedem Content, den du für Recommendations, Search oder Email erstellst, unter Content type > Product filters.

Jeder Teil des Filters besteht aus Folgendem:

• Einem Attribut, nach dem gefiltert werden soll
• Einem Vergleich, der bestimmt, wie das Attribut mit dem Wert verglichen wird
• Einem Wert, der festlegt, mit was das Attribut verglichen wird

Du kannst Filter auf Basis beliebiger Produktattribute erstellen, die du an Clerk sendest. Die verfügbaren Vergleichsoperatoren hängen vom Typ des gefilterten Attributs ab.

Beispiel: price enthält eine Zahl, das bedeutet, du kannst sowohl größer als, kleiner als als auch andere numerische Vergleiche verwenden, während Text-/String-Attribute wie name nur boolesche Vergleiche wie ist oder ist nicht zulassen.

Beim Erstellen von Filtern zeigt die Oberfläche dir wie viele Produkte dem Filter entsprechen und den generierten filter string an.

Einfache Filter #

Diese enthalten nur ein einzelnes Attribut und einen Vergleich. Ein Beispiel ist, nur Produkte unter 400 € anzuzeigen:

Filter-Sets #

Diese ermöglichen es dir, die Produktauswahl einzuschränken, indem du mehrere Filter innerhalb desselben Sets hinzufügst. Das kannst du tun, indem du auf das "+"-Symbol innerhalb eines bestehenden Filters klickst und einen neuen hinzufügst.

Innerhalb eines Sets kannst du zwischen zwei Filterlogiken wählen:

• AND zeigt nur Produkte, die alle Filter im Set erfüllen.
• OR zeigt Produkte, die mindestens einen der Filter im Set erfüllen.

Beispiel: Du möchtest nur Produkte zeigen, die unter 400 € liegen und zudem im Angebot sind.

Sets kombinieren #

Du kannst Filter-Sets kombinieren, sodass sie unter verschiedenen Bedingungen zusammenarbeiten. Statt Filter innerhalb eines bestehenden Sets hinzuzufügen, klickst du auf "+ Add filter", um ein neues Set zu starten.

Jedes Filter-Set arbeitet einzeln, und du kannst auswählen, wie sie miteinander interagieren:

• AND zeigt nur Produkte, die alle Sets erfüllen.
• OR zeigt Produkte, die mindestens eines der Sets erfüllen.

Beispiel: Du möchtest Produkte anzeigen, die unter 400 € UND im Angebot sind, aber auch entweder von Anbieter A ODER aus einer bestimmten Kategorie stammen.

• Das erste Set sorgt dafür, dass die Produkte die Preis- und Angebotsbedingungen erfüllen.
• Das zweite Set erlaubt Flexibilität, indem Produkte aus entweder einem bestimmten Anbieter oder einer bestimmten Kategorie eingeschlossen werden.

Filter-String #

Die Filteroberfläche erstellt automatisch die richtige Syntax basierend auf den verfügbaren Daten deiner Attribute. Zum Beispiel, wenn deine SKUs als Strings wie “GT-1234” formatiert sind, werden Anführungszeichen automatisch zum filter string hinzugefügt.

sku = "GT-1234"

Wenn ein Attribut eine Zahl ist, wird es ohne Anführungszeichen hinzugefügt.

price < 300

Falls du Probleme mit dem Filtern hast, prüfe den filter-string, um sicherzustellen, dass die richtige Syntax verwendet wird, und passe ihn gegebenenfalls an.

Falls du unsicher bist, kannst du den Datentyp eines bestimmten Attributs (string, number, list, boolean) sehen, indem du zu Data > Products gehst und ein Produkt ansiehst.

Du kannst den filter string jederzeit manuell anpassen, indem du auf das Stift- Symbol neben Filter expression. klickst.

Dynamische Attributwerte #

Wenn du Filter für Merchandising-Kampagnen oder Content erstellst, der produktbasierte Logik verwendet, kannst du die Attribute des angesehenen Produkts als dynamische Werte referenzieren, indem du {{ attribute_name }} schreibst.

Zur Ausführungszeit wird der Platzhalter durch den tatsächlichen Wert aus dem angesehenen Produkt ersetzt. Zum Beispiel stellt ein Filter wie type = {{ type }} sicher, dass nur Produkte mit dem gleichen type wie das aktuell angesehene Produkt angezeigt werden.

Das ist besonders nützlich, wenn die Filter sich automatisch anpassen sollen, ohne spezifische Werte fest einzutragen. Du kannst dynamische Werte mit anderen Filtern kombinieren, z. B. type = {{ type }} zusammen mit price < 500, um nur gleiche Typen unter 500 € anzuzeigen.

Dynamische Attributwerte funktionieren nur, wenn die Anfrage eine oder mehrere Produkt-IDs enthält, wie Best Cross-Sell und Best Alternatives in Recommendations.

Dynamisches Filtern #

Filters können direkt zu Embed-Codes über das data-filter Attribut hinzugefügt werden. So kannst du Filter dynamisch machen, indem du die Werte per Frontend-Logik änderst.

Im Folgenden sind einige häufige Beispiele aufgeführt, wie du dynamisches Filtern nutzen kannst.

Kostenloser Versand-Limit #

Lege eine Variable fest, z. B. $free_shipping_limit, die den verbleibenden Betrag enthält, den der Kunde noch benötigt, um den kostenlosen Versand zu erreichen. Verwende dies als dynamischen Filter, um nur Produkte über diesem Preis anzuzeigen:

<span class="clerk"
      data-template="@complementary-to-basket"
      data-filter="price > $free_shipping_limit">
</span>

Passendes Geschlecht #

Wenn deine Produkte ein Attribut wie gender enthalten, das female, male, kids, unisex usw. enthält, kannst du Clerk-Elemente dazu bringen, Produkte für das gleiche Geschlecht anzuzeigen.

Lege eine Variable fest, z. B. $product_gender, die das Geschlecht des aktuell angesehenen Produkts enthält, und verwende dies, um Produkte für das gleiche Geschlecht anzuzeigen:

<span class="clerk"
      data-template="@Bestsellers"
      data-filter="gender = $product_gender">
</span>

Bestimmte Kategorie #

In diesem Fall benötigst du eine Liste in deinem Shop, die die Produktkategorien enthält, z. B. definiert als $available_categories = [1,2,3,4,5]. Verwende dies, um Slider so zu filtern, dass nur Produkte aus diesen Kategorien angezeigt werden:

<span class="clerk"
      data-template="@type-slider"
      data-filter="categories in $available_categories">
</span>