Campaigns

Merchandising gibt Ihnen ein hohes Maß an Kontrolle darüber, welche Produkte von Clerk angezeigt werden, wie z. B. das Hervorheben von Produkten im Ausverkauf, die Priorisierung bestimmter Marken, das Ausblenden von ausverkauften Produkten und vieles mehr.

Grundlegende Informationen #

Kampagnen haben immer einen Namen Ihrer Wahl. Optional können Sie eine Beschreibung hinzufügen, um sich selbst und Ihren Kollegen den Zweck der Kampagne zu merken.

Planung #

Entscheiden Sie, ob eine Kampagne unbegrenzt oder in einem bestimmten Zeitraum laufen soll. Die Planung ist besonders nützlich, wenn Sie die Ergebnisse nur während eines bestimmten Zeitraums beeinflussen möchten, wie z. B. während der Black-Friday-Woche oder Ihres Weihnachtsverkaufs.

Durch die Nutzung der Planung stellen Sie sicher, dass Sie nicht versehentlich vergessen, die Kampagne zu beenden, wenn sie nicht mehr relevant ist.

Produktauswahl #

Beim Konfigurieren von Triggern und Regeln sollten Sie Produkte so auswählen, dass Ihre Kampagnen aktuell bleiben, auch wenn sich Ihr Katalog ändert.

Sie können Produkte mit Produktliste einzeln auswählen, es wird jedoch empfohlen, Stichwörter mit Search einzugeben oder Filter zu verwenden, um Produkte dynamisch auszuwählen.

Auf diese Weise bleiben Ihre Kampagnen relevant, auch wenn Produkte ausverkauft sind oder neue Produkte zu Ihrem Katalog hinzugefügt werden.

Produktliste #

Dies ist der einfachste Weg, Produkte für Ihre Kampagne auszuwählen. Suchen Sie einfach nach den gewünschten Produkten und klicken Sie auf diese, um sie auszuwählen.

Sie können so viele Produkte auswählen, wie Sie möchten. Wenn Produkte später aus Ihrem Katalog entfernt werden, werden sie nicht mehr in den Ergebnissen angezeigt.

Reihenfolge der Produkte #

Wenn eine Regel Product list verwendet, können Sie die Reihenfolge der ausgewählten Produkte direkt im Produktpicker festlegen. Dies ist die Reihenfolge, die Käufer sehen, wenn die Regel diese Produkte in den Ergebnissen platziert.

1. Öffnen Sie Merchandising und bearbeiten Sie die Kampagne.
2. Unter Rules klicken Sie auf die Schaltfläche, die die ausgewählten Produkte der Regel anzeigt, um den Produktpicker zu öffnen.
3. Ziehen Sie den gepunkteten Griff neben einem ausgewählten Produkt an die gewünschte Position. Die Zeile folgt dem Cursor und eine gestrichelte Box zeigt an, wo sie positioniert wird.
4. Lassen Sie die Zeile in der gestrichelten Box los. Wiederholen Sie diesen Vorgang für alle anderen Produkte, die Sie verschieben möchten.
5. Schließen Sie den Picker und klicken Sie auf Save in der Kampagne.

Um die Reihenfolge per Tastatur zu ändern, fokussieren Sie eine Produktzeile und drücken Sie Alt + ↑ oder Alt + ↓. Screenreader geben den Wechsel bekannt.

Beispielsweise verschieben Sie ein ausgewähltes Produkt vom vierten auf den ersten Platz, um es vor den anderen manuell ausgewählten Produkten zu platzieren. Sie können diese Reihenfolge ändern, ohne die Produkte zu entfernen und erneut auszuwählen. Die Regel steuert weiterhin, wo die Produkte in den Ergebnissen platziert werden.

Search #

Wählen Sie Produkte mit Freitext aus. Geben Sie einfach Stichworte ein, die den gewünschten Produkten entsprechen, zum Beispiel „Nike sneakers“, „strawberry whey powder“ oder „macbook pro“.

Alle Produkte, die zu jedem beliebigen Zeitpunkt diesen Stichwörtern entsprechen, werden Teil der Kampagne sein.

Filter #

Diese können dazu verwendet werden, dynamisch Produkte zu wählen, basierend auf deren Attributen. Alle Produkte, die zu einem bestimmten Zeitpunkt den Filtern entsprechen, sind Teil der Kampagne.

