> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Browser-SDK im Überblick

> Nutzerverhalten auf Ihrer Website nach einem QR-Code-Scan erfassen: Seitenaufrufe, Klicks, Scrolltiefe, Formularabsendungen und eigene Ereignisse im Überblick.

Das Scanova-Browser-SDK ist ein schlankes JavaScript-Snippet (\~10 KB), das Sie einmal in Ihre Website einbinden. Danach erfasst es automatisch Seitenaufrufe, Link-Klicks, Scrolltiefe und Formularabsendungen — jeweils dem QR-Code-Scan zugeordnet, über den die Person auf Ihre Website gelangt ist.

## Was das SDK tut

Kommt eine Person über einen QR-Code-Scan auf Ihre Website, enthält die URL einen `scnv`-Parameter:

```
https://yoursite.com/?scnv=7ad26d4f-3181-4ef8-b6ca-b8f59499dd43
```

Das SDK:

1. **Liest den `scnv`-Parameter** und speichert ihn im `localStorage` (60 Tage gültig)
2. **Erfasst integrierte Ereignisse** automatisch (Seitenaufrufe, Klicks, Scrollen, Formulare) — je nach Ihrer Konfiguration
3. **Hängt die Zuordnung an** — jedes Ereignis trägt die `scan_session_id` und ist damit mit dem ursprünglichen QR-Code verknüpft
4. **Bleibt seitenübergreifend erhalten** — navigiert die Person zu einer anderen Seite Ihrer Website, wandert die Zuordnung mit

## Automatisch erfasste Ereignisse

Diese aktivieren Sie mit je einem Schalter in den init-Optionen:

| Option         | Was erfasst wird                                               | Gesendeter Ereignistyp |
| -------------- | -------------------------------------------------------------- | ---------------------- |
| `autoPageview` | Jeder Seitenaufruf                                             | `pageview`             |
| `autoClicks`   | Klicks auf Links, Schaltflächen und `[role="button"]`-Elemente | `click`                |
| `autoForms`    | Formularabsendungen                                            | `form_submit`          |
| `autoScroll`   | Scrolltiefe bei 25 %, 50 %, 75 % und 90 %                      | `scroll`               |

Alle Details: [Automatisch erfasste Ereignisse](/de/conversion-tracking/browser/auto-tracking)

## Eigene Ereignisse

Über das Auto-Tracking hinaus können Sie jedes beliebige Ereignis aus Ihrem JavaScript-Code senden:

```javascript theme={null}
scanova('track', 'cta_click', { button: 'Start Free Trial' });
```

Alle Details: [Eigene Ereignisse](/de/conversion-tracking/browser/custom-events)

## Voraussetzungen

* Eine Website, auf der Sie den `<head>`-Bereich bearbeiten oder ein Tag über den Google Tag Manager hinzufügen können
* Eine Tracking-Website, angelegt unter **Analysen → Konversionsverfolgung**, mit Ihrer Domain unter **Allowed Domains**
* Die `site_id` aus dem Dashboard

## Vor der Installation

Stellen Sie sicher, dass:

* [ ] Ihre Tracking-Website im Dashboard angelegt ist
* [ ] die Domain Ihrer Website bei dieser Website unter **Allowed Domains** eingetragen ist
* [ ] Sie wissen, wo Sie ein `<script>`-Tag einfügen (HTML-Vorlage, Header-Bereich des CMS oder GTM)
* [ ] QR-Codes im Scanova-Dashboard mit dieser Tracking-Website verknüpft sind

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="SDK installieren" icon="download" href="/de/conversion-tracking/browser/install">
    Das Snippet direkt oder über den Google Tag Manager einbinden.
  </Card>

  <Card title="SDK-Konfiguration" icon="sliders" href="/de/conversion-tracking/browser/sdk-configuration">
    Alle init-Optionen mit Standardwerten und Beispielen.
  </Card>

  <Card title="Automatisch erfasste Ereignisse" icon="bolt" href="/de/conversion-tracking/browser/auto-tracking">
    Welche Daten jede Auto-Tracking-Funktion erfasst.
  </Card>

  <Card title="Eigene Ereignisse" icon="sparkles" href="/de/conversion-tracking/browser/custom-events">
    Bestimmte Aktionen aus Ihrem JavaScript-Code erfassen.
  </Card>
</CardGroup>
