Documentation

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

Installation via GTM

Installez le snippet Korvus via Google Tag Manager en moins de 5 minutes.

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

Le snippet Korvus

  1. Dans GTM, créez une balise HTML personnalisé et nommez-la « Korvus »
  2. Collez le code suivant :
<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>
  1. Remplacez VOTRE_CLE_API et VOTRE_CLE_ORGANISATION par les deux clés que Korvus vous a transmises
  2. Déclencheur : Initialisation - Toutes les pages. Si votre conteneur sert plusieurs sites, limitez-le à vos domaines avec une condition sur Page Hostname
  3. Publiez le conteneur

N'ajoutez aucune condition de consentement sur cette balise. Le script lit lui-même le choix du visiteur dans votre bandeau de consentement et s'y conforme.

Les deux scripts se chargent en arrière-plan : ils ne ralentissent pas l'affichage de vos pages.

La configuration passe par l'objet window.__korvus plutôt que par des attributs data- sur la balise. C'est la méthode fiable dans Google Tag Manager : lorsque GTM injecte du HTML personnalisé, le script ne peut pas toujours retrouver sa propre balise pour y lire ses attributs.

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.