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

# Démarrage rapide — en ligne en 5 étapes

> Le chemin le plus court vers le suivi des conversions : créez un site, installez le script, vérifiez les événements et mesurez en moins de 10 minutes.

Ce guide couvre le minimum pour passer d'un compte Scanova à un suivi d'événements opérationnel. Pour aller plus loin, suivez les liens donnés à chaque étape.

## Étape 1 : créer un site de suivi

Un **site de suivi** correspond au domaine d'un site web. Il vous en faut un avant d'installer le SDK ou d'envoyer des événements serveur.

1. Connectez-vous au tableau de bord Scanova
2. Allez dans **Analyses → Suivi des conversions**
3. Cliquez sur **Create Site**
4. Saisissez un nom de site et ajoutez vos **domaines autorisés** (par exemple `yoursite.com`)
5. Enregistrez

Après l'enregistrement, Scanova génère un **`site_id`** unique pour ce site. Vous l'utiliserez dans le script et dans tous les appels d'API.

<Tip>
  Ajoutez tous les noms d'hôte sur lesquels votre script de suivi va tourner : la variante avec `www` comme celle sans `www`, ainsi que les domaines de préproduction sur lesquels vous voulez tester.
</Tip>

## Étape 2 : installer le SDK navigateur

1. Dans **Analyses → Suivi des conversions → Configurer le suivi des conversions**, sélectionnez **Configuration du suivi** sur le site que vous venez de créer et restez sur l'onglet **Intégrer le script**
2. Réglez les interrupteurs de capture automatique (pages vues, clics, envois de formulaires) et le mode débogage
3. Copiez le script généré
4. Collez-le avant `</head>` dans le modèle HTML de votre site

```html theme={null}
<head>
  <!-- other tags -->
  <script>
  (function(w,d,s,o,f,js,fjs){
    w['ScanovaTrackingObject']=o;w[o]=w[o]||function(){(w[o].q=w[o].q||[]).push(arguments)};
    js=d.createElement(s),fjs=d.getElementsByTagName(s)[0];
    js.id=o;js.src=f;js.async=1;fjs.parentNode.insertBefore(js,fjs);
  })(window,document,'script','scanova','https://cdn.scanova.io/ct/js/qcg.min.js');

  scanova('init', 'YOUR_SITE_ID', {
    autoPageview: true,
    autoClicks: true,
    autoForms: true,
    autoScroll: true
  });
  </script>
</head>
```

Vous utilisez Google Tag Manager ? Voir [Installation via GTM](/fr/conversion-tracking/browser/install#option-b-google-tag-manager).

## Étape 3 : relier vos QR Codes au site de suivi

Pour qu'un événement soit rattaché à un QR Code précis, le domaine de destination de ce QR Code doit figurer parmi les **Allowed Domains** de votre site de suivi.

1. Ouvrez un QR Code dans le tableau de bord Scanova
2. Allez dans sa configuration **Settings** ou **Redirect**
3. Vérifiez que l'URL de destination est sur un domaine ajouté à l'étape 1 (par exemple `yoursite.com`)

<Note>
  Si le QR Code redirige vers un domaine qui ne figure **pas** dans les Allowed Domains du site de suivi, les événements du navigateur venant de ce domaine sont rejetés avec `403`. L'attribution ne fonctionne que si le domaine de destination correspond.
</Note>

## Étape 4 : vérifier que le SDK fonctionne

1. Ouvrez votre site dans un navigateur
2. Ouvrez les DevTools, onglet **Network**
3. Filtrez sur `/ct`
4. Rechargez la page — une requête `POST` vers `https://t.scanova.io/ct` doit apparaître avec une réponse `200`

Si vous voyez la requête, le SDK fonctionne. Sinon, voir [Dépannage du SDK navigateur](/fr/conversion-tracking/troubleshooting#browser-sdk-issues).

## Étape 5 : (facultatif) envoyer des conversions côté serveur

Pour les confirmations d'achat, les inscriptions ou d'autres événements du backend, générez une clé d'API et envoyez les événements depuis votre serveur.

1. Ouvrez **Configuration du suivi** sur ce même site, puis l'onglet **Suivre via l'API**
2. Sélectionnez **Add New Key**, donnez-lui un nom, copiez la clé et conservez-la en lieu sûr
3. Envoyez une requête `POST` vers `https://track.scanova.io/server-events` :

```bash theme={null}
curl -X POST "https://track.scanova.io/server-events" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "site_id": "YOUR_SITE_ID",
    "event_name": "purchase",
    "scan_session_id": "SCAN_SESSION_ID_FROM_BROWSER",
    "conversion_value": { "amount": 49.99, "currency": "USD" }
  }'
```

<Warning>
  N'exposez jamais votre `X-API-Key` dans du code exécuté par le navigateur. Elle est réservée au serveur.
</Warning>

Guide complet : [Envoyer des événements serveur](/fr/conversion-tracking/server/send-events)

## Étape 6 : consulter vos données

Ouvrez **Analyses → Suivi des conversions** dans le tableau de bord, sélectionnez votre site et ouvrez l'onglet **Analytics**. Vos premiers événements devraient apparaître 30 à 60 secondes après la vérification du SDK à l'étape 3.

***

## Pour aller plus loin

<CardGroup cols={2}>
  <Card title="Configuration du SDK navigateur" icon="sliders" href="/fr/conversion-tracking/browser/sdk-configuration">
    Toutes les options du SDK : interrupteurs de suivi automatique, mode débogage et le reste.
  </Card>

  <Card title="Événements sur mesure" icon="sparkles" href="/fr/conversion-tracking/browser/custom-events">
    Suivez des actions précises, comme un clic sur un bouton ou un formulaire rempli.
  </Card>

  <Card title="Événements côté serveur" icon="server" href="/fr/conversion-tracking/server/overview">
    Envoyez les conversions du backend en toute sécurité, avec attribution.
  </Card>

  <Card title="Guide SPA et frameworks" icon="react" href="/fr/conversion-tracking/browser/spa-frameworks">
    Les étapes d'installation propres à React, Next.js et Vue.
  </Card>
</CardGroup>
