Shop-Cachehit

Wenn Ihr Shop einen eigenen Cache pflegt und Such- und Navigationsanfragen über diesen Cache beantwortet werden, ohne die Anfrage an FactFinder weiterzuleiten, dann geben Sie bitte das log Ereignis an, um FactFinder zu informieren. Dies ist wichtig für korrekte Analysen sowie für Module, die auf Suchmengen basieren (wie ASO). Mit diesem Ereignis senden Sie die wichtigsten Basisdaten des Suchergebnisses, geliefert aus Ihrem Cache.

Das Log-Ereignis benötigt das Ereignis, sidund channel Allgemeine Parameter. Die zu übergebende Session-ID ist die ID der Anfrage, die von Ihrem Cache beantwortet wurde, und nicht die Session-ID der Anfrage, die das zwischengespeicherte Suchergebnis erzeugt hat. Zusätzlich müssen bzw. können die folgenden Parameter übergeben werden:

Parameter	Erforderlich	Beschreibung
query	erforderlich	Der Suchbegriff, für den eine Suche durchgeführt wurde und zu dem Feedback gegeben wurde.
page	erforderlich	Die Nummer der Suchergebnis-Seite, auf der das ausgewählte Produkt angezeigt wurde. Die erste Seite hat die Nummer 1.
pageSize	erforderlich	Die Anzahl der Produkte pro Suchergebnis-Seite zum Zeitpunkt des Klicks.
hitCount	erforderlich	Die Anzahl der im Suchergebnis gefundenen Produkte.
searchTime	erforderlich	Die Zeit, die benötigt wurde, um das Suchergebnis zu erstellen.
bestSimi	erforderlich	Ähnlichkeit des besten Produkts.
minSimi	erforderlich	Ähnlichkeit des letzten Produkts.
filter[FELDNAME]	erforderlich	Informationen über aktive Filter im Suchergebnis. Dieser Parameter besteht aus dem Präfix filter gefolgt vom Namen des Feldes, auf dem der Filter angewendet wurde, wie zum Beispiel filterManufacturer. Dieser Parameter kann mehrmals vorhanden sein, da in mehreren Feldern mehrere Filter gesetzt werden können. Der Wert dieses Parameters besteht aus dem jeweiligen Filterwert, wobei der Wert dem Filterwert einer Suchanfrage entspricht. Bitte beachten Sie, dass Sie die verwendeten Zeichen für und, oder und nicht pro Kanal in den config.xml. Der Wert für diesen Parameter muss dieselben Zeichen verwenden wie die Filter in Ihren Suchanfragen. Wenn Sie zum Beispiel ~~~ für oder, ___ für und und ! für nicht, dann muss der folgende Parameter für einen Filter verwendet werden, der rot oder nicht blau und gelb: red~~~!blue___yellow. Das Log-Ereignis unterscheidet nicht zwischen Filtern und Substring-Filtern. Bitte senden Sie alle aktiven Filter über diesen Parameter.
searchField	erforderlich	Das Feld, für das die Suche ausgeführt wurde, falls die Suche auf ein bestimmtes Feld beschränkt war.
customSorting	erforderlich	Wenn die Standardsortierung für das Suchergebnis nicht verwendet wurde, senden Sie bitte true. Wenn Sie den Parameter nicht übergeben, geht FactFinder davon aus, dass das Suchergebnis mit der Standardsortierung sortiert wurde.
additionalInfo	erforderlich	Sie können diesen Parameter verwenden, um etwas zum Log-Eintrag hinzuzufügen, z. B. um das Durchsuchen des Logs nach einem bestimmten Eintrag zu ermöglichen. Hinweis: Im Gegensatz zu anderen Tracking-Ereignissen log Ereignisse werden in das Suchlog des entsprechenden Kanals geschrieben. Daher sieht der Eintrag eines log Ereignisses wie der Eintrag einer FactFinder-Suche aus. Damit die Log-Ereigniseinträge in den Suchlogs auffindbar sind, enthält der AdditionalInfo Bereich den Eintrag ShopCacheHit (zum Beispiel, AdditionalInfo [ShopCacheHit | sid=session1]). Die Einträge werden in das ASN bzw. Suchlog geschrieben, je nachdem, ob das übermittelte Suchergebnis auf einer Navigations- oder Suchanfrage basiert.

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 Parameterdokumentation, sondern auch die Möglichkeit, eine Abfrage zu testen und das Ergebnis zu prüfen. Die Dokumentation wurde mit Swagger erstellt; Sie können Swagger Codegen verwenden, um einen Client dafür zu generieren und in Ihrem Code zu nutzen.

Die Shop-Cachehit-Ereignis-Dokumentation ist über die log Methode in der tracking Ressource zugegriffen werden.