Suggest-Integration

Zusammenfassung

Das Suggest-Modul verbessert die Benutzererfahrung, indem es während der Eingabe intelligente Vorschläge für Suchbegriffe liefert. Dies hilft Nutzern, relevante Begriffe zu entdecken, ihre Suchanfragen zu verfeinern und Zeit zu sparen, indem sie eine präzise Empfehlung auswählen, anstatt die gesamte Anfrage einzugeben.

Wie Vorschläge erzeugt werden

Vorschläge stammen aus zwei Hauptbereichen:

1. Produktinformationen: Direkter Abzug aus Produktdaten innerhalb der Search-Datenbank.

2. Suchaktivität: Basierend auf der Analyse kürzlich verwendeter, häufig genutzter und erfolgreicher Suchbegriffe.

Hinweis: Sobald Vorschlagsdaten erzeugt sind, werden sie unabhängig von der Live-Produktdatenbank gespeichert. Folglich ist das Filtern von Vorschlägen nach Produktattributen (z. B. Kategorie) standardmäßig nicht verfügbar.

Anzeigen von Vorschlägen

Neben dem vorgeschlagenen Begriff selbst können zusätzliche Informationen angezeigt werden, um den Nutzer weiter zu führen:

• Ursprung/Beschreibung: Klären Sie die Quelle oder Art des Vorschlags (z. B. Kategorie oder vorheriger Suchbegriff).

• Erwartete Trefferanzahl: Zeigen Sie die erwartete Anzahl an Ergebnissen für einen Vorschlag an.

• Vorschaubilder: Zeigen Sie relevante Produktbilder neben den Vorschlägen an. Vorschaubilder müssen in der Management-Oberfläche.

Trefferanzahlen

Standardmäßig basieren die angezeigten Trefferzahlen auf historischen Daten aus Suchlogdateien. Das bedeutet:

• Sie können von der aktuellen, tatsächlichen Anzahl an Ergebnissen abweichen

• Für Begriffe, die noch nie gesucht wurden, wird möglicherweise keine Trefferanzahl angezeigt

Wenn präzise, Echtzeit-Trefferzahlen erforderlich sind, können Sie diese in der Management-Oberfläche.

Vorsicht: Das Aktivieren genauer Trefferzahlen kann die Leistung des Suggest-Importprozesses erheblich beeinträchtigen.

Integrationsmethoden für Suggest

Verwendung eines Proxy-Skripts für die Suggest-Integration

Aufgrund von Browser-Sicherheitsrichtlinien (Same-Origin Policy) kann JavaScript, das auf der Domain des Webshops läuft, nicht direkt Daten von einer anderen Domain oder einem anderen Port anfordern, auf dem die Search-Anwendung gehostet sein könnte.

Warum ein Proxy erforderlich ist: Wenn der Webshop und die Search-Anwendung auf unterschiedlichen Servern liegen oder verschiedene Ports verwenden, ist ein Proxy-Skript in der Regel notwendig.

Wie es funktioniert: Das Proxy-Skript liegt auf dem Webshop-Server. Der Browser sendet die Suggest-Anfrage an dieses Skript. Das Skript leitet die Anfrage an FactFinder weiter und gibt die Antwort an den Browser zurück. Da der Browser mit einem Skript auf derselben Domain interagiert, ist dies zulässig.

Konfiguration: Beim Initialisieren von Suggest im Frontend-Code nutzen Sie die URL des Proxy-Skripts als Request-URL und nicht die direkte URL von FactFinder.

Integration von Suggest über REST

Die technische Dokumentation der REST-API ist in der Search-Anwendung selbst enthalten und kann über [Ihr NG-Server]/fact-finder/swagger-ui.html aufgerufen werden. Sie ist auch über die folgende URL erreichbar:

Swagger-Link: https://ng-demo.fact-finder.de/fact-finder/swagger-ui.html

Die Schnittstelle bietet nicht nur die Parameterausführung, sondern auch die Möglichkeit, eine Abfrage zu testen und das Ergebnis zu überprüfen. Die Dokumentation wurde mit Swagger erstellt; Sie können Swagger Codegen verwenden, um einen Client dafür zu generieren und ihn in Ihrem Code zu nutzen.

Auf Moduldaten wird über die suggest Methode zugegriffen.