# 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, `sid`und `channel` [Allgemeine Parameter](https://docs.fact-finder.com/integration/de/tracking-interface/general-parameters). 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 &#124; 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.
