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 Prozess kann bis zu 15 Minuten dauern, abhängig von der Größe Ihres Katalogs kann es jedoch auch schneller gehen. Den Status können Sie in Data > Configuration. überwachen.

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

Durchsuchbare Attribute #

Wählen Sie aus, nach welchen Produktattributen Käufer suchen können und wie stark jedes Attribut die Übereinstimmung beeinflusst.

Suchen Sie ein Attribut in Searchable attributes und wählen Sie dessen Search relevance:

Beispielsweise setzen Sie brand und _category_name auf High, wenn diese für Ihren Katalog wichtig sind. Verwenden Sie für unterstützenden Text eine niedrigere Relevanz. Vermeiden Sie es, jedes Attribut auf High zu setzen, damit die Produktbeliebtheit weiterhin das Ranking beeinflussen kann.

Verwenden Sie Not searchable für Felder wie interne IDs oder Margenwerte, die Sie für die Anzeige oder Filterung benötigen, aber nicht möchten, dass Käufer danach suchen.

Wildcard-Regeln #

Mit Wildcard-Regeln können Sie Attributgruppen von der Suche ausschließen. Wählen Sie Create a rule für ein Muster wie *url oder child*. Zeilen mit Rule zeigen diese Muster an. Mit Edit kann eine Regel geändert werden.

Für spezifischere Muster gilt: *_url findet Attribute, die auf _url enden, und child_* findet Attribute, die mit child_ beginnen.

Sortierbare Attribute #

Fügen Sie die Produktattribute hinzu, nach denen Suchergebnisse sortiert werden sollen. Dieser Abschnitt folgt auf Searchable attributes.

Filterbare Attribute #

Attribute in dieser Liste stehen als Filter/Fazetten in Search, Omnisearch und Merchandising zur Verfügung. Falls ein Produktattribut nicht erscheint, wenn Sie Facetten konfigurieren oder eine Merchandising-Regel erstellen, 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 bis zu 15 Minuten dauern, abhängig von der Kataloggröße.

Exaktes Übereinstimmungsverhalten #

Standardmäßig zeigt Clerk.io alle relevanten Ergebnisse für Suchanfragen auf Ihrer Website an. In bestimmten Fällen – wie 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. Dies können Sie in Settings > Features > Early access features. überprüfen.

Wenn Sie Attribute zu dieser Liste hinzufügen, konfigurieren Sie Clerk.io so, dass bei Übereinstimmung eines Werts in diesen Attributen nur ein Ergebnis zurückgegeben wird. Außerdem wird die Autokorrektur deaktiviert, damit ausschließlich die exakte Übereinstimmung angezeigt wird.

Die gebräuchlichsten Attribute sind sku und ean, aber auch andere synchronisierte Attribute können verwendet werden.

Beim Hinzufügen eines Attributs haben Sie zwei Optionen:

• Einzelne exakte Übereinstimmung zurückgeben, am besten für eindeutige Bezeichner 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 teilen.

Facetten-Preisbereiche #

Hier können Sie den Preisbereich festlegen, der für die Suchfilter verwendet wird. Wird das Feld leer gelassen, berechnet Clerk.io die Bereiche dynamisch anhand der Preisspanne Ihrer Produktdaten.

Geben Sie kommaseparierte Preise in Add buckets ein, z. B. 0,50,100,150,200. Lassen Sie das Feld leer, um Bereiche dynamisch aus den Produktdaten berechnen zu lassen.

Benutzerdefiniertes Wörterbuch #

Im benutzerdefinierten Wörterbuch können Sie Suchbegriffe definieren, die sonst als einzelne Wörter anstelle eines Konzepts 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 möglicherweise „D.A.T.E.“ und „D. A. T. E.“ dem benutzerdefinierten Wörterbuch hinzufügen.

Kriterien #

Clerk.io erkennt eine Anfrage als eindeutigen Bezeichner, 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 Bezeichner-Attribute, wird dieses Produkt sofort zurückgegeben – unabhängig von individuellen Such- oder Merchandising-Regeln. Andernfalls wird die Anfrage als reguläre Suche behandelt.

Überschreiben von Einstellungen #

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

Diese Einstellungen steuern, wie Clerk.io Suchergebnisse 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 Suchverhalten angepasst werden soll.

Eine Änderung kann alle Suchergebnisse des Stores beeinflussen. Bereits ein kleiner Fehler im JSON kann verhindern, dass das Settings override gespeichert wird.

