> ## 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.

# Présentation du SDK navigateur

> Suivez le comportement sur votre site après un scan de QR Code : pages vues, clics, profondeur de défilement, envois de formulaire et événements personnalisés.

Le SDK navigateur de Scanova est un snippet JavaScript léger (\~10 Ko) que vous ajoutez une seule fois à votre site. Il suit ensuite automatiquement les pages vues, les clics sur les liens, la profondeur de défilement et les envois de formulaire, le tout attribué au scan de QR Code qui a amené la personne sur votre site.

## Ce que fait le SDK

Lorsqu'une personne arrive sur votre site via un scan de QR Code, l'URL contient un paramètre `scnv` :

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

Le SDK :

1. **Lit le paramètre `scnv`** et l'enregistre dans le `localStorage` (expiration à 60 jours)
2. **Suit les événements intégrés** automatiquement (pages vues, clics, défilement, formulaires) selon votre configuration
3. **Attache l'attribution** : chaque événement porte le `scan_session_id`, qui le relie au QR Code d'origine
4. **Persiste d'une page à l'autre** : si la personne navigue vers une autre page de votre site, l'attribution la suit

## Événements suivis automatiquement

Activez-les avec un seul interrupteur dans les options d'init :

| Option         | Ce qui est suivi                                           | Type d'événement envoyé |
| -------------- | ---------------------------------------------------------- | ----------------------- |
| `autoPageview` | Chaque chargement de page                                  | `pageview`              |
| `autoClicks`   | Clics sur les liens, boutons et éléments `[role="button"]` | `click`                 |
| `autoForms`    | Envois de formulaire                                       | `form_submit`           |
| `autoScroll`   | Profondeur de défilement à 25 %, 50 %, 75 % et 90 %        | `scroll`                |

Tous les détails : [Événements automatiques](/fr/conversion-tracking/browser/auto-tracking)

## Événements personnalisés

Au-delà du suivi automatique, vous pouvez envoyer n'importe quel événement depuis votre code JavaScript :

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

Tous les détails : [Événements personnalisés](/fr/conversion-tracking/browser/custom-events)

## Prérequis

* Un site où vous pouvez modifier la section `<head>` du HTML ou ajouter une balise via Google Tag Manager
* Un site de suivi créé dans **Analyses → Suivi des conversions**, avec votre domaine ajouté sous **Allowed Domains**
* Le `site_id` issu du tableau de bord

## Avant d'installer

Assurez-vous que :

* [ ] Votre site de suivi est créé dans le tableau de bord
* [ ] Le domaine de votre site figure sous **Allowed Domains** pour ce site
* [ ] Vous savez où ajouter une balise `<script>` (modèle HTML, section d'en-tête du CMS ou GTM)
* [ ] Vos QR Codes sont liés à ce site de suivi dans le tableau de bord Scanova

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Installer le SDK" icon="download" href="/fr/conversion-tracking/browser/install">
    Ajouter le snippet directement ou via Google Tag Manager.
  </Card>

  <Card title="Configuration du SDK" icon="sliders" href="/fr/conversion-tracking/browser/sdk-configuration">
    Toutes les options d'init, avec valeurs par défaut et exemples.
  </Card>

  <Card title="Événements automatiques" icon="bolt" href="/fr/conversion-tracking/browser/auto-tracking">
    Les données capturées par chaque fonction de suivi automatique.
  </Card>

  <Card title="Événements personnalisés" icon="sparkles" href="/fr/conversion-tracking/browser/custom-events">
    Suivre des actions précises depuis votre code JavaScript.
  </Card>
</CardGroup>
