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

# General Parameters

Reference the common tracking parameters required for FactFinder tracking events.

The following parameters are required or optional for each call.

| Parameter  |                                        | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ---------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`       | essential                              | ID of the item for which information is sent. If you use several ID fields, such as product ID, version ID, EAN, or ISBN, check with FactFinder which value should be passed here.                                                                                                                                                                                                                                                                                                                                                                     |
| `masterId` | essential if **deduplication** is used | If your shop contains item variants and you send the variant ID through the `id` parameter, also send the master item number here. This ensures that products and related events can be linked correctly.                                                                                                                                                                                                                                                                                                                                              |
| `channel`  | essential                              | The name of the FactFinder channel in which the search was conducted.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `sid`      | essential                              | <p>Use this to pass the user’s session identifier. It is used for log analysis, such as click-through rate, search-to-cart rate, and conversion rate.</p><blockquote><p>If you plan to use personalization, pass this parameter for all tracking events and for searches.</p></blockquote>                                                                                                                                                                                                                                                             |
| `event`    | essential                              | <p>This parameter specifies the event type. Please use the following values for the various types:</p><ul><li><code>click</code> – Click on the product or link to the details page</li><li><code>cart</code> – Product placed in the shopping basket</li><li><code>checkout</code> – Product purchased</li><li><code>login</code> – User logs in</li><li><code>recommendationClick</code> – Click on a product suggested by the Recommendation Engine</li><li><code>feedback</code> – Comment on the search result left by the shop visitor</li></ul> |
| `title`    | essential                              | The item name. This value is optional in practice. You can also send an empty string or omit the parameter.                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `userId`   | essential                              | Use this to pass a user identifier. Like the session ID, it must be anonymized. Unlike `sid`, it stays the same when a user returns. This parameter is required for the `login` event if the Personalization module is used.                                                                                                                                                                                                                                                                                                                           |

## REST

The REST API documentation is part of the search application and is available at \[your NG server]/fact-finder/swagger-ui.html. You can also access it here:

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

In addition to the parameter documentation, you can test requests and inspect the results directly. Because the documentation is built with Swagger, you can also use Swagger Codegen to generate a client.

Tracking interface documentation is available under the `tracking` resource.


---

# 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/tracking-interface/general-parameters.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.