Erweiterte Einstellung: Verwenden Sie Settings override mit Vorsicht. Wenn Sie nicht sicher sind, ob eine Änderung notwendig ist, wenden Sie sich vorab an den Clerk.io Support.

Storespezifische Attribute #

Attribute wie brand, color, size, sku, price oder individuelle Kategoriefelder hängen von den Daten ab, die jeweils in den Store synchronisiert werden.

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

Mit einem Unterstrich beginnende Attribute wie _all_categories, _category_name oder _price_range werden von Clerk.io erzeugt und sind in allen Stores verfügbar.

Beispiel #

Das folgende Beispiel zeigt die Struktur eines Settings override. Ihr Store verwendet wahrscheinlich andere Attribute.

{
  "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 dies, wenn Ergebnisse nur die Felder enthalten sollen, die Ihr Design, API oder Frontend-Logik benötigt.

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

Die Reihenfolge ist wichtig. Attribute, die früher in der Liste stehen, werden für die Textrelevanz als wichtiger behandelt.

filterableAttributes steuert, welche Attribute als Filter, Facetten oder Regeln verwendet werden können, die Suchergebnisse eingrenzen.

Fügen Sie ein Attribut hinzu, wenn es als Facette auswählbar oder in Filterlogik verwendbar sein soll. Produkteigene Attribute müssen in Ihren 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 für die Sortierung verwenden möchten.

rankingRules legt die Reihenfolge der Relevanzregeln fest, die für das Ranking der Suchergebnisse verwendet werden.

Regeln oben in der Liste haben den stärksten Einfluss. Eigene Regeln wie clerk.popularity:desc können genutzt werden, um beliebte Produkte nach allen anderen Relevanzprüfungen höher zu platzieren.

stopWords enthält Wörter, die in Suchanfragen ignoriert werden sollen.

Das ist nützlich für sehr häufige Wörter, die Käufern bei der Produktsuche nicht helfen, wie z. B. „the“ oder „and“.

nonSeparatorTokens enthält Zeichen, die ein Wort nicht teilen sollen.

Das Hinzufügen von @ hilft Clerk.io beispielsweise, einen Begriff mit diesem Zeichen als zusammenhängenden Wert zu behandeln.

separatorTokens enthält Zeichen, die Wörter trennen sollen.

Verwenden Sie dies, falls Ihre Produktdaten Zeichen enthalten, die einen Begriff klar vom 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 Produktbezeichnungen, die normalerweise in mehrere Teile geteilt werden.

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

Nutzen Sie Synonyme, wenn Käufer häufig unterschiedliche Wörter suchen, die das Gleiche bedeuten.

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

Das ist nützlich, wenn Varianten als einzelne Produkte indiziert werden, Sie aber nur ein Ergebnis pro Hauptprodukt oder Gruppe anzeigen möchten.

proximityPrecision steuert, wie streng die Wortnähe bewertet wird.

byWord vergleicht die exakte Entfernung zwischen übereinstimmenden Wörtern. byAttribute prüft, ob die übereinstimmenden Wörter im selben Attribut erscheinen.

typoTolerance steuert, wie Search mit Tippfehlern umgeht.

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

faceting steuert, wie Facettenwerte zurückgegeben werden.

Mit maxValuesPerFacet beschränken Sie, wie viele Werte pro Facette zurückgegeben werden. sortFacetValuesBy steuert, ob Facettenwerte alphabetisch oder nach Ergebnisanzahl sortiert werden.

pagination legt die maximale Anzahl an Ergebnissen fest, die Search für eine Anfrage zurückgeben kann.

maxTotalHits ist die maximale Zahl, die für paginierte Ergebnisse verfügbar ist.

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

Lassen Sie dieses Feld leer, sofern Clerk.io Support Sie nicht zur Konfiguration auffordert.

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

Verwenden Sie null, um das Standardverhalten beizubehalten.

localizedAttributes kann eine sprachspezifische Behandlung für Attributmuster festlegen.

Belassen Sie dies bei null, sofern Ihr Store keine spezielle mehrsprachige Indexierung benötigt.

facetSearch steuert, ob innerhalb von Facettenwerten gesucht werden kann.

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

prefixSearch steuert, ob Teilwörter bereits beim Tippen übereinstimmen können.

indexingTime aktiviert die Präfixsuche für ein schnelleres Suchverhalten während der Eingabe. disabled deaktiviert die Präfixsuche.