Skip to main content
Diese Seite ist der vollständige Katalog hinter dem Strategie-Editor: jeder Trigger und die Operatoren, die er akzeptiert, jede Aktion, die globalen Filter und wie eine Strategie ausgewertet wird. Sie ergänzt die Anleitung Strategien erstellen - nutze sie, wenn du alle Details zu einer bestimmten Option brauchst. Eine Regel verbindet Trigger (das Wann) mit Aktionen (das Dann), und du kannst bis zu fünf Trigger unter einem AND / OR-Schalter kombinieren: Bei AND muss jeder Trigger zutreffen, bei OR reicht einer. Die folgenden Abschnitte folgen diesem Aufbau - zuerst Trigger und Aktionen, dann die Steuerungen auf Strategie-Ebene, die für alle Regeln gelten: Regelreihenfolge, Globale Filter und das Catch all.

Trigger

Trigger bestimmen, wann eine Regel ausgelöst wird. Verfügbare Trigger-Typen:

Produkt-Trigger

Targeting auf Basis der Produkte im Kontext (der Warenkorb des Käufers, die gerade abgeschlossene Bestellung oder das angesehene Produkt):
  • Specific product(s) - trifft auf bestimmte Shopify-Produkte nach ID zu
  • Collection - trifft auf Produkte zu, die zu bestimmten Kollektionen gehören
  • Tag(s) - trifft auf Produkte mit bestimmten Tags zu (z. B. “sale”, “summer”)
  • Title - trifft auf den Produkttitel zu
  • Vendor - trifft auf den Namen des Herstellers/der Marke zu
  • Type - trifft auf das Feld Produkttyp zu (z. B. “Apparel”, “Electronics”)
  • Handle - trifft auf den URL-Slug des Produkts zu
  • Metafield - trifft auf benutzerdefinierte Metafeld-Kombinationen aus Namespace/Key/Value zu
  • Selling plan - trifft auf “subscription”- oder “one-time”-Produkte zu. Wird nur ausgewertet, wenn der Anfragekontext einen Selling Plan für das Produkt liefert - die Checkout- und Post-Purchase-Upsell-Oberflächen von Aftersell senden diesen nicht, daher trifft der Trigger dort nicht zu, es sei denn, eine benutzerdefinierte Integration liefert ihn ausdrücklich

Kunden-Trigger

Targeting danach, wer der Käufer ist:
  • Customer tag - z. B. “VIP”, “loyalty-gold”
  • Country code - Rechnungsland
  • Province code - Bundesland/Region der Rechnungsadresse
  • Locale - Gebietsschema des Kunden (z. B. “en-US”)
  • Accepts marketing - Status der Marketing-Einwilligung
  • Order count - Anzahl früherer Bestellungen
  • Total spent - Gesamtausgaben über die gesamte Kundenbeziehung

Warenkorb-Trigger

Targeting auf Basis des gesamten Warenkorbzustands:
  • Cart subtotal - z. B. Zwischensumme größer als $50
  • Item count - Gesamtmenge der Artikel im Warenkorb
  • Line count - Anzahl unterschiedlicher Positionen
  • Cart attribute - benutzerdefinierte Warenkorbattribute, die über die Cart API von Shopify gesetzt werden
  • Cart note - das Feld für die Warenkorbnotiz

Standort-Trigger

Targeting danach, wohin der Käufer liefern lässt, und nach der Währung des Shops:
  • Shipping country - Lieferzielland
  • Shipping province - Bundesland/Region des Lieferziels
  • Shipping method - ausgewählte Versandmethode
  • Store currency - der aktive Währungscode des Shops

Marketing-Trigger

Targeting auf Basis der Seiten-URL, über die der Käufer gekommen ist:
  • URL - trifft auf einen Teilstring der Landing-URL zu, sodass du eine bestimmte Kampagne oder einen Kanal gezielt ansprechen kannst, indem du einen in der URL enthaltenen Parameter abgleichst (z. B. utm_source=newsletter)

Zeit-Trigger

Targeting danach, wann die Anfrage ausgewertet wird, in der Zeit des Shops:
  • Day of week - der aktuelle Wochentag
  • Hour of day - die aktuelle Stunde

