Produktsuche auf der Website

Die Produktsuche besteht aus einem Suchfeld auf der Website mit Vorschlägen während der Eingabe und einer Ergebnisseite, die OneTrace.ru mit Produkten aus Ihrem Katalog füllt. Die Suche versteht Tippfehler, Wortformen und Anfragen, die im falschen Tastaturlayout eingegeben wurden, und ordnet die ersten Ergebnisse nach den Interessen des Besuchers: was er angesehen und gekauft hat.

Voraussetzungen sind ein installierter Tracker (Website anbinden) und ein Produktkatalog (Empfehlungen und Produktkatalog). Die Suche ist nicht in allen Tarifen enthalten: Fehlt sie in Ihrem, wird der Codeblock im Tab „Installation“ nicht angezeigt, und Suchanfragen erhalten den Fehler „Funktion nicht verfügbar“.

Wie Produkte gefunden werden

• Die Wörter der Anfrage werden in Name, Marke, Kategorien und Eigenschaften des Produkts gesucht, die Artikelnummer nur bei exakter Übereinstimmung.
• Wortformen in den Sprachen des Projekts werden berücksichtigt: „куртки“ findet „Куртка зимняя“. Die Sprachen legen Sie in den Projekteinstellungen fest, siehe Projekteinstellungen, Tarif und Audit.
• Tippfehler werden korrigiert: „крутка“ findet „куртку“, „dres“ findet „dress“.
• Auch eine Anfrage im falschen Tastaturlayout funktioniert: „ghbdtn“ wird als „привет“ gesucht.
• Wird zu allen Wörtern nichts gefunden, zeigt die Suche Produkte, die mindestens eines davon enthalten.
• Beliebte und vorrätige Produkte stehen weiter oben. Die Beliebtheit stammt aus den Empfehlungen und wird einmal täglich aktualisiert.
• Die ersten Ergebnisse werden nach den Interessen des Besuchers neu geordnet: Produkte aus Kategorien und Marken, die er angesehen und gekauft hat, rücken nach oben.
• Maße und Parameter in der Suchanfrage – „205/55 r16“, „5x112“, „Winter“ – werden zu Filtern, wenn die Branche des Shops sie kennt.

Neue und geänderte Produkte des Katalogs erscheinen innerhalb einer Minute nach dem Laden des Feeds oder einer API-Anfrage in der Suche.

Suchfeld

Fügen Sie dem Suchfeld Ihrer Website das Attribut data-cdp-search hinzu:

<form action="/search">
  <input name="q" data-cdp-search data-category-url="/catalog/{id}">
</form>

Bei der Eingabe erscheinen unter dem Feld Vorschläge: beliebte Suchanfragen der Website, passende Kategorien und Produkte mit Bild und Preis. Mit den Pfeiltasten blättern Sie darin, Enter öffnet die ausgewählte Zeile, Esc schließt die Vorschläge. Enter ohne ausgewählte Zeile sendet das Formular der Website wie gewohnt ab.

Die Vorschläge übernehmen die Schriftart der Website und enthalten keine Oberflächentexte, daher passen sie zu einer Website in jeder Sprache.

Ergebnisseite

Fertige Plugins für Onlineshops fügen die Ergebnisse selbst in die Suchseite des Shops ein. Auf Ihrer eigenen Website rufen Sie die Produkte über den Tracker ab:

window.addEventListener('load', async () => {
  const q = new URLSearchParams(location.search).get('q');
  const result = await cdp.search(q, { perPage: 24 });
  // result.items – Produkte, result.total – Anzahl der Treffer, result.facets – Kategorien, Marken, Preise und Merkmale für Filter
});

Parameter: category, brand, priceMin, priceMax, sort (relevance, popular, price_asc, price_desc), page, perPage, attributes. Rufen Sie bei einem Klick auf ein Produkt cdp.searchResultClicked(produkt) auf.

Merkmalsfilter. result.facets.attributes enthält die Merkmale der Branche des Shops mit Bezeichnungen in der Sprache des Besuchers und der Produktanzahl je Wert, zum Beispiel „Felgendurchmesser, Zoll“: 16, 17, 18. Übergeben Sie die gewählten Werte in attributes: cdp.search(q, { attributes: { rim_diameter: [17, 18], season: 'winter' } }) – mehrere Werte eines Merkmals werden mit „oder“ verknüpft, verschiedene Merkmale mit „und“. result.filters enthält die im Text der Suchanfrage erkannten Maße und Parameter: Zeigen Sie sie dem Besucher, damit er sieht, warum die Ergebnisse gefiltert sind. Erforderlich ist Tracker 1.15.0.

