Konfiguration

Search bietet verschiedene 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 die Änderungen wirksam werden.

Dieser Prozess kann bis zu 15 Minuten dauern, kann aber je nach Größe Ihres Katalogs schneller sein. Den Status können Sie in Data > Configuration. überwachen.

Für die Einstellungen muss Search 3.0 aktiviert sein. Danach können Sie über Search > Configuration. darauf zugreifen.

Attribut-Suchrelevanz #

In diesem Abschnitt können Sie Ihre Suche nach Ihren Bedürfnissen personalisieren. Hier stehen Ihnen zwei Optionen zur Verfügung: Ranking der durchsuchbaren Attribute und Nicht-durchsuchbare Attribute.

Ranking der durchsuchbaren Attribute #

Mit der Einstellung Durchsuchbare Attribute nach Rang gruppiert können Sie Gruppen von Attributen mit unterschiedlichen Wichtigkeitsstufen für die Suchergebnisse erstellen. Attribute in Gruppen mit höherer Priorität beeinflussen die angezeigten Ergebnisse stärker.

Beispielsweise: Wenn Gruppe 1 "brand" und _category_name enthält, während Gruppe 2 name und color enthält, wird bei einer Suche nach “blaue Nike Stiefel” Produkten mit der Marke “Nike” in der Kategorie “Stiefel” Vorrang vor Artikeln eingeräumt, bei denen diese Begriffe nur im name-Attribut vorkommen.

Diese Priorisierung hilft, wichtige Daten wie Genres, Spezifikationen oder andere Schlüsselfaktoren hervorzuheben.

Zum Beispiel sollte in Buchhandlungen häufig der Autor eines Buches priorisiert werden. Eine Suche nach “Stephen” sollte Bücher von Stephen King höher einordnen als Bücher, die “Stephen” nur im Titel enthalten.

Hinweis: Seien Sie vorsichtig beim Ändern dieser Gruppen. Werden zu viele Attribute hinzugefügt, kann Clerk.io die Produktpopularität abwerten und sich nur noch auf Textrelevanz konzentrieren.

Nicht-durchsuchbare Attribute #

In diesem Abschnitt können Sie Attribute vom Suchindex ausschließen, das heißt, deren Text ist nicht durchsuchbar. Das ist nützlich für interne IDs, Margenwerte oder andere Daten, die Sie für die Anzeige oder Filterung verwenden, aber nicht durchsuchbar machen möchten.

Standardmäßig sind die Attribute price und stock in der Liste enthalten, um zu verhindern, dass Suchen mit Zahlen durch diese Attribute verzerrt werden. Sie können diese Liste je nach Bedarf anpassen.

Sie können nicht-durchsuchbare Attribute auf zwei Arten hinzufügen:

• Manuell aus der Liste der verfügbaren Attribute.
• Über Regeln, falls Sie ein Muster von Attributnamen haben.

Regeln sind besonders hilfreich, wenn Sie mehrere Attribute auf einmal ausschließen möchten. Verwenden Sie dazu das (*) Platzhalterzeichen:

• *_url passt auf alle Attribute, die mit _url enden
• child_* passt auf alle Attribute, die mit child_ beginnen

Filterbare Attribute #

Attribute in dieser Liste sind als Filter/Facetten über Search, Omnisearch und Merchandising verfügbar. 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 wirksam werden.

Exaktes Trefferverhalten #

Standardmäßig gibt Clerk.io alle relevanten Ergebnisse bei Suchen auf Ihrer Website zurück. In bestimmten Fällen — z. B. bei der Suche nach einer SKU oder EAN-Nummer — erwarten Sie jedoch möglicherweise nur eine einzige Übereinstimmung.

Search v3 erforderlich: Diese Funktion ist nur für Stores mit Search v3 verfügbar. Sie können dies in Settings > Features > Early access features. prüfen.

Durch das Hinzufügen von Attributen zu dieser Liste konfigurieren Sie Clerk.io so, dass ein einzelnes Ergebnis zurückgegeben wird, wenn die Anfrage mit einem Wert in diesen Attributen übereinstimmt. Dies deaktiviert auch die Autokorrektur, um sicherzustellen, dass nur das exakte Ergebnis angezeigt wird.

Die häufigsten Attribute sind sku und ean, aber alle synchronisierten Attribute können verwendet werden.

Beim Hinzufügen eines Attributs haben Sie zwei Optionen:

• Einzelnes exaktes Ergebnis zurückgeben, am besten für eindeutige Kennungen wie SKUs oder Produkt-IDs, bei denen ein bestimmtes Produkt zurückgegeben werden soll.
• Mehrere exakte Übereinstimmungen zurückgeben, ideal für Attribute wie Kategorie-IDs, bei denen viele Produkte denselben Wert haben.

Preisbereiche für Facetten #

Hier können Sie den Preisbereich definieren, der für die Suchfilter verwendet wird. Wenn dieses Feld leer bleibt, berechnet Clerk.io die Bereiche dynamisch auf Basis der Preisspanne Ihrer Produktdaten.

Im Textfeld können Sie eine durch Kommas getrennte Liste von Preisen angeben, z. B.: 0,50,100,150,200,…

Benutzerdefiniertes Wörterbuch #

Das benutzerdefinierte Wörterbuch erlaubt Ihnen, Suchbegriffe zu definieren, die normalerweise als separate Wörter statt als ein einzelnes Konzept behandelt werden würden.

Beispiel: Wenn Ihr Katalog Produkte der Sneaker-Marke D.A.T.E. enthält, möchten Sie eventuell „D.A.T.E.“ und „D. A. T. E.“ zum benutzerdefinierten Wörterbuch hinzufügen.

Kriterien #

Clerk.io erkennt eine Anfrage als eindeutige Kennung, wenn:

• Sie alphanumerisch ist und mindestens eines der folgenden Zeichen enthält: “-+/&_.0123456789”.
• Sie mindestens 4 Zeichen lang ist.
• Sie keine Leerzeichen oder Anführungszeichen enthält.

Findet Clerk.io eine einzige exakte Übereinstimmung in einem der eindeutigen Kennzeichnungsattribute, wird dieses Produkt sofort zurückgegeben und alle benutzerdefinierten Such- oder Merchandising-Regeln werden überschrieben. Andernfalls wird die Anfrage wie eine normale Suche behandelt.

Einstellungen überschreiben #

Mit Einstellungen überschreiben können Sie erweiterte Search-Index-Einstellungen anpassen, indem Sie ein JSON-Objekt in Search > Configuration hinzufügen.

Diese Einstellungen steuern, wie Clerk.io Suchergebnisse liest, bewertet, filtert, sortiert und zurückgibt. Es handelt sich um fortgeschrittene Einstellungen, die nur geändert werden sollten, wenn Sie genau wissen, welches Suchverhalten Sie anpassen möchten.

Änderungen können alle Suchergebnisse für den Store beeinflussen. Ein kleiner Tippfehler im JSON kann zudem verhindern, dass das Überschreiben gespeichert wird.

Erweiterte Einstellung: Verwenden Sie das Überschreiben der Einstellungen mit Vorsicht. Wenn Sie unsicher sind, ob ein Überschreiben nötig ist, wenden Sie sich vor der Änderung an den Clerk.io-Support.

Store-spezifische Attribute #

Attribute wie brand, color, size, sku, price oder benutzerdefinierte Kategoriefelder hängen von den mit jedem Store synchronisierten Daten ab.

Das bedeutet, dass sich displayedAttributes, filterableAttributes, searchableAttributes und sortableAttributes von Store zu Store unterscheiden können.

Attribute, die mit einem Unterstrich beginnen, wie _all_categories, _category_name oder _price_range, werden von Clerk.io generiert und stehen allen Stores zur Verfügung.

Beispiel #

Das folgende Beispiel zeigt die Struktur einer Einstellungen-Überschreibung. Ihr Store wird wahrscheinlich andere Attribute verwenden.

{
  "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 Suchergebnissen zurückgeben kann.

Verwenden Sie diese, wenn Sie möchten, dass Suchergebnisse nur die Felder enthalten, die Ihr Design, Ihre API oder Ihre Frontend-Logik benötigen.

searchableAttributes steuert, welche Attribute durchsucht werden, wenn ein Besucher eine Anfrage eingibt.

Die Reihenfolge ist wichtig. Attribute weiter oben in der Liste werden für die Textrelevanz als wichtiger betrachtet.

filterableAttributes steuert, welche Attribute für Filter, Facetten und zur Einschränkung von Ergebnissen per Regel verwendet werden können.

Fügen Sie ein Attribut hier hinzu, wenn es als Facette auswählbar sein oder in Filter-Logik verwendet werden soll. Store-spezifische Produktattribute müssen in den synchronisierten Daten vorhanden sein, bevor sie verwendet werden können.

sortableAttributes steuert, nach welchen Attributen Suchergebnisse sortiert werden können.

Fügen Sie Felder wie price, created_at oder name hinzu, wenn Sie diese zum Sortieren nutzen möchten.

rankingRules steuert die Reihenfolge der Relevanzregeln, die für die Rangfolge der Treffer verwendet werden.

Regeln weiter oben haben den größten Einfluss. Mit benutzerdefinierten Regeln wie clerk.popularity:desc können Sie beliebte Produkte nach den vorherigen Relevanzprüfungen höher einstufen.

stopWords listet Wörter auf, die bei Suchanfragen ignoriert werden sollen.

Das ist nützlich für sehr allgemeine Wörter, die dem Suchenden nicht helfen, Produkte zu finden, wie “the” oder “and”.

nonSeparatorTokens listet Zeichen auf, die ein Wort nicht trennen sollen.

Beispielsweise kann das Hinzufügen von @ bewirken, dass Clerk.io einen Begriff mit diesem Zeichen als zusammenhängenden Wert behandelt.

separatorTokens listet Zeichen auf, die Wörter trennen sollen.

Verwenden Sie dies, wenn Ihre Produktdaten Zeichen enthalten, die Begriffe klar voneinander abgrenzen sollten.

dictionary listet Begriffe auf, die als ein einzelnes Wort oder Konzept behandelt werden sollen.

Das ist nützlich für Markennamen, Abkürzungen oder Produktbegriffe, die normalerweise in mehrere Teile aufgeteilt würden.

synonyms ordnet einem Suchbegriff gleichbedeutende Wörter oder Phrasen zu.

Verwenden Sie Synonyme, wenn Kunden in Ihrem Katalog häufig unterschiedliche Begriffe für dasselbe suchen.

distinctAttribute gruppiert Ergebnisse nach einem gemeinsamen Attribut und gibt pro eindeutigen Wert nur ein Ergebnis zurück.

Das ist hilfreich, wenn Varianten als einzelne Produkte indexiert werden, Sie aber nur ein Ergebnis je Elternprodukt oder Gruppe wollen.

proximityPrecision steuert, wie streng die Nähe von Wörtern bewertet wird.

byWord vergleicht die exakte Entfernung zwischen Treffern. byAttribute prüft, ob Übereinstimmungen im selben Attribut erscheinen.

typoTolerance steuert, wie Search mit Tippfehlern umgeht.

Sie können die Fehler­toleranz aktivieren/deaktivieren, die Mindestwortlänge für einen oder zwei Tippfehler festlegen und die Fehler­toleranz für bestimmte Wörter, Attribute oder Zahlen ausschließen.

faceting steuert, wie Facettenwerte zurückgegeben werden.

maxValuesPerFacet legt fest, wie viele Werte jede Facette zurückgeben kann. sortFacetValuesBy steuert, ob Facettenwerte alphabetisch oder nach Trefferanzahl sortiert werden.

pagination steuert die maximale Anzahl von Ergebnissen, die Search für eine Anfrage zurückgeben kann.

maxTotalHits stellt das oberste Limit für paginierte Ergebnisse dar.

embedders ist für fortgeschrittene semantische Suchkonfigurationen reserviert.

Lassen Sie diesen Wert leer, sofern Ihnen der Clerk.io Support nichts anderes geraten hat.

searchCutoffMs legt die maximale Zeit fest, die Search in Millisekunden für eine Anfrage benötigt, bevor die besten bis dahin gefundenen Ergebnisse zurückgegeben werden.

Verwenden Sie null, um das Standardverhalten beizubehalten.

localizedAttributes kann eine sprachspezifische Behandlung für passende Attributmuster definieren.

Lassen Sie dies auf null, außer Ihr Store hat eine spezielle mehrsprachige Indexierungsarchitektur.

facetSearch steuert, ob Facettenwerte durchsuchbar sind.

Wenn aktiviert, können Kunden und Integrationen innerhalb von Facettenwerten suchen – z. B. eine bestimmte Marke in einem langen Markenfilter finden.

prefixSearch steuert, ob während der Eingabe auch Teilwörter übereinstimmen können.

indexingTime aktiviert die Präfixsuche für ein schnelleres Suchverhalten beim Tippen. Mit disabled wird Präfixsuche abgeschaltet.