Die Filteroberfläche ermöglicht es Ihnen, eine beliebige Anzahl von Attributen zu wählen, wie z. B. Produkte im Ausverkauf mit einem Preis unter 100 € und zugleich einer hohen Marge.

Dynamische Werte #

Wenn eine Kampagne When Seeing Products Matching verwendet, können Sie einen Filter so einstellen, dass er ein Attribut des Produkts verwendet, das der Besucher gerade ansieht. So kann eine Kampagne sich an jede Produktseite anpassen, anstatt einen festen Wert zu verwenden.

In der Filter-Sektion der Kampagne konfigurieren Sie jeden Filter mit:

1. Dem Produktattribut, das gefiltert werden soll, wie Marke, Produkttyp oder Tags.
2. Der Bedingung, etwa ist oder enthält.
3. Fixed value für einen bestimmten Wert, oder Current product, um das aktuell angesehene Produkt zu verwenden.
4. Den zu vergleichenden Wert oder das Attribut des aktuellen Produkts.

Beispiel: Wählen Sie Current product und verwenden Sie den Typ des aktuellen Produkts, um Produkte desselben Typs anzuzeigen. Sie können dies mit anderen Filtern kombinieren, z. B. einer festen Preisbedingung.

Der Filterausdruck kann weiterhin manuell bearbeitet werden. Dynamische Werte nutzen das {{ attribute_name }}-Format, wobei attribute_name durch das entsprechende Attribut des aktuell angesehenen Produkts ersetzt wird.

Produktanzahlen werden im Editor für Filter, die aktuelle Produktwerte verwenden, nicht angezeigt, da es kein aktuelles Produkt gibt, bis ein Besucher eine Produktseite öffnet. Diese Werte werden auf der Seite vom angesehenen Produkt übernommen.

Aktuelle Produktwerte sind nur für Merchandising-Kampagnenregeln verfügbar. Audience-, Email- und Inhaltsfilter bleiben unverändert.

Kundenwerte #

Ein Produktfilter einer Regel kann ein Attribut eines Produkts mit einem Attribut des identifizierten Kunden vergleichen. So kann eine Regel je nach Besucher unterschiedliche Produkte wählen, basierend auf Land, Geschlecht oder Kundengruppe.

Kundenwerte funktionieren in Search- und Recommendations-Widgets im Storefront und in Email Embeds. Sie werden in Clerk.io Newslettern oder automatisierten Flow-Emails nicht unterstützt.

1. Öffnen Sie Merchandising und bearbeiten Sie die Kampagne.
2. Unter Rules öffnen Sie die Produktauswahl der Regel.
3. Öffnen Sie den Filter-Tab und klicken Sie auf Add filter.
4. Wählen Sie das Produktattribut und die Vergleichsbedingung.
5. Stellen Sie die Wertquelle auf Customer und wählen Sie das Kundenattribut.
6. Schließen Sie die Produktauswahl und klicken Sie auf Save bei der Kampagne.

Beispiel: Vergleichen Sie die verfügbaren Länder eines Produkts mit dem Land des Kunden, um nur Produkte anzuzeigen, die dorthin versendet werden können. Beide Attribute müssen passende Werte enthalten, damit der Vergleich passt.

Wenn Sie das Geschlecht des Kunden erfassen und an Clerk.io senden, können Sie es mit dem Geschlechtsattribut eines Produkts vergleichen, um passende Produkte anzuzeigen. Dafür brauchen Sie entsprechende Daten sowohl beim Kunden als auch bei den Produkten mit übereinstimmenden Werten.

Sie können auch eine Kundengruppe verwenden, um relevante Produkte auszuwählen.

Dies lässt sich mit einem customer attribute trigger kombinieren. Der Trigger entscheidet, wann die Kampagne läuft; der Kundenwert, welche Produkte die Regel auswählt.

Identifikation

Für Kundenwerte benötigt der Besucher eine Email und das gewählte Attribut im Kundenprofil von Clerk.io. Eine Email identifiziert den Kunden; sie liefert keinen Wert für Land, Geschlecht oder Gruppe.

Clerk.js erledigt dies automatisch für Shops, die bereits Kundenanmeldungen oder -identifizierungen an Clerk.io melden. Ein Klick auf die Kampagne, der die Email des Kunden trägt, zählt ebenfalls als Identifikation.

Für eingeloggte Kunden wird die Email während der Browsersitzung seitenübergreifend gemerkt. Sie wird niemals im cookieless- oder privaten Modus gespeichert.

