Konfiguration

Search verfügt über mehrere Einstellungen, mit denen Sie das Verhalten anpassen können.
Wenn Sie eine Einstellung ändern, wird eine Analyse Ihrer Daten ausgelöst, die abgeschlossen sein muss, bevor Änderungen wirksam werden.
Dieser Vorgang kann bis zu 15 Minuten dauern, kann aber je nach Kataloggröße auch schneller abgeschlossen sein. Den Status können Sie in Data > Configuration. überwachen.
Sie können die Einstellungen in Search > Configuration. aufrufen.
Durchsuchbare Attribute #
Wählen Sie aus, nach welchen Produktattributen Kund:innen suchen können und wie stark jedes Attribut das Matching beeinflusst.
Finden Sie ein Attribut in Searchable attributes und wählen Sie dessen Search relevance:
| Relevanz | Wirkung |
|---|---|
| High | Treffer in diesem Attribut erhalten eine höhere Relevanz. |
| Medium | Normale Relevanz verwenden. |
| Low | Treffer in diesem Attribut erhalten eine geringere Relevanz. |
| Not searchable | Der Text wird vom Suchabgleich ausgeschlossen. |
Setzen Sie zum Beispiel brand und _category_name auf High, wenn diese für Ihren Katalog wichtig sind. Verwenden Sie eine niedrigere Relevanz für unterstützende Texte. Vermeiden Sie es, jedes Attribut auf High zu setzen, damit die Produktpopularität weiterhin das Ranking beeinflussen kann.
Verwenden Sie Not searchable für Felder wie interne IDs oder Margenwerte, die für die Anzeige oder Filterung benötigt werden, aber nicht durchsuchbar sein sollen.
Wildcard-Regeln #
Wildcard-Regeln können Gruppen von Attributen von der Suche ausschließen. Wählen Sie Create a rule für ein Muster wie *url oder child*. Mit Rule markierte Zeilen zeigen diese Muster. Mit Edit können Sie eine Regel bearbeiten.
Für spezifischere Muster gilt: *_url trifft auf Attribute zu, die auf _url enden, und child_* auf Attribute, die mit child_ beginnen.
Sortierbare Attribute #
Fügen Sie die Produktattribute hinzu, nach denen die Suchergebnisse sortiert werden sollen. Dieser Abschnitt folgt auf Searchable attributes.
Filterbare Attribute #
Attribute in dieser Liste stehen als Filter/Facetten in Search, Omnisearch und Merchandising zur Verfügung. Wenn ein Produktattribut beim Konfigurieren von Facetten oder beim Erstellen einer Merchandising-Regel nicht erscheint, fügen Sie es hier hinzu und warten Sie, bis die Konfigurationsanalyse abgeschlossen ist.
- Fügen Sie Attribute aus der Liste der verfügbaren Produktattribute hinzu.
- Änderungen können je nach Kataloggröße bis zu 15 Minuten dauern, bis sie angewendet werden.
Exact Match Verhalten #
Standardmäßig liefert Clerk.io alle relevanten Ergebnisse für Suchanfragen auf Ihrer Seite. In bestimmten Fällen – wie bei der Suche nach einer SKU- oder EAN-Nummer – erwarten Sie jedoch möglicherweise nur einen einzigen Treffer.
Search v3 erforderlich: Dieses Feature ist nur für Stores mit Search v3 verfügbar. Überprüfen Sie dies in Settings > Features > Early access features.
Indem Sie Attribute zu dieser Liste hinzufügen, konfigurieren Sie Clerk.io so, dass nur ein einzelnes Ergebnis zurückgegeben wird, wenn die Suchanfrage mit einem Wert in diesen Attributen übereinstimmt. Gleichzeitig wird die automatische Korrektur deaktiviert, sodass ausschließlich das exakte Ergebnis angezeigt wird.
Die häufigsten sind sku und ean, aber es können alle synchronisierten Attribute verwendet werden.
Beim Hinzufügen eines Attributs haben Sie zwei Möglichkeiten:
- Einzelnes exaktes Ergebnis zurückgeben, empfohlen für einzigartige Kennungen wie SKUs oder Produkt-IDs, bei denen ein bestimmtes Produkt angezeigt werden soll.
- Mehrere exakte Ergebnisse zurückgeben, ideal für Attribute wie Kategorie-IDs, bei denen viele Produkte denselben Wert teilen.
Facetten-Preisbereiche #
Hier definieren Sie die Preisspannen, die in den Suchfiltern verwendet werden. Wenn das Feld leer bleibt, berechnet Clerk.io diese dynamisch basierend auf Ihren Produktdaten.
Geben Sie in Add buckets Preisspannen mit Kommas getrennt an, z. B. 0,50,100,150,200. Lassen Sie das Feld leer, um die Bereiche dynamisch berechnen zu lassen.
Benutzerdefiniertes Wörterbuch #
Mit dem benutzerdefinierten Wörterbuch können Sie Suchbegriffe definieren, die sonst als eigene Wörter statt als ein Konzept behandelt würden.
Geben Sie einen Begriff in Add term ein und klicken Sie auf Add. Sie können mehrere Begriffe durch Kommas getrennt eingeben.
Wenn Ihr Katalog beispielsweise Produkte der Sneaker-Marke D.A.T.E. enthält, möchten Sie eventuell „D.A.T.E.“ und „D. A. T. E.“ dem Wörterbuch hinzufügen.
Kriterien #
Clerk.io erkennt eine Suchanfrage als eindeutige Kennung, wenn:
- Sie alphanumerisch ist und mindestens eines der folgenden Zeichen enthält: “-+/&_.0123456789”.
- Sie mindestens 4 Zeichen hat.
- Sie keine Leerzeichen oder Anführungszeichen enthält.
Wenn Clerk.io einen einzigen exakten Treffer in einem der eindeutigen Bezeichner-Attribute findet, wird das Produkt sofort angezeigt und überschreibt alle individuellen Search- oder Merchandising-Regeln. Andernfalls wird die Anfrage als normale Suche behandelt.
Einstellungen überschreiben #
Mit Einstellungen überschreiben können Sie erweiterte Search-Indexeinstellungen anpassen, indem Sie ein JSON-Objekt in Search > Configuration hinzufügen.
Diese Einstellungen steuern, wie Clerk.io Ergebnisse liest, bewertet, filtert, sortiert und zurückgibt. Es handelt sich um erweiterte Einstellungen, die normalerweise nur geändert werden sollten, wenn Sie genau wissen, welches Search-Verhalten Sie anpassen möchten.
Durch Änderungen können alle Suchergebnisse für den Store beeinflusst werden. Ein kleiner Tippfehler in JSON kann auch verhindern, dass die Überschreibung gespeichert wird.
Erweiterte Einstellung: Verwenden Sie die Funktion Einstellungen überschreiben mit Vorsicht. Wenn Sie nicht sicher sind, ob eine Überschreibung erforderlich ist, wenden Sie sich an den Clerk.io Support, bevor Sie diese ändern.
Store-spezifische Attribute #
Attribute wie brand, color, size, sku, price oder eigene Kategoriefelder hängen von den synchronisierten Daten jedes Stores ab.
Das bedeutet, dass displayedAttributes, filterableAttributes, searchableAttributes und sortableAttributes von Store zu Store unterschiedlich aussehen können.
Attribute, die mit einem Unterstrich beginnen, wie _all_categories, _category_name oder _price_range, werden von Clerk.io generiert und sind für alle Stores verfügbar.
Beispiel #
Das folgende Beispiel zeigt die Struktur einer Einstellungen-Überschreibung. Ihr Store wird vermutlich andere Attribute nutzen.
{
"displayedAttributes": [
"_all_categories",
"_category_name",
"_price_range",
"brand",
"categories",
"description",
"id",
"image",
"name",
"price",
"stock",
"url"
],
"searchableAttributes": [
"high_relevance",
"medium_relevance",
"low_relevance"
],
"filterableAttributes": [
"_all_categories",
"_category_name",
"_price_range",
"brand",
"categories",
"price",
"stock"
],
"sortableAttributes": [
"created_at",
"name",
"price"
],
"rankingRules": [
"sort",
"words",
"typo",
"attribute",
"proximity",
"clerk.popularity:desc"
],
"stopWords": [],
"nonSeparatorTokens": [],
"separatorTokens": [],
"dictionary": [],
"synonyms": {},
"distinctAttribute": null,
"proximityPrecision": "byAttribute",
"typoTolerance": {
"enabled": true,
"minWordSizeForTypos": {
"oneTypo": 3,
"twoTypos": 8
},
"disableOnWords": [],
"disableOnAttributes": [
"high_relevance.id",
"high_relevance.sku"
],
"disableOnNumbers": false
},
"faceting": {
"maxValuesPerFacet": 100,
"sortFacetValuesBy": {
"*": "alpha"
}
},
"pagination": {
"maxTotalHits": 1000000
},
"embedders": {},
"searchCutoffMs": null,
"localizedAttributes": null,
"facetSearch": true,
"prefixSearch": "indexingTime"
}
Verfügbare Einstellungen #
displayedAttributes steuert, welche Attribute Clerk.io in den Suchergebnissen zurückgibt.
Verwenden Sie dies, wenn die Suchergebnisse nur die Felder enthalten sollen, die Ihr Design, Ihre API oder das Frontend benötigen.
searchableAttributes steuert, in welchen Attributen gesucht wird, wenn ein:e Besucher:in einen Suchbegriff eingibt.
Die Reihenfolge ist wichtig. Attribute weiter vorne in der Liste werden bei der Textrelevanz als wichtiger betrachtet.
filterableAttributes steuert, welche Attribute zum Filtern, als Facetten oder für Regeln genutzt werden können, die die Ergebnisse einschränken.
Fügen Sie hier ein Attribut hinzu, wenn es als Facette auswählbar oder in Filterlogik verwendet werden soll. Store-spezifische Produktattribute müssen in Ihren synchronisierten Daten existieren, bevor sie nutzbar sind.
sortableAttributes steuert, nach welchen Attributen Suchergebnisse sortiert werden können.
Fügen Sie beispielsweise price, created_at oder name hinzu, wenn Sie nach diesen Feldern sortieren möchten.
rankingRules steuert die Reihenfolge der Relevanzregeln, die zum Ranking passender Ergebnisse verwendet werden.
Regeln weiter oben haben den stärksten Einfluss. Eigene Regeln wie clerk.popularity:desc können verwendet werden, um beliebte Produkte nach den vorherigen Relevanzprüfungen höher zu platzieren.
stopWords listet Wörter auf, die in Suchanfragen ignoriert werden sollen.
Dies ist sinnvoll für sehr geläufige Wörter, die Kund:innen nicht beim Finden von Produkten helfen, wie zum Beispiel „the“ oder „and“.
nonSeparatorTokens listet Zeichen auf, die kein Wort trennen sollen.
Wenn Sie zum Beispiel @ hinzufügen, behandelt Clerk.io einen aus diesem Zeichen bestehenden Begriff als zusammengehörigen Wert.
separatorTokens listet Zeichen auf, die Wörter voneinander trennen sollen.
Verwenden Sie dies, wenn Ihre Produktdaten Zeichen enthalten, die einen Begriff klar von einem anderen abgrenzen sollen.
dictionary listet Begriffe auf, die als einzelnes Wort oder Konzept behandelt werden sollen.
Dies ist nützlich für Markennamen, Abkürzungen oder Produktbegriffe, die normalerweise in mehrere Teile gesplittet werden.
synonyms ordnet einen Suchbegriff gleichbedeutenden Wörtern oder Phrasen zu.
Verwenden Sie Synonyme, wenn Kund:innen häufig nach unterschiedlichen Begriffen suchen, die im Katalog das Gleiche bedeuten.
distinctAttribute gruppiert Ergebnisse nach einem gemeinsamen Attribut und gibt pro eindeutigem Wert nur ein Ergebnis zurück.
Das ist sinnvoll, wenn Varianten als eigene Produkte indexiert werden, aber Sie pro Hauptprodukt oder Gruppe nur ein Ergebnis wünschen.
proximityPrecision steuert, wie streng die Wortnähe ausgewertet wird.
byWord vergleicht den exakten Abstand zwischen passenden Wörtern. byAttribute prüft, ob passende Wörter im selben Attribut vorkommen.
typoTolerance steuert, wie mit Tippfehlern umgegangen wird.
Sie können die Fehlertoleranz aktivieren oder deaktivieren, die minimale Wortlänge für einen oder zwei Tippfehler festlegen sowie die Fehlertoleranz für bestimmte Wörter, Attribute oder Zahlen deaktivieren.
faceting steuert, wie Facettenwerte zurückgegeben werden.
maxValuesPerFacet gibt an, wie viele Werte jede Facette maximal zurückgeben kann. sortFacetValuesBy steuert, ob Facettenwerte alphabetisch oder nach Ergebnisanzahl sortiert werden.
pagination steuert die maximale Anzahl an Ergebnissen, die Search für eine Anfrage zurückgeben kann.
maxTotalHits ist das obere Limit für paginierte Ergebnisse.
embedders ist für fortgeschrittene semantische Such-Setups reserviert.
Lassen Sie diesen Bereich leer, es sei denn, der Clerk.io Support hat Sie angewiesen, ihn zu konfigurieren.
searchCutoffMs setzt eine maximale Zeit in Millisekunden fest, die Search für eine Anfrage aufwenden darf, bevor die besten bisherigen Ergebnisse zurückgegeben werden.
Verwenden Sie null, um das Standardverhalten beizubehalten.
localizedAttributes kann sprachspezifisches Verhalten für übereinstimmende Attributmuster definieren.
Lassen Sie dies auf null, außer Ihr Store verwendet einen speziellen mehrsprachigen Indexierungs-Setup.
facetSearch steuert, ob Facettenwerte durchsuchbar sind.
Wenn aktiviert, können Kund:innen und Integrationen innerhalb von Facettenwerten suchen, z. B. eine bestimmte Marke in einer langen Markenfacette finden.
prefixSearch steuert, ob Teilwörter beim Tippen eines Begriffs abgeglichen werden können.
indexingTime aktiviert das Präfix-Matching für schnelleres Suchverhalten während der Eingabe. disabled schaltet Präfix-Matching aus.
Diese Seite wurde von einer hilfreichen KI übersetzt, daher kann es zu Sprachfehlern kommen. Vielen Dank für Ihr Verständnis.