Dynamische Trigger

  • Always match - ein Trigger ohne Bedingung, der immer ausgelöst wird. Nutze ihn, damit eine Regel bei jeder Anfrage ausgeführt wird (das unterscheidet sich vom Catch all auf Strategie-Ebene, das nur ausgelöst wird, wenn keine andere Regel zutrifft).
Nicht jeder Trigger wird auf jeder Oberfläche befüllt. Der Checkout sendet zum Beispiel nur Produkt- und Warenkorbkontext - Kunden-, Standort- und Marketing-Trigger treffen dort nicht zu. In den Guides Strategien implementieren erfährst du, was jede Oberfläche sendet.

Operatoren

Jeder Trigger verwendet einen Operator, der festlegt, wie der Wert abgeglichen wird. Die verfügbaren Operatoren hängen vom Trigger-Typ ab. Nicht jeder Operator ist für jeden Trigger verfügbar:
  • Listenoperatoren (Contains any / all und ihre Verneinungen) gelten für mehrwertige Felder wie Tags, Kollektionen, Kunden-Tags und bestimmte Produkte.
  • Textoperatoren (Equals, Contains und ihre Verneinungen) gelten für einwertige Textfelder wie Titel, Vendor, Handle, Locale, Land und URL.
  • Numerische Operatoren gelten für Felder wie Warenkorb-Zwischensumme, Artikelanzahl, Positionsanzahl, Bestellanzahl, Gesamtausgaben und Stunde. Numerische Operatoren haben keine “does not”-Varianten.
  • Einige Felder unterstützen nur Equals und Does not equal - Selling Plan, Wochentag und Accepts Marketing.

Aktionen

Aktionen erzeugen das Erlebnis, das du dem Kunden bieten möchtest. Hier entscheidest du, welche Produkte angezeigt werden, wie sie angezeigt werden und welche zusätzlichen Daten mitgegeben werden. Eine Regel kann mehrere zusammen konfigurierte Aktionen haben, um das vollständige Erlebnis aufzubauen. Pro Regel tragen alle konfigurierten Aktionen zu einem gemeinsamen Pool bei. Eine Regel mit einer Aktion für bestimmte Produkte, einer Kollektionsaktion und einer tagbasierten Aktion liefert zum Beispiel Produkte aus allen drei Quellen zusammen. Wenn ein Produkt auf mehrere Quellen zutrifft, wird es dedupliziert.

Produktaktionen

Dieselben Produktattribute, die auf der Trigger-Seite verfügbar sind, stehen auch beim Definieren von Aktionen zur Verfügung. Du kannst Produkte zurückgeben auf Basis von:
  • Specific products - wähle einzelne Produkte aus deinem Shopify-Katalog von Hand aus.
  • Collection - gib alle Produkte einer bestimmten Kollektion zurück.
  • Product attributes - gib Produkte zurück, die Kriterien wie Tags, Vendor, Produkttyp oder Metafelder erfüllen - dieselben Attributtypen wie bei den Triggern.

Dynamische Aktionen

Dynamische Aktionen ändern das Ergebnis auf Basis von Echtzeitsignalen statt einer festen Produktliste. Zu den verfügbaren dynamischen Aktionstypen gehören:
  • Most popular - die nach Verkaufsvolumen erfolgreichsten Produkte deines Shops, entweder shopweit oder auf eine Kollektion beschränkt.
  • Recently purchased - Produkte, die kürzlich im Shop gekauft wurden.
  • Inherit from when - verwendet die eigenen Trigger der Regel (das “Wann”) als Produktselektor, sodass die zurückgegebenen Produkte denselben Kriterien entsprechen, bei denen die Regel ausgelöst wurde.
  • AI Recommendations - personalisierte Vorschläge, die vom Empfehlungsmodell von Aftersell generiert werden.

Filteraktionen

Sobald der Produktpool zusammengestellt ist, kannst du konfigurieren, wie viele Produkte in welcher Reihenfolge zurückgegeben werden:
  • Sort - steuert, welche Produkte ausgewählt werden:
    • Random - eine zufällige Auswahl.
    • Price: high → low - die teuersten Produkte werden zuerst zurückgegeben.
    • Price: low → high - die günstigsten Produkte werden zuerst zurückgegeben.
  • Amount/Limit - legt die maximale Anzahl zurückzugebender Produkte fest.
  • Type - grenzt den zusammengestellten Produktpool auf einen einzelnen Shopify-Produkttyp ein. Wähle Equals für eine exakte Übereinstimmung oder Contains für eine Teilstring-Übereinstimmung (beide unabhängig von Groß- und Kleinschreibung). Nur Produkte, deren Produkttyp dem eingegebenen Wert entspricht, bleiben erhalten; der Rest wird entfernt, bevor Amount/Limit angewendet wird.
