Référence de configuration du SDK

Le SDK se configure avec un seul appel scanova('init', siteId, options). Cette page documente toutes les options disponibles.

Syntaxe

scanova('init', 'YOUR_SITE_ID', {
  // options here
});

Référence des options

Option	Type	Par défaut	Description
`autoPageview`	boolean	`false`	Envoie automatiquement un événement `pageview` à chaque chargement de page.
`autoClicks`	boolean	`false`	Suit automatiquement les clics sur les liens, boutons et éléments `[role="button"]`.
`autoForms`	boolean	`false`	Suit automatiquement les envois de formulaire.
`autoScroll`	boolean	`false`	Suit la profondeur de défilement aux paliers 25 %, 50 %, 75 % et 90 %.
`debug`	boolean	`false`	Affiche l’activité du SDK dans la console du navigateur. Utile en développement.
`endpoint`	string	`https://t.scanova.io/ct`	Remplace l’endpoint de collecte des événements. À ne modifier que sur indication du support Scanova.

Détail des options

`autoPageview`

Déclenche un événement pageview à chaque initialisation du SDK sur une page, ce qui se produit automatiquement lors des chargements complets. Pour les applications monopage, le guide SPA explique comment déclencher les pages vues aux changements de route.

scanova('init', 'YOUR_SITE_ID', { autoPageview: true });

Chaque événement pageview contient page_url, referrer, scan_session_id ainsi que le contexte appareil et visiteur. Voir Événements automatiques pour le payload complet.

`autoClicks`

Écoute les clics sur :

les balises <a>
les balises <button>
les éléments portant role="button"

L’événement de clic capturé contient element_type, element_text et, pour les liens, éventuellement destination_url. Astuce : ajoutez data-scnv-name="My Button" à n’importe quel élément pour remplacer le libellé capturé :

<button data-scnv-name="Pricing CTA">Start Trial</button>

`autoForms`

Écoute l’événement submit des éléments <form>. Capture form_name et form_action. Les valeurs des champs ne sont jamais capturées — seul l’identifiant du formulaire l’est. Astuce : ajoutez data-scnv-name="Contact Form" à un formulaire pour lui donner un nom lisible dans les rapports.

`autoScroll`

Déclenche des événements de profondeur lorsque la personne dépasse 25 %, 50 %, 75 % et 90 % de la hauteur de page. Chaque palier ne se déclenche qu’une fois par chargement et contient scroll_depth dans les métadonnées.

`debug`

Active la journalisation en console. À utiliser en développement pour vérifier que le SDK s’initialise, capture les événements et les envoie correctement.

scanova('init', 'YOUR_SITE_ID', { debug: true });
// Console output:
// [QCG SDK] Initialized with Site ID: YOUR_SITE_ID
// [QCG SDK] Loaded version 1.x.x

Désactivez debug en production : l’option vaut false par défaut.

Configuration recommandée en production

scanova('init', 'YOUR_SITE_ID', {
  autoPageview: true,
  autoClicks: true,
  autoForms: true,
  autoScroll: true,
  debug: false
});

Configuration minimale (pages vues uniquement)

scanova('init', 'YOUR_SITE_ID', {
  autoPageview: true
});

Configuration manuelle uniquement (sans suivi automatique)

À utiliser si vous voulez un contrôle total sur ce qui est suivi : chaque événement sera envoyé explicitement via scanova('track', ...).

scanova('init', 'YOUR_SITE_ID', {
  autoPageview: false,
  autoClicks: false,
  autoForms: false,
  autoScroll: false
});

Important : un seul init par chargement de page

Appelez scanova('init', ...) une seule fois par cycle de vie de page. Plusieurs appels enregistrent des écouteurs en double et produisent des événements dupliqués. Dans les applications monopage, appelez init une fois au démarrage de l’application, pas à chaque changement de route. Utilisez le guide SPA pour le suivi des changements de route.

Désactiver le suivi pour certains utilisateurs

Le SDK n’a pas de méthode disable() intégrée. Pour ne pas suivre certains utilisateurs (personnel connecté, personnes opposées au suivi, robots), évitez conditionnellement de charger le snippet :

<script>
  // Example: skip tracking for your own team
  const isInternalUser = document.cookie.includes('internal_user=true');

  if (!isInternalUser) {
    (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 });
  }
</script>

Le même schéma vaut pour le consentement RGPD : ne chargez le SDK qu’après accord de la personne. Voir Confidentialité et RGPD pour le détail.

Vue d'ensemble

SDK navigateur

Côté serveur

Référence API

Ressources

Syntaxe

Référence des options

Détail des options

`autoPageview`

`autoClicks`

`autoForms`

`autoScroll`

`debug`

Configuration recommandée en production

Configuration minimale (pages vues uniquement)

Configuration manuelle uniquement (sans suivi automatique)

Important : un seul init par chargement de page

Désactiver le suivi pour certains utilisateurs

​Syntaxe

​Référence des options

​Détail des options

​autoPageview

​autoClicks

​autoForms

​autoScroll

​debug

​Configuration recommandée en production

​Configuration minimale (pages vues uniquement)

​Configuration manuelle uniquement (sans suivi automatique)

​Important : un seul init par chargement de page

​Désactiver le suivi pour certains utilisateurs

Syntaxe

Référence des options

Détail des options

`autoPageview`

`autoClicks`

`autoForms`

`autoScroll`

`debug`

Configuration recommandée en production

Configuration minimale (pages vues uniquement)

Configuration manuelle uniquement (sans suivi automatique)

Important : un seul init par chargement de page

Désactiver le suivi pour certains utilisateurs