Gibt es für die Suchanfrage eine Weiterleitung (siehe Regeln für Suchanfragen), enthält result.redirect die Seitenadresse: Öffnen Sie diese statt der Ergebnisse.

Server können dieselben Anfragen mit einem Schreibschlüssel stellen: https://cdp.onetrace.ru/api/v1/search und https://cdp.onetrace.ru/api/v1/search/suggest. Die vollständige Liste der Parameter finden Sie in der API-Referenz: https://cdp.onetrace.ru/api/v1/openapi.json.

Bericht zu Suchanfragen

Der Tab Suche im Bereich „Website“ zeigt, wonach Besucher auf Ihrer Website suchen – für 7, 30 oder 90 Tage:

• Suchen und Besucher – wie oft gesucht wurde und von wie vielen verschiedenen Personen.
• Ohne Ergebnisse – der Anteil der Suchen, die nichts gefunden haben.
• CTR – der Anteil der Besucher, die in den Ergebnissen ihrer Suchanfrage auf ein Produkt geklickt haben.
• Käufe und Umsatz – ein in den Ergebnissen angeklicktes Produkt, das derselbe Kunde innerhalb von 7 Tagen gekauft hat. Der Umsatz wird zum Produktpreis aus dem Katalog berechnet. Sichtbar, wenn in den Empfehlungseinstellungen ein Kaufereignis festgelegt ist, siehe Empfehlungen und Produktkatalog.

Tabellen unter dem Diagramm:

Suchanfragen werden ohne Berücksichtigung von Groß- und Kleinschreibung und zusätzlichen Leerzeichen verglichen. Aus einer Tabellenzeile können Sie direkt ein Synonym oder eine Regel für die Suchanfrage anlegen.

Synonyme

Synonyme sind Wörter und Wortgruppen, die gemeinsam gesucht werden: Eine Suchanfrage mit einem Wort der Gruppe findet auch Produkte zu den anderen. Beispiel: Mit der Gruppe „Turnschuhe, Sneaker, Laufschuhe“ findet die Suche „weiße Sneaker“ auch weiße Turnschuhe.

• Gruppe in beide Richtungen – jedes Wort wird wie die anderen gesucht.
• Gruppe in eine Richtung – nur das erste Wort wird wie die anderen gesucht: „Handy → Smartphone“ findet Smartphones bei der Suche nach „Handy“, „Smartphone“ wird aber nicht als „Handy“ gesucht.

Ein Wort oder eine Wortgruppe wird in der Suchanfrage nur ersetzt, wenn es vollständig vorkommt. Synonyme gelten sofort nach dem Speichern, in Ergebnissen und Vorschlägen. Ein Projekt kann bis zu 500 Gruppen haben, eine Gruppe bis zu 20 Wörter.

Regeln für Suchanfragen

Eine Regel greift, wenn ein Besucher genau nach dieser Anfrage sucht (ohne Berücksichtigung von Groß- und Kleinschreibung, zusätzlichen Leerzeichen und Satzzeichen am Rand), und führt eine oder beide Aktionen aus:

• Angeheftete Produkte – bis zu 24 Produkte stehen in der festgelegten Reihenfolge am Anfang der Ergebnisse, auch wenn die Suche sie selbst nicht findet. Die übrigen Ergebnisse folgen ohne Wiederholungen. Das Anheften gilt bei Sortierung nach Relevanz und ohne Filter; nicht vorrätige Produkte werden nicht angezeigt.
• Weiterleitung – statt der Ergebnisse öffnet sich eine Seite Ihrer Website, z. B. „Versand“ → Seite mit den Versandbedingungen.

Weiterleitungen führen das Suchfeld des Trackers (Enter bei einer Suchanfrage mit Regel), cdp.search() auf Ihrer eigenen Ergebnisseite (Feld redirect) sowie die Plugins für WooCommerce und Magento 2 aus. Ein Projekt kann bis zu 1000 Regeln haben.

Statistik

Der Tracker erfasst zwei Ereignisse:

Aus den search-Ereignissen der letzten 30 Tage ergeben sich die beliebten Suchanfragen in den Vorschlägen. Die Ereignisse sind in der Profilkarte des Kunden sichtbar und in Segmenten verfügbar, zum Beispiel „hat gesucht, aber nicht gekauft“, siehe Segmente.