Documentation

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

Installation Shopify

Installez Korvus sur votre boutique Shopify ou Shopify Plus.

Installation sur Shopify

Via Google Tag Manager (recommandé)

Si vous utilisez déjà GTM sur votre boutique Shopify, suivez le guide d'installation GTM.

Via le thème Shopify

  1. Dans l'admin Shopify, allez dans Boutique en ligne → Thèmes → Modifier le code
  2. Ouvrez le fichier theme.liquid
  3. Collez le snippet Korvus juste avant la balise </head> :
<script>
  (function(w,d,s,k){
    w.KorvusConfig={apiKey:k};
    var f=d.getElementsByTagName(s)[0],
        j=d.createElement(s);
    j.async=true;
    j.src='https://cdn.korvus.fr/korvus.min.js';
    f.parentNode.insertBefore(j,f);
  })(window,document,'script','VOTRE_CLE_API');
</script>
  1. Remplacez VOTRE_CLE_API par votre clé
  2. Cliquez sur Enregistrer

Configuration spécifique Shopify

Korvus détecte automatiquement les éléments suivants sur Shopify :

  • Pages produit (PDP) — via l'URL /products/
  • Pages collection (PLP) — via l'URL /collections/
  • Checkout — via les événements Shopify Analytics
  • Rupture de stock — via le bouton d'ajout au panier désactivé

Application Korvus (checkout)

Le snippet ne voit pas le checkout Shopify : la plateforme l'isole du reste de votre boutique. Pour couvrir cette étape, Korvus installe une application dédiée, qui pose un pixel de checkout.

Elle apporte trois choses :

  • La progression dans le tunnel — entrée dans le checkout, saisie du paiement, commande confirmée.
  • Les codes promo appliqués au checkout — le code saisi et le montant de la remise obtenue.
  • Les codes promo refusés au checkout — le code que votre client a tapé et que le checkout n'a pas accepté. C'est ce qui permet à la Sentinelle Codes Promo de distinguer un code qui fonctionne d'un code qui échoue.
  • Le rattachement de la commande à la session du visiteur, pour reconstituer le parcours complet.

Le pixel s'exécute dans une sandbox isolée : il ne lit pas le DOM de votre checkout et n'accède à aucune donnée de vos clients. Ni carte bancaire, ni contenu du panier, ni coordonnées.

Sur un code refusé, seul le code est transmis : le message d'erreur affiché à votre client ne l'est jamais, et aucune autre alerte du checkout (adresse, contact, paiement) n'est lue. Ce tri est fait dans le navigateur, avant tout envoi.

L'installation passe par une autorisation Shopify, pas par une modification de votre thème. Écrivez à contact@korvus.fr pour la déclencher.

Shopify Plus

Pour les boutiques Shopify Plus avec un checkout personnalisé, Korvus s'intègre via le fichier checkout.liquid avec le même snippet.

Vérification

Après installation, les premières sessions apparaissent dans votre dashboard Korvus en quelques minutes. Naviguez sur votre boutique pour générer du trafic test.