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

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

Die Einstellungen erfordern, dass Search 3.0 aktiviert ist. Danach können Sie darauf zugreifen in Search > Configuration.

Attribut-Suchrelevanz #

In diesem Abschnitt können Sie Ihre Suche nach Ihren Bedürfnissen personalisieren. Hier haben Sie zwei Optionen: Suchbare Attribut-Rangordnung und Nicht-suchbare Attribute.

Suchbare Attribut-Rangordnung #

Die Einstellung Searchable attributes grouped by ranking order ermöglicht es Ihnen, Gruppen von Attributen mit unterschiedlichen Wichtigkeitsgraden für Suchergebnisse zu erstellen. Attribute in höher eingestuften Gruppen haben einen größeren Einfluss auf die angezeigten Ergebnisse.

Beispiel: Wenn Gruppe 1 "brand" und _category_name enthält, während Gruppe 2 name und color enthält, dann wird eine Suche nach “blue Nike boots” Produkte mit der Marke “Nike” in der Kategorie “Boots” vor Artikeln mit diesen Wörtern im Attribut name priorisieren.

Diese Priorisierung hilft, bedeutende Daten wie Genres, Spezifikationen oder andere Schlüsselattribute hervorzuheben.

Zum Beispiel ist es in Buchhandlungen oft relevanter, den author eines Buches zu priorisieren. Eine Suche nach “Stephen” sollte Bücher von Stephen King gegenüber Büchern, die “Stephen” im Titel enthalten, priorisieren.

Hinweis: Seien Sie vorsichtig beim Ändern dieser Gruppen. Das Hinzufügen zu vieler Attribute kann dazu führen, dass Clerk.io die Produktpopularität weniger gewichtet und sich nur auf Textrelevanz fokussiert.

Nicht-suchbare Attribute #

In diesem Abschnitt können Sie Attribute vom Suchindex ausschließen, sodass deren Text nicht durchsuchbar ist. Dies ist nützlich für z. B. interne IDs, Margenwerte oder Daten, die Sie zur Anzeige oder zum Filtern verwenden möchten, aber über die Kunden nicht suchen sollen.

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

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

• Manuell aus der Liste der verfügbaren Attribute.
• Mit Regeln, wenn Sie ein Attributmuster mit ähnlichen Namen haben.

Regeln sind besonders hilfreich, wenn Sie mehrere Attribute gleichzeitig ausschließen möchten. Verwenden Sie einfach das (*)-Wildcardsymbol:

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

Filterbare Attribute #

Attribute in dieser Liste stehen als Filter/Facetten in Search, Omnisearch und Merchandising zur Verfügung. Wenn ein Produktattribut bei der Konfiguration von Facetten oder beim Erstellen einer Merchandising-Regel nicht erscheint, fügen Sie es hier hinzu und warten Sie, bis die Konfigurationsanalyse abgeschlossen ist.

• Attribute aus der Liste der verfügbaren Produktattribute hinzufügen.
• Änderungen können bis zu 15 Minuten dauern, je nach Kataloggröße.

Genaues Trefferverhalten #

Standardmäßig liefert Clerk.io alle relevanten Ergebnisse für Suchanfragen auf Ihrer Seite zurück. In bestimmten Fällen – wie bei der Suche nach einer SKU oder EAN-Nummer – erwarten Sie jedoch möglicherweise nur ein einzelnes Ergebnis.

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

Durch das Hinzufügen von Attributen zu dieser Liste konfigurieren Sie Clerk.io so, dass bei einer Übereinstimmung der Suchanfrage mit einem Wert in diesen Attributen nur ein Ergebnis zurückgegeben wird. Zudem wird die Autokorrektur deaktiviert, damit wirklich nur die exakte Übereinstimmung angezeigt wird.

Die gängigsten sind sku und ean, aber es können beliebige synchronisierte Attribute verwendet werden.

Beim Hinzufügen eines Attributs haben Sie zwei Optionen:

• Einzelne exakte Übereinstimmung zurückgeben, ideal für eindeutige Kennungen wie SKUs oder Produkt-IDs, bei denen Sie ein bestimmtes Produkt zurückliefern möchten.
• Mehrere exakte Übereinstimmungen zurückgeben, ideal bei Attributen wie Kategorie-IDs, wo viele Produkte denselben Wert teilen.

Facetten Preisbereiche #

Hier können Sie den Preisbereich definieren, der in den Search-Filtern verwendet wird. Wird das Feld leer gelassen, berechnet Clerk.io diese dynamisch anhand des Preisbereichs Ihrer Produktdaten.

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

Benutzerdefiniertes Wörterbuch #

Mit dem benutzerdefinierten Wörterbuch können Sie Suchbegriffe definieren, die normalerweise als einzelne Begriffe statt als eigene Konzepte behandelt werden.

Wenn Ihr Katalog beispielsweise Produkte der Sneaker-Marke D.A.T.E. enthält, sollten Sie “D.A.T.E.” und “D. A. T. E.” im Wörterbuch hinzufügen.

Kriterien #

Clerk.io erkennt eine Suchanfrage als eindeutigen Bezeichner, wenn:

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

Findet Clerk.io eine einzige exakte Übereinstimmung in einem eindeutigen Kennungsattribut, wird dieses Produkt sofort zurückgegeben – eigene Such- und Merchandisingregeln werden dabei überschrieben. Andernfalls wird die Anfrage wie eine normale Suche behandelt.

Einstellungen überschreiben #