Der Type-Filter kürzt den von deinen Produktaktionen zusammengestellten Produktpool - er unterscheidet sich von der Produktaktion Product type, die Produkte eines bestimmten Typs zurückgibt. Nutze den Filter, wenn du einschränken möchtest, was eine breitere Aktion (etwa eine Kollektions- oder dynamische Aktion) zurückgeben kann.
Zuerst wird Sort angewendet, dann Amount/Limit. Wenn deine Sortierung zum Beispiel auf Random steht, wird der gesamte Produktpool zufällig gemischt, bevor das Limit angewendet wird - so erhältst du immer einen zufälligen Ausschnitt und nicht dieselben Produkte in zufälliger Reihenfolge.

Key-Value-Aktionen

Optional kannst du einer Regel Key-Value-Paare hinzufügen. Wenn die Regel zutrifft, werden sie in der API-Antwort in meta.data zusammen mit den Produktergebnissen zurückgegeben. Typische Einsatzzwecke:
  • Text für Werbebanner
  • Kampagnen-Labels für Analytics
Wenn mehrere Regeln zutreffen und denselben Key ausgeben, gewinnt der Wert der ersten zutreffenden Regel - spätere Regeln können ihn nicht überschreiben.

Regelpriorität und Auswertungsreihenfolge

Regeln innerhalb einer Strategie werden der Reihe nach ausgewertet, Schritt für Schritt. Schritt 1 wird zuerst ausgewertet und so weiter. Du kannst Regeln im Strategie-Editor per Drag-and-drop neu anordnen. Die Auswertungs-Engine:
  1. Wertet die Trigger jeder Regel anhand des bereitgestellten Kontexts aus.
  2. Sammelt Produkte aus allen zutreffenden Regeln.
  3. Dedupliziert das Ergebnis und begrenzt es auf das konfigurierte Maximum (Standard: 20 Produkte).

Globale Filter

Globale Filter schließen Produkte über alle Regeln einer Strategie hinweg von der Auswahl aus. Du erreichst sie über das Filtersymbol neben dem Strategienamen oben links im Strategie-Editor. Verfügbare globale Filter:
  • Exclude out of stock - schließt automatisch jedes Produkt aus, das derzeit nicht gekauft werden kann.
  • Exclude input products - schließt die Produkte aus, die die Regel ausgelöst haben (z. B. das Produkt, das ein Käufer gerade auf einer PDP ansieht), sodass du nie dasselbe Produkt empfiehlst, das der Käufer bereits betrachtet.
  • Exclude by product tag - schließt Produkte mit bestimmten Tags aus.
  • Exclude by metafield - schließt Produkte aus, die einer bestimmten Metafeld-Kombination aus Namespace/Key/Value entsprechen.
  • Exclude by product ID - schließt bestimmte Produkte nach ID aus.
  • Require stock at location - behält nur Produkte, die an einem gewählten Standort verfügbaren Bestand haben (erfordert Leseberechtigungen für Bestand und Standorte).

Catch all

Catch all ist eine spezielle Regel, die als letzter Schritt jeder Strategie-Auswertung dient. Sie hat keinen Trigger; sie wird automatisch ausgelöst, wenn keine andere Regel der Strategie auf die aktuelle Anfrage zutrifft. Wenn es aktiviert ist, stellt das Catch all sicher, dass dein Empfehlungsplatz nie leer bleibt. Seine Aktion kann mit allen Aktionstypen konfiguriert werden, die auch für reguläre Regeln verfügbar sind - bestimmte Produkte, Kollektionen, dynamische Aktionen usw.
  • Enable/disable - schaltet die Catch-all-Regel für die Strategie ein oder aus. Wenn sie deaktiviert ist, liefern Anfragen, auf die keine Regel zutrifft, ein leeres Ergebnis.
  • Configure actions - lege mit einer beliebigen Kombination verfügbarer Aktionstypen fest, was zurückgegeben wird, genau wie bei jeder anderen Regel.
Wenn das Catch all ausgelöst wird, enthält die API-Antwort resolution.fallbackUsed: true.