Für individuelle Integrationen siehe Customer Context unten.

Fehlende Werte

Ist die Email des Besuchers unbekannt oder fehlt dem Kunden das ausgewählte Attribut, wird die kundenbasierte Regel übersprungen. Dies verursacht keinen Fehler. Bestehende Regeln verhalten sich wie gewohnt.

Eine regionale Regel schränkt dadurch nur die Produkte für Kunden ein, die identifiziert wurden und das erforderliche Attribut haben. Anonyme Besucher erhalten diese Einschränkung nicht.

Trigger #

Diese steuern, wo Ihre Kampagnen aktiv sein sollen. Trigger reichen von überall bis zu einem bestimmten Banner auf einer spezifischen Produktseite.

Kampagnen können bei einem beliebigen der ausgewählten Trigger ausgeführt werden oder nur, wenn alle Triggerkriterien erfüllt sind.

Im Folgenden finden Sie alle derzeit verfügbaren Trigger.

Cross-Platform #

Wird verwendet, um alle Clerk-Elemente oder bestimmte gezielt auszuwählen, basierend auf Content-IDs oder API-Endpunkten.

• Überall: Alle Clerk-Elemente auf Ihrer Seite, in Emails und Chat.
• Nur für spezifischen Content: Jeder ausgewählte Content-Block, den Sie in Search, Recommendations und Email erstellt haben.
• Für spezifischen API-Endpunkt: Endpunkte wie recommendations/complementary oder search/predictive. Dies ist gewöhnlich nur bei serverseitigen Setups erforderlich.
• Für spezifischen API-Parameter: Ermöglicht das programmatische Auslösen der Kampagne.
• Wenn Kundenattribut …: Zielgerichtet, wenn der identifizierte Kunde Attribute hat, die Ihre Bedingungen erfüllen.
• Wenn Kunde in Audience …: Zielgerichtet, wenn der identifizierte Kunde einer oder mehreren ausgewählten Audiences angehört.

Search #

Speziell für Ergebnisse, die in Instant Search, der Suchseite oder Omnisearch angezeigt werden.

• Bei allen Suchanfragen: Alle Suchanfragen von Besuchern.
• Bei einer Suche: Bestimmte Wörter Ihrer Wahl entweder für eine exakte oder nahe Übereinstimmung oder wenn die Suchanfrage das/die Wort(e) enthält. Kann auch leer gelassen werden, um den Leere-Zustand in Omnisearch anzusprechen, bevor eine Suchanfrage eingegeben wurde.

Chat #

Speziell für Ergebnisse, die in Chat angezeigt werden, wenn nach Produkten gesucht wird.

• Bei allen Chat-Suchen: Beeinflusst alle Produkte im Chat bei der Produktsuche.
• Bei einer Chat-Suche …: Wirkt nur auf Produkte, die im Chat mit bestimmten Stichwörtern gefunden werden. Wählen Sie Wörter für eine exakte oder nahe Übereinstimmung oder für Suchanfragen, die das/die Wort(e) enthalten.

Recommendations #

Speziell für Onsite-Elemente, die Recommendations-Logik nutzen, wie Bestseller auf der Startseite oder Cross-Sell auf Produktseiten.

• Bei Kategorie-Anzeige: Wählen Sie eine bestimmte Kategorie-Seite nach Name aus. Gilt für die Logik Bestsellers & Trending in Kategorie, egal ob als Banner oder komplette Kategorieseite.
• Bei allen Kategorien: Wie oben, aber auf jeder Kategorieseite.
• Bei passenden Produkten: Gilt für die Logik Best Cross-Sell und Best Alternatives auf Produktseiten, die Ihrer Auswahl entsprechen.
• Bei allen Recommendations: Alle Recommendations-Elemente auf der Seite.

Email #

Spezialisiert für Email-Marketing, sowohl für das Einbetten von Produkten als auch für den Versand von Emails über Clerk.io.

• Nur für spezifische AI-Kampagne: Ausgewählt nach Name.
• Nur für spezifischen Newsletter: Ausgewählt nach Name.
• Nur für spezifischen Trigger: Ausgewählt nach Name.
• Nur für spezifisch eingebettete Email: Ausgewählt nach Embed-Name.
• Bei allen AI-Kampagnen: Zielt auf alle aktiven AI-Kampagnen.
• Bei allen Newslettern: Zielt auf alle aktiven Newsletter.
• Bei allen Triggern: Zielt auf alle aktiven Trigger.
• Bei allen eingebetteten Emails: Zielt auf alle aktiven Email Embeds.

