Aller au contenu

Documentation

Guide d’installation

01 · Démarrage rapide

Quatre étapes, deux minutes

Mettre en place ConsentLab sur votre site prend moins de deux minutes. Compte gratuit, sans carte bancaire : 5 000 sessions par mois et domaines illimités inclus.

  • Créer votre compte · Inscription gratuite, sans carte bancaire, depuis la page d’inscription du dashboard.
  • Ajouter votre domaine · Depuis votre dashboard, cliquez sur + Ajouter un domaine et saisissez l’URL de votre site (ex. : monsite.fr).
  • Copier le snippet · ConsentLab génère automatiquement un tag <script> personnalisé avec votre clé API, copiable en un clic depuis le dashboard.
  • Coller dans le head · Collez la balise dans le <head> de votre site : le bandeau apparaît immédiatement pour vos visiteurs.

02 · Installation

Une balise dans le head

Le même snippet fonctionne sur toutes les plateformes : remplacez VOTRE_CLE_API par la clé générée dans votre dashboard. La balise est dans la colonne de droite.

Copiez-collez la balise dans le <head> de votre HTML, avant la balise fermante </head> et le plus tôt possible : le widget s’initialise avant le reste de vos outils tiers.

Votre site sert une Content-Security-Policy stricte (par nonce) ? Ajoutez l’attribut nonce sur la balise du loader : le widget le propage automatiquement.

Site en plusieurs langues ? Ajoutez l’attribut optionnel data-locale avec la langue de la page (par exemple data-locale="en") : le bandeau s’affiche dans cette langue. Sans cet attribut, il suit la langue du navigateur du visiteur. Les plugins WordPress, PrestaShop et Shopify le renseignent automatiquement.

Guide complet ConsentLab + CSP

03 · Configuration

Couleurs, textes, position

Toute la configuration se fait depuis votre dashboard ConsentLab, aucune modification de code nécessaire. Le widget lit sa configuration au chargement.

  • Personnalisation visuelle · Couleurs, position (bas, haut, centre), texte des boutons, langue par défaut : tout est configurable sans toucher au code.
  • Catégories de cookies · Configurez les catégories exposées à vos visiteurs : Nécessaires (toujours actifs), Analytiques, Marketing et Préférences.
  • Multi-langue · Le widget détecte automatiquement la langue du navigateur de vos visiteurs. Traductions disponibles : FR, EN, DE, ES, IT, NL et plus.
  • Google Consent Mode v2 · Activé automatiquement, sans aucune configuration. Les signaux ad_storage, analytics_storage, etc. sont envoyés dès que le visiteur fait son choix.

04 · Blocage de scripts

Deux attributs HTML

Pour qu’aucun script tiers ne s’exécute avant le consentement du visiteur, ConsentLab prend en charge le blocage natif via deux attributs HTML (exemple dans la colonne de droite).

  1. Remplacez type="text/javascript" par type="text/plain" : le navigateur ignore le script.
  2. Ajoutez data-cc="analytics" (ou marketing, preferences).
  3. ConsentLab réactive automatiquement le script quand le visiteur accepte la catégorie correspondante.

Pour les scripts chargés via src=, combinez type="text/plain" et data-cc= de la même façon : ConsentLab restaurera le type et rechargera le script après consentement.

Valeurs supportées pour data-cc : analytics, marketing, preferences.

05 · Vérification DNS

Un TXT chez votre registrar

Optionnelle mais recommandée pour tous les sites en production : la vérification DNS prouve que vous êtes bien propriétaire du domaine sur lequel le widget est installé.

  • Pourquoi vérifier ? · Empêche qu’un tiers utilise votre clé API sur un autre domaine, et ajoute un indicateur de confiance dans votre dashboard.
  • Comment faire ? · Ajoutez l’enregistrement TXT (colonne de droite) dans les DNS de votre nom de domaine, chez votre registrar ou hébergeur DNS.
  • Où trouver le token ? · Dans votre dashboard : Paramètres → Sous-domaines → Vérifier. Le token unique à copier s’affiche.

La propagation DNS peut prendre jusqu’à 48 h, mais est généralement effective en moins d’une heure. Cliquez ensuite sur Vérifier dans votre dashboard.

06 · FAQ technique

Les blocages classiques

Le widget n’apparaît pas sur mon site

Vérifiez que la clé API de l’attribut data-cc-key correspond bien à celle de votre dashboard, et que le domaine est bien ajouté dans votre compte ConsentLab. La console développeur (F12) montre les éventuelles erreurs réseau.

Le widget s’affiche mais les consentements ne sont pas enregistrés

Assurez-vous que votre domaine est vérifié via DNS (section 05) : sans vérification, le widget fonctionne en mode local et n’enregistre pas les choix côté serveur.

Google Analytics se charge encore avant le consentement

Utilisez le blocage de scripts (section 04) : ajoutez type="text/plain" et data-cc="analytics" à votre tag Google Analytics, ConsentLab le réactivera après acceptation.

ConsentLab fonctionne-t-il avec des iframes (YouTube, Google Maps) ?

Oui. Ajoutez data-cc="marketing" directement sur la balise <iframe> : ConsentLab bloquera et restaurera la source de l’iframe selon le consentement du visiteur.

Mon site utilise une Content-Security-Policy, que faire ?

Autorisez cdn.consentlab.eu dans vos directives script-src et connect-src, ainsi que les domaines des outils activés au consentement (ex. www.googletagmanager.com et *.google-analytics.com pour Google Analytics), sinon votre CSP les bloquera une fois débloqués par la bannière. Politique stricte par nonce (sans unsafe-inline) : le widget propage le nonce de votre page automatiquement, voir l’onglet ConsentLab + CSP.

Proposez-vous une API pour automatiser la conformité ?

Oui : l’API publique REST /v1 (plans Business et Agence) expose vos statistiques de consentement, votre registre, la configuration du bandeau et les scans de cookies. Voir l’onglet API publique.

Une question non couverte ici ?

Notre équipe répond en moins de 24 h, du lundi au vendredi.

La balise

<script
  src="https://cdn.consentlab.eu/widget/v1/consentlab.min.js"
  data-cc-key="VOTRE_CLE_API"
  defer
></script>

Next.js · App Router

// app/layout.tsx
export default function RootLayout({ children }) {
  return (
    <html lang="fr">
      <head>
        <script
          src="https://cdn.consentlab.eu/widget/v1/consentlab.min.js"
          data-cc-key="VOTRE_CLE_API"
          defer
        />
      </head>
      <body>{children}</body>
    </html>
  );
}

Next.js · Pages Router

// pages/_document.tsx
import { Html, Head, Main, NextScript } from 'next/document';

export default function Document() {
  return (
    <Html lang="fr">
      <Head>
        <script
          src="https://cdn.consentlab.eu/widget/v1/consentlab.min.js"
          data-cc-key="VOTRE_CLE_API"
          defer
        />
      </Head>
      <body>
        <Main />
        <NextScript />
      </body>
    </Html>
  );
}

Blocage d’un script

<script type="text/plain" data-cc="analytics">
  // Google Analytics code here
  gtag('js', new Date());
  gtag('config', 'G-XXXXXXXXXX');
</script>

Vérification DNS

Type  : TXT
Nom   : _consentlab.monsite.fr
Valeur: consentlab-verify=xxxxxxxxxxxxxxxxxxxxxxxx