Mit Settings override 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, gewichtet, filtert, sortiert und zurückliefert. Es handelt sich um erweiterte Einstellungen, die normalerweise nur geändert werden sollten, wenn Sie genau wissen, welches Search-Verhalten Sie anpassen möchten.

Änderungen können alle Search-Ergebnisse für den Store beeinflussen. Ein kleiner Tippfehler im JSON kann außerdem verhindern, dass das Override gespeichert wird.

Erweiterte Einstellung: Verwenden Sie Settings override mit Bedacht. Wenn Sie unsicher sind, ob ein Override nötig ist, wenden Sie sich an den Clerk.io Support, bevor Sie Änderungen vornehmen.

Store-spezifische Attribute #

Attribute wie brand, color, size, sku, price oder benutzerdefinierte Kategoriefelder hängen von den jeweils synchronisierten Daten im Store 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 in allen Stores zur Verfügung.

Beispiel #

Das folgende Beispiel zeigt den Aufbau eines Settings override. 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 Search-Ergebnissen zurückgeben kann.

Verwenden Sie diese Einstellung, wenn in Suchergebnissen nur diejenigen Felder angezeigt werden sollen, die Ihr Design, Ihre API-Antworten oder Ihre Frontend-Logik benötigen.

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

Die Reihenfolge ist wichtig: Attribute weiter vorne in der Liste sind wichtiger für die Textrelevanz.

filterableAttributes steuert, welche Attribute für Filter, Facetten und Regeln zum Einschränken von Ergebnissen genutzt werden können.

Fügen Sie ein Attribut hier hinzu, wenn es als Facette auswählbar sein oder in Filterlogik nutzbar sein soll. Produktspezifische Store-Attribute müssen in Ihren synchronisierten Daten existieren, bevor sie verwendet werden können.

sortableAttributes steuert, nach welchen Attributen Search-Ergebnisse sortiert werden können.

Fügen Sie Felder wie price, created_at oder name hinzu, wenn Sie nach diesen sortieren möchten.

rankingRules steuert die Reihenfolge der Relevanzregeln, mit denen übereinstimmende Ergebnisse gewichtet werden.

Regeln am Anfang der Liste haben den größten Einfluss. Benutzerdefinierte Regeln wie clerk.popularity:desc können verwendet werden, um beliebte Produkte nach den vorhergehenden Relevanzprüfungen höher zu listen.

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

Das ist nützlich bei sehr häufigen Wörtern, die Einkäufern nicht helfen, Produkte zu finden (z. B. “the” oder “and”).

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

Wenn Sie zum Beispiel @ hinzufügen, kann Clerk.io einen Begriff mit diesem Zeichen als zusammengehörigen Wert behandeln.

separatorTokens listet Zeichen auf, die Begriffe trennen sollen.

Dies ist hilfreich, wenn Ihre Produktdaten Zeichen enthalten, die Begriffe klar voneinander abgrenzen.

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

Das ist nützlich bei Markennamen, Abkürzungen oder Produktausdrücken, die normalerweise aus mehreren Teilen bestehen.

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

Verwenden Sie Synonyme, wenn Nutzer oft unterschiedliche Begriffe für dasselbe Produkt in Ihrem Katalog eingeben.

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

Das ist hilfreich, wenn Varianten als eigene Produkte indexiert sind, Sie aber nur ein Ergebnis pro Elternprodukt oder Gruppe möchten.

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

byWord vergleicht die tatsächliche Entfernung der übereinstimmenden Wörter. byAttribute prüft, ob die Wörter im selben Attribut vorkommen.

typoTolerance steuert, wie Search mit Tippfehlern umgeht.

Sie können die Toleranz aktivieren/deaktivieren, die Mindestwortlänge für einen oder zwei Tippfehler setzen und die Toleranz für bestimmte Wörter, Attribute oder Zahlen deaktivieren.

faceting steuert, wie Facettenwerte zurückgegeben werden.

maxValuesPerFacet gibt an, wie viele Werte pro Facette ausgegeben werden. sortFacetValuesBy bestimmt, ob Facetten alphabetisch oder nach Trefferanzahl sortiert werden.

pagination steuert die maximale Anzahl an Suchergebnissen, die Search pro Anfrage zurückgeben kann.

maxTotalHits ist das Maximum für alle paginierten Ergebnisse.

embedders ist für erweiterte semantische Search-Setups reserviert.

Lassen Sie dieses Feld leer, es sei denn, der Clerk.io Support empfiehlt eine Konfiguration.

searchCutoffMs legt fest, wie viele Millisekunden Search maximal für eine Anfrage verwenden darf, bevor die besten bisherigen Ergebnisse zurückgegeben werden.

Mit null bleibt das Standardverhalten erhalten.

localizedAttributes kann eine sprachspezifische Behandlung für Attributmuster festlegen.

Lassen Sie diesen Wert auf null, sofern Ihr Store keine spezielle mehrsprachige Indexierung benötigt.

facetSearch steuert, ob Facettenwerte durchsuchbar sind.

Ist diese Option aktiviert, können Käufer oder Integrationen innerhalb der Facetten suchen, z. B. eine bestimmte Marke in einem langen Markenfilter finden.

prefixSearch steuert, ob Teilbegriffe während der Eingabe abgeglichen werden.

indexingTime aktiviert das Präfix-Matching für ein schnelleres Search-as-you-type-Erlebnis. disabled schaltet Präfix-Matching aus.