Documentation

Tout ce qu'il faut pour installer et configurer Korvus.

Installation HTML

Installez le snippet Korvus directement dans le code HTML de votre site.

Avant d'installer — checklist RGPD obligatoire

Korvus agit comme sous-traitant au sens de l'article 28 du RGPD. Avant de déployer le snippet, vérifiez les 5 points ci-dessous : sans eux, votre site n'est pas en conformité avec l'obligation d'information de l'article 13 du RGPD et l'article 82 de la loi Informatique et Libertés.

  • CMP côté client opérationnelle — votre site doit disposer d'une bannière de consentement qui expose son état via un standard reconnu. Korvus détecte automatiquement Axeptio, Didomi, Cookiebot, OneTrust, le framework TCF v2 IAB Europe et Google Consent Mode v2.
  • Mécanisme d'opt-out visible — le visiteur doit pouvoir refuser la collecte indépendamment de sa CMP via un lien qui pose le cookie korvus_optout=1 (exemple ci-dessous).
  • Content Security Policy (CSP) — si votre site en utilise une, ajoutez https://cdn.korvus.fr à script-src et https://app.korvus.fr à connect-src. Détail sur la page CSP.
  • Mention de Korvus dans votre politique de confidentialité — obligation article 13 RGPD. Nous fournissons un paragraphe prêt-à-coller en FR / IT / ES / EN.
  • Ajout de Korvus à la liste de vos sous-traitants — la liste exhaustive de nos sous-traitants ultérieurs est publiée sur la page Sous-traitants de Korvus.

Exemple de lien d'opt-out

À insérer dans votre politique de confidentialité :

<a href="#" onclick="document.cookie='korvus_optout=1; path=/; max-age=31536000'; alert('La collecte Korvus est désactivée sur ce navigateur.'); return false;">
  Refuser la collecte Korvus
</a>

Prérequis

  • Un compte Korvus actif (créer un compte)
  • Accès à l'en-tête HTML de votre site

Étapes

Ajoutez le snippet suivant avant la balise </head> de toutes les pages de votre site :

<script>
  window.__korvus = { apiKey: "VOTRE_CLE_API", enableProofCapture: true };
  (function () {
    var started = false;
    function startEngine() {
      if (started) return;
      started = true;
      var s = document.createElement("script");
      s.src = "https://cdn.korvus.fr/v2/korvus.min.js";
      s.async = true;
      document.head.appendChild(s);
    }
    var c = document.createElement("script");
    c.src = "https://cdn.korvus.fr/v2/o/VOTRE_CLE_ORGANISATION/" + location.hostname + ".js";
    c.async = true;
    c.onload = c.onerror = startEngine;
    setTimeout(startEngine, 3000);
    document.head.appendChild(c);
  })();
</script>

Remplacez VOTRE_CLE_API et VOTRE_CLE_ORGANISATION par les deux clés que Korvus vous a transmises.

Les deux scripts se chargent en arrière-plan : ils ne ralentissent pas l'affichage de vos pages. Ne conditionnez pas ce code à votre bandeau de consentement : le script lit lui-même le choix du visiteur et s'y conforme.

Content Security Policy (CSP)

Si votre site utilise une CSP, vous devez ajouter les domaines Korvus. Consultez la page CSP pour les directives à ajouter.

Vérification

Après installation, retournez dans votre dashboard Korvus. Les premières données apparaissent en quelques minutes. La période d'apprentissage de 28 jours démarre automatiquement.

Pendant cette période, Korvus observe le comportement normal de votre site sans envoyer d'alertes.