> For the complete documentation index, see [llms.txt](https://docs.fact-finder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fact-finder.com/integration/de/tracking-interface/shop-cachehit.md).

# Shop Cachehit

Protokollieren Sie Cache-Treffer auf Shop-Seite, damit FactFinder Analytics und ASO korrekt bleiben.

Wenn Ihr Shop seinen eigenen Cache verwendet und Such- oder Navigationsanfragen aus diesem Cache bedient, ohne sie an FactFinder weiterzuleiten, senden Sie ein `Log` Ereignis, um FactFinder zu benachrichtigen. Dies ist wichtig für korrekte Analytics und für Module, die von der Suchhäufigkeit abhängen, wie zum Beispiel **ASO**. Mit diesem Ereignis senden Sie die wichtigsten Suchergebnisdaten aus Ihrem Cache.

Das Log-Ereignis erfordert das Ereignis, `sid`, und `channel` Parameter, die in [Allgemeine Parameter](/integration/de/tracking-interface/general-parameters.md). Die von Ihnen gesendete Session-ID muss zu der Anfrage gehören, die von Ihrem Cache beantwortet wurde, nicht zur ursprünglichen Anfrage, die das zwischengespeicherte Ergebnis erzeugt hat. Anschließend können Sie die folgenden zusätzlichen Parameter übergeben:

| Parameter         | Erforderlich | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ----------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| query             | erforderlich | Der Suchbegriff, für den die Suche ausgeführt wurde.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| page              | erforderlich | Die Nummer der Suchergebnisseite. Die erste Seite ist Seite 1.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| pageSize          | erforderlich | Die Anzahl der Produkte pro Suchergebnisseite.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| hitCount          | erforderlich | Die Anzahl der im Suchergebnis gefundenen Produkte.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| searchTime        | erforderlich | Die benötigte Zeit, um das Suchergebnis zu erstellen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| bestSimi          | erforderlich | Ähnlichkeit des besten Produkts.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| minSimi           | erforderlich | Ähnlichkeit des letzten Produkts.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| filter\[FELDNAME] | erforderlich | Informationen zu aktiven Filtern im Suchergebnis. Dieser Parameter verwendet das `filter` Präfix, gefolgt vom gefilterten Feldnamen, wie zum Beispiel `filterManufacturer`. Es kann mehrfach vorkommen, da mehrere Filter über mehrere Felder hinweg aktiv sein können. Der Wert muss dieselbe Syntax verwenden wie Filter in Ihren Suchanfragen, einschließlich der konfigurierten Zeichen für `und`, `oder`, und `nicht`. Das Log-Ereignis unterscheidet nicht zwischen Filtern und Teilzeichenfolgenfiltern, daher senden Sie alle aktiven Filter über diesen Parameter.                                           |
| searchField       | erforderlich | Das Feld, in dem die Suche ausgeführt wurde, wenn die Suche auf ein bestimmtes Feld beschränkt war.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| customSorting     | erforderlich | Wenn das Ergebnis nicht die Standardsortierung verwendet hat, senden Sie `true`. Wenn Sie diesen Parameter weglassen, geht FactFinder davon aus, dass die Standardsortierung verwendet wurde.                                                                                                                                                                                                                                                                                                                                                                                                                         |
| additionalInfo    | erforderlich | Sie können diesen Parameter verwenden, um dem Logeintrag Informationen hinzuzufügen, damit er später leichter zu finden ist. Anders als bei anderen Tracking-Ereignissen werden `Log` Ereignisse in das Suchprotokoll des betreffenden Kanals geschrieben. Damit diese Einträge leicht zu identifizieren sind, enthält der `AdditionalInfo` Bereich den Wert `ShopCacheHit`, zum Beispiel `AdditionalInfo [ShopCacheHit \| sid=session1]`. Je nachdem, ob das zwischengespeicherte Ergebnis aus einer Such- oder Navigationsanfrage stammt, wird der Eintrag in das Suchprotokoll oder das ASN-Protokoll geschrieben. |

## REST

Die REST-API-Dokumentation ist Teil der Suchanwendung und unter \[Ihr NG-Server]/fact-finder/swagger-ui.html verfügbar. Sie können auch hier darauf zugreifen:

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

Zusätzlich zur Parameterdokumentation können Sie Anfragen testen und die Ergebnisse direkt überprüfen. Da die Dokumentation mit Swagger erstellt wurde, können Sie auch Swagger Codegen verwenden, um einen Client zu generieren.

Die Dokumentation zum Shop Cachehit-Ereignis ist über die `Log` Methode in der `tracking` Ressource verfügbar.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.fact-finder.com/integration/de/tracking-interface/shop-cachehit.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
