KORVUS

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://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

Tag 1 — Le snippet Korvus

  1. Connectez-vous à votre compte Korvus et récupérez votre clé API dans les paramètres du site
  2. Dans GTM, créez un nouveau tag HTML personnalisé
  3. Collez le code suivant :
<script>
  window.__korvus = { apiKey: "VOTRE_CLE_API" };
</script>
<script src="https://cdn.korvus.fr/v1/korvus.min.js" defer></script>
  1. Remplacez VOTRE_CLE_API par votre clé API
  2. Configurez le déclencheur sur Toutes les pages
  3. Publiez le conteneur

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.

Tag 2 — Le suivi des transactions

Sans ce second tag, Korvus détecte vos anomalies mais ne connaît pas la valeur de vos commandes. Il ne peut donc pas traduire une fuite en euros perdus, ce qui est la raison d'être du produit. Posez-le dès l'installation.

  1. Créez un second tag HTML personnalisé
  2. Collez le code suivant :
<script>
  window.korvusLayer = window.korvusLayer || [];
  window.korvusLayer.push({
    event: "purchase",
    value: {{Purchase Value}},
    currency: "{{Purchase Currency}}"
  });
</script>
  1. Remplacez {{Purchase Value}} et {{Purchase Currency}} par vos variables de couche de données, celles qui portent le montant et la devise sur votre page de confirmation de commande
  2. Configurez le déclencheur sur votre événement de confirmation de commande
  3. Publiez le conteneur

La devise doit rester entre guillemets. Écrire currency: {{Purchase Currency}} sans guillemets produit currency: EUR, que le navigateur interprète comme une variable inexistante : l'appel entier échoue et la transaction n'est jamais transmise.

Le montant accepte aussi bien un nombre qu'une chaîne brute (449, "449.00", "1 234,56"). Korvus normalise le format côté serveur, vous n'avez rien à nettoyer.

window.korvusLayer est une file d'attente : l'ordre de chargement des deux tags n'a aucune importance. Si votre page de confirmation déclenche le tag de transaction avant que le snippet ait fini de charger, la transaction patiente en mémoire et Korvus la consomme dès son démarrage. Aucun séquencement de tags n'est nécessaire.

Consentement

Le montant d'une commande est une donnée soumise à consentement. Korvus la supprime dans le navigateur, sans aucun appel réseau, lorsque le visiteur n'a pas accepté la collecte. Votre tableau de bord ne reflète donc jamais 100 % de vos conversions, mais 100 % de vos conversions consenties.

Le fait qu'une commande ait eu lieu reste, lui, mesuré sur l'intégralité de votre trafic, sans montant et sans consentement. Korvus s'en sert pour redresser statistiquement vos taux de conversion.

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 7 jours démarre automatiquement.

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

Pour vérifier le tag de transaction, passez une commande de test avec le consentement accepté, puis ouvrez l'onglet Réseau de votre navigateur : la requête envoyée à app.korvus.fr/api/ingest doit contenir un événement purchase portant votre montant. Un code de réponse 202 seul ne prouve rien — il signifie que le lot a été accepté, pas qu'il contenait votre transaction.

SuivantInstallation Shopify