> 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/general-parameters.md).

# Allgemeine Parameter

Die folgenden Parameter sind für jeden Aufruf erforderlich oder optional.

| Parameter  |                                                      | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ---------- | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`       | erforderlich                                         | ID des Elements, für das Informationen gesendet werden. Wenn Sie mehrere ID-Felder verwenden, z. B. Produkt-ID, Versions-ID, EAN oder ISBN, klären Sie mit FactFinder, welcher Wert hier übergeben werden soll.                                                                                                                                                                                                                                                                                                                                                                                      |
| `masterId` | erforderlich, wenn **Deduplizierung** verwendet wird | Wenn Ihr Shop Artikelvarianten enthält und Sie die Varianten-ID über den `id` Parameter senden, senden Sie hier auch die Hauptartikelnummer. Dadurch wird sichergestellt, dass Produkte und zugehörige Ereignisse korrekt verknüpft werden.                                                                                                                                                                                                                                                                                                                                                          |
| `channel`  | erforderlich                                         | Der Name des FactFinder-Kanals, in dem die Suche durchgeführt wurde.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `sid`      | erforderlich                                         | <p>Verwenden Sie dies, um die Sitzungskennung des Benutzers zu übergeben. Sie wird für Log-Analysen verwendet, z. B. Click-through-Rate, Search-to-Cart-Rate und Conversion-Rate.</p><blockquote><p>Wenn Sie Personalisierung verwenden möchten, übergeben Sie diesen Parameter für alle Tracking-Ereignisse und für Suchanfragen.</p></blockquote>                                                                                                                                                                                                                                                  |
| `event`    | erforderlich                                         | <p>Dieser Parameter gibt den Ereignistyp an. Bitte verwenden Sie für die verschiedenen Typen die folgenden Werte:</p><ul><li><code>click</code> – Klick auf das Produkt oder den Link zur Detailseite</li><li><code>cart</code> – Produkt in den Warenkorb gelegt</li><li><code>checkout</code> – Produkt gekauft</li><li><code>login</code> – Benutzer meldet sich an</li><li><code>recommendationClick</code> – Klick auf ein von der Recommendation Engine vorgeschlagenes Produkt</li><li><code>feedback</code> – Kommentar zum Suchergebnis, der vom Shop-Besucher hinterlassen wurde</li></ul> |
| `title`    | erforderlich                                         | Der Artikelname. Dieser Wert ist in der Praxis optional. Sie können auch eine leere Zeichenfolge senden oder den Parameter weglassen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `userId`   | erforderlich                                         | Verwenden Sie dies, um eine Benutzerkennung zu übergeben. Wie die Sitzungs-ID muss sie anonymisiert sein. Anders als `sid`, bleibt sie gleich, wenn ein Benutzer zurückkehrt. Dieser Parameter ist für das `login` Ereignis erforderlich, wenn das Modul Personalisierung verwendet wird.                                                                                                                                                                                                                                                                                                            |

## REST

Die Dokumentation der REST-API ist Teil der Suchanwendung und unter \[Ihr NG-Server]/fact-finder/swagger-ui.html verfügbar. Sie können hier auch 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 einsehen. Da die Dokumentation mit Swagger erstellt wurde, können Sie auch Swagger Codegen verwenden, um einen Client zu generieren.

Die Dokumentation der Tracking-Schnittstelle ist unter dem `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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.