Démarrage rapide — en ligne en 5 étapes

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.

Connectez-vous au tableau de bord Scanova
Allez dans Analyses → Suivi des conversions
Cliquez sur Create Site
Saisissez un nom de site et ajoutez vos domaines autorisés (par exemple yoursite.com)
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.

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.

Étape 2 : installer le SDK navigateur

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
Réglez les interrupteurs de capture automatique (pages vues, clics, envois de formulaires) et le mode débogage
Copiez le script généré
Collez-le avant </head> dans le modèle HTML de votre site

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

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

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

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.

Étape 4 : vérifier que le SDK fonctionne

Ouvrez votre site dans un navigateur
Ouvrez les DevTools, onglet Network
Filtrez sur /ct
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.

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

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

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" }
  }'

N’exposez jamais votre X-API-Key dans du code exécuté par le navigateur. Elle est réservée au serveur.

Guide complet : Envoyer des événements serveur

É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

Configuration du SDK navigateur

Toutes les options du SDK : interrupteurs de suivi automatique, mode débogage et le reste.

Événements sur mesure

Suivez des actions précises, comme un clic sur un bouton ou un formulaire rempli.

Événements côté serveur

Envoyez les conversions du backend en toute sécurité, avec attribution.

Guide SPA et frameworks

Les étapes d’installation propres à React, Next.js et Vue.

Vue d'ensemble

SDK navigateur

Côté serveur

Référence API

Ressources

Démarrage rapide — en ligne en 5 étapes

Étape 1 : créer un site de suivi

Étape 2 : installer le SDK navigateur

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

Étape 4 : vérifier que le SDK fonctionne

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

Étape 6 : consulter vos données

Pour aller plus loin

Configuration du SDK navigateur

Événements sur mesure

Événements côté serveur

Guide SPA et frameworks

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

​Étape 2 : installer le SDK navigateur

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

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

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

​Étape 6 : consulter vos données

​Pour aller plus loin

Configuration du SDK navigateur

Événements sur mesure

Événements côté serveur

Guide SPA et frameworks

Étape 1 : créer un site de suivi

Étape 2 : installer le SDK navigateur

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

Étape 4 : vérifier que le SDK fonctionne

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

Étape 6 : consulter vos données

Pour aller plus loin