Regeln #

Diese bestimmen, wie Ihre Ergebnisse durch Änderung ihrer Position in den Resultaten beeinflusst werden. Die Position ist einfach, ob ein Produkt als erstes, zehntes, vierunddreißigstes usw. gezeigt wird.

Regeln können sehr breit sein, zum Beispiel das Hervorheben aller Produkte im Ausverkauf, oder sehr spezifisch, wie das Anheften eines bestimmten Nike sneakers im Alternatives-Banner für ein anderes, ähnliches Paar.

Erzwingen #

Ignoriert bestehende Logik, inklusive Filter und anderer Merchandising-Regeln. Produkte können so auch in Ergebnisse gezwungen werden, in denen sie andernfalls nicht erscheinen würden.

• Anheften: Die aggressivste Regel. Hiermit werden ein oder mehrere Produkte ganz nach oben verschoben, unabhängig von anderer Logik.

Sortierung #

Ändert die Reihenfolge der Ergebnisse, zeigt aber nur Produkte, die bereits im Ergebnisset sind.

Beispiel: Wenn Sie Ihre Nike Air 2.0 sneakers bewerben, werden sie nicht bei Suchanfragen wie “T-Shirts” angezeigt, erhalten aber mehr Sichtbarkeit bei Suchanfragen wie “Sneakers”.

Sortierregeln beeinflussen die Ergebnisse, behalten aber die Intelligenz der KI von Clerk.io bei.

• Position im Ergebnis anpassen: Verschiebt passende Produkte prozentual nach oben. Eine 50%-Anpassung bewegt ein Produkt von Platz 20 auf 10; 100% bewegen es auf Platz 1.
• Im Ergebnis hervorheben: Verteilt ausgewählte Produkte über die Ergebnisse, z. B. indem alle 3 Produkte ab Platz 2 ein margenstarkes Produkt platziert wird.
• Auf Position fördern: Platziert ausgewählte Produkte ab einer bestimmten Position, z. B. werden 3 Adidas-Produkte ab Platz 4 gezeigt.
• Nach anderen anzeigen: Ausgewählte Produkte erscheinen nach anderen Produkten, z. B. ausverkaufte Produkte am Ende der Suchergebnisse.
• Leicht hervorheben (Veraltet): Ausgewählte Produkte werden etwas bevorzugt, jedoch ohne größere Auswirkung auf das Ergebnis. Wir empfehlen stattdessen Position im Ergebnis anpassen zu verwenden.
• Deutlich hervorheben (Veraltet): Ausgewählte Produkte werden stark bevorzugt und erscheinen meist ganz oben im Ergebnis. Wir empfehlen stattdessen Position im Ergebnis anpassen zu verwenden.
• Individuelle Hervorhebung (Veraltet): Wählen Sie einen individuellen Multiplikator, um Produkte zu priorisieren. Wir empfehlen stattdessen Position im Ergebnis anpassen zu verwenden.

Entfernen #

Wählt bestimmte Produkte aus, die angezeigt werden können, und blendet andere aus, die nicht den Kriterien entsprechen.

• Nur anzeigen: Nur die ausgewählten Produkte werden angezeigt, auch wenn es andere Übereinstimmungen gibt.
• Ausblenden: Die ausgewählten Produkte werden vollständig ausgeblendet.

Geltungsbereiche #

Clerk verwendet Produkt- und Kategorie-IDs, um Kampagnen anzuwenden. Kampagnen für mehrere Stores funktionieren nur wie vorgesehen, wenn diese IDs in allen Ihren Stores übereinstimmen.

Kampagnen können einem einzelnen Store oder mehreren gleichzeitig hinzugefügt werden. So können Sie gezielt Ergebnisse für Ihr ganzes Unternehmen oder nur die relevanten Teile beeinflussen.

Jede Kampagne kann mit einem Geltungsbereich konfiguriert werden, je nachdem, wo sie laufen soll. Nutzen Sie das Menü Edit scope, um Stores auszuwählen, für die die Kampagne aktiv sein soll.

In der Merchandising-Übersicht können Sie Kampagnen für den aktuellen Store über die Single Store-Seite sehen und erstellen und die Multiple Stores-Seite für kampagnenübergreifende Accounts nutzen.

Zusätzliche Details #

Diese Details erläutern die Randfälle, die wichtig sind, wenn Sie Reihenfolgeregeln konfigurieren oder Fehler beheben:

• Promote in Results, Promote to Position und Adjust Position sortieren nur Produkte um, die bereits im aktuellen Ergebnisfenster sind. Pin kann Produkte hinzufügen, die nicht in den organischen Ergebnissen sind.
• Die Regelpriorität ist Pin, Promote to Position, Promote in Results, dann Adjust Position. Produkte werden verschoben, nicht dupliziert.
• Beachten Sie diese Limits separat:
  • API-limit: Produkte pro Seite.
  • Promote to Position-limit: Produkte, die in dessen Block eingefügt werden.
  • Adjust Position Maximale Tiefe: Wie tief in der Rangliste passende Produkte gefunden werden können.
• Merchandising wird vor der Paginierung ausgeführt. Halten Sie die Seitengröße konsistent, wenn Sie Mehr laden verwenden, und prüfen Sie die erste Seite zusammen mit der nächsten.
• Der zugrunde liegende Search-Service übernimmt einen Großteil der Arbeit für Merchandising, daher beeinflusst die Search-Version das Ergebnisfenster. Search v2 wendet Reihenfolgeregeln auf das gesamte Ergebnis des Endpunkts an, bevor auf die API-limit-Größe gekürzt wird; Search v3 wendet sie auf ein abgegrenztes, abgerufenes Fenster an, bevor gekürzt wird. Ein tief gereihtes Produkt kann in Search v2 erreichbar, in Search v3 aber außerhalb des Fensters sein. Verwenden Sie Pin, wenn das Produkt unbedingt erscheinen muss.

Für Entwickler #

Kampagnen können auch programmatisch ausgelöst und deaktiviert werden, wodurch Sie mehr Kontrolle darüber bekommen, wo sie angewendet werden. Anwendungsfälle sind etwa das Auslösen bei Login bestimmter Kundengruppen oder beim Erreichen einer bestimmten Warenkorbhöhe.

Customer Context #

Für kundenbasierte Regeln in einer benutzerdefinierten Storefront-Integration setzen Sie die bekannte Email des Besuchers in Clerk.js, bevor Sie Aufrufe machen, die dies nutzen sollen:

Clerk('context', 'email', 'customer@example.com');

Ersetzen Sie das Beispiel durch die identifizierte Email des Besuchers. Sie können diese auch beim Aufruf der Storefront-API übergeben. Clerk.io nutzt sie, um Kundendaten abzurufen, ohne auf eine Zuordnung von Kunden zu Besuchern zu warten.

API Trigger #

Erstellen Sie die Kampagne mit dem Trigger Für spezifischen API-Parameter. Kopieren Sie die Kampagnen-ID für API-Aufrufe.

Fügen Sie den Parameter merchandising in die API-Aufrufe ein. Dieser sollte als Liste mit einer oder mehreren Kampagnen-IDs gesendet werden:

$ curl -X POST \
       -H 'Content-Type: application/json' \
       -d '{"key":      "your_api_key",
            "visitor":  "aR9Km32l",
            "limit":    4,
            "labels":   ["Most Popylar"],
            "merchandising": ["boost-bracelets", "high-margin"]' \
       http://api.clerk.io/v2/recommendations/popular

Clerk.js Trigger #

Fügen Sie den Parameter data-merchandising in Ihren Einbettungscode ein. Dieser sollte eine Liste mit einer oder mehreren Kampagnen-IDs enthalten:

<span class="clerk"
  data-template="@home-page-popular"
  data-merchandising="['boost-bracelets', 'high-margin']"
></span>

In der API deaktivieren #

Wenn Clerk.io unerwartete Ergebnisse anzeigt, ist es oft ein guter Startpunkt, alle Merchandising-Kampagnen für einen API-Call zu deaktivieren, um zu prüfen, ob dies die Ursache ist.

Sie können dies tun, indem Sie den Parameter flags=disable.merchandising zum API-Call hinzufügen:

https://api.clerk.io/v2/recommendations/popular?key=your_api_key&flags=disable.merchandising=true

Damit werden alle Merchandising-Kampagnen für diesen API-Aufruf deaktiviert, ohne dass der Rest Ihrer Clerk.io-Konfiguration gestört wird.