consentement cookies pour Nuxt
@cookiecrumbs/nuxt place la balise en tête de app.head.script avec la priorité critical, avant le chunk d’entrée de Nuxt, et importe automatiquement un composable useConsent().
la règle
Une app Nuxt avec un plugin GA ou pixel l’exécute à l’entrée côté client. Rien ne demande avant, et rien ne peut le reprendre.
La règle est la même partout dans l’UE et au Royaume-Uni : rien au-delà du strictement nécessaire ne peut être stocké sur l’appareil d’un visiteur ni lu depuis celui-ci avant son accord. C’est l’article 5(3) de la directive ePrivacy, et cet accord doit répondre à la définition du consentement du RGPD : libre, spécifique, éclairé et univoque, avec un refus aussi simple que l’acceptation. Le Royaume-Uni conserve la même règle dans PECR, avec d’étroites exemptions pour les statistiques à faible risque depuis le 5 février 2026. La Californie et les autres lois des États américains fonctionnent à l’inverse : pas d’opt-in, mais un lien d’opt-out et la prise en charge du signal Global Privacy Control.
Trois choses en découlent pour un site. Les scripts d’analyse, de publicité et de réseaux sociaux doivent attendre un choix. Ce choix doit être enregistré de façon à pouvoir être montré plus tard, car l’article 7(1) met la charge de la preuve sur vous. Et retirer son consentement doit être aussi simple que le donner, ce qui suppose un contrôle qui rouvre la bannière sur chaque page. Une bannière qui affiche deux boutons et charge quand même Google Analytics échoue au premier test, et c’est précisément ce manquement que les autorités sanctionnent, des décisions de la CNIL contre Google et SHEIN aux contrôles des autorités néerlandaise et belge.
comment ça marche
Nuxt gère le head du document pour vous, et c’est exactement là qu’un runtime de consentement doit se trouver. Le module place la balise dans app.head.script avec tagPriority: "critical", si bien qu’elle est rendue avant le chunk d’entrée de Nuxt sur chaque page, rendue côté serveur ou statique. Pas de modification de layout, pas d’appel de head par page.
Les plugins client sont la source habituelle de traceurs précoces dans Nuxt : un plugin gtag, un plugin Pixel, un module tiers qui injecte son propre script. Le composable useConsent() donne à chacun isGranted(category) et un moyen de s’abonner aux changements, si bien qu’un plugin peut attendre et s’initialiser au moment où le consentement arrive. Les modules Nuxt tiers qui injectent des scripts reçoivent une catégorie sur leur balise, ou leur hôte est neutralisé par la carte de blocage issue du scan.
Trois composants accompagnent le module : ConsentGate pour les sous-arbres, CookieDeclaration pour la page de confidentialité et ManageCookiesLink pour le pied de page. Les routes serveur et le middleware peuvent lire le cookie de consentement via les mêmes helpers, si bien qu’une page peut rendre un placeholder plutôt qu’un embed avant l’hydratation.
mise en place
Cinq étapes. La CLI en fait l’essentiel, et chacune est aussi un clic dans le tableau de bord.
Détecte Nuxt, relie le site, écrit la config.
npx cookiecrumbs login
npx cookiecrumbs initLa clé du site et l’environnement vont dans nuxt.config.ts.
npm i @cookiecrumbs/nuxt
// nuxt.config.ts
export default defineNuxtConfig({
modules: ['@cookiecrumbs/nuxt'],
cookiecrumbs: { site: 'pk_live_…', env: 'production' },
});useConsent() expose status, consent, regime, country, language, version et les actions accept, reject, open et withdraw.
const { isGranted, open } = useConsent();
<ConsentGate category="analytics">
<AnalyticsWidget />
</ConsentGate>Un plugin client n’initialise son traceur que lorsque la catégorie est accordée, et de nouveau si le consentement change ensuite.
// plugins/pixel.client.ts
export default defineNuxtPlugin(() => {
const { isGranted, onChange } = useConsent();
const start = () => { if (isGranted('marketing')) initPixel(); };
start(); onChange(start);
});Scannez, classez une fois par fournisseur, publiez.
npx cookiecrumbs scan --wait
npx cookiecrumbs push --env productionLes boutiques Nuxt qui utilisent Google Ads via un plugin gtag reçoivent les valeurs par défaut de Consent Mode du runtime avant le chargement du plugin, si bien que la balise de conversion respecte le choix sans réécriture.
Google Consent Mode v2 est la couche de signalisation entre la bannière et les balises Google. Avant qu’une balise ne s’exécute, sept signaux (ad_storage, analytics_storage, ad_user_data, ad_personalization, functionality_storage, personalization_storage, security_storage) sont positionnés sur « denied » pour les visiteurs de l’EEE, du Royaume-Uni et de la Suisse. Dès que quelqu’un choisit, le runtime les met à jour et les balises Google s’adaptent. Depuis le 15 juin 2026, Google utilise ad_storage comme signal déterminant pour les données Ads, donc la valeur par défaut compte plus qu’avant.
CookieCrumbs fixe les valeurs par défaut de façon synchrone, avant tout gestionnaire de balises, les met à jour à chaque décision et fournit un modèle Google Tag Manager pour que les déclencheurs de consentement existent sans écouteurs écrits à la main. En mode avancé, les pings sans cookies de Google maintiennent les conversions modélisées pour les visiteurs qui ont refusé. Ce qu’il ne fait pas : se faire passer pour une CMP certifiée Google. Pour AdSense, Ad Manager ou AdMob dans l’EEE, il vous en faut toujours une avec IAB TCF, et CookieCrumbs ne l’est pas aujourd’hui.
attention
Chacune apparaît dans le premier scan comme un traceur déclenché avant le consentement.
avant de publier
Huit lignes. Le tableau de bord coche les deux dernières à partir de données réelles.
type="text/plain" avec une catégorie, soit l’hôte figure dans la carte de blocage issue du scan.ce que vous obtenez
Deux domaines, 100 sous-pages scannées par mois et par domaine, toutes les réglementations, la CLI, les SDK et le serveur MCP.
Chaque page, dans chaque état de consentement, dans un vrai navigateur. Cookies, pixels, iframes et clés de stockage, avec la page et le script qui les ont posés. Rescanné selon un planning.
La déclaration cookies s’écrit d’elle-même à partir du résultat.
Les balises restent inertes tant que leur catégorie n’est pas accordée. « Tout refuser » est aussi visible que « Tout accepter ». Sept mises en page, 25 langues, Consent Mode v2 et la bonne règle par région.
21 ko, un seul fichier, aucune requête tierce de son propre chef.
Chaque choix est stocké avec un horodatage, la version de la bannière et un hachage des textes affichés, chaîné à l’enregistrement précédent. Les exports sont signés. Hébergé à Francfort.
Article 7(1), dans l’offre gratuite.
vérification gratuite
Le HTML de la page d’accueil, confronté à la base de traceurs. Pas de compte, rien n’est stocké. Le scan complet du tableau de bord fait de même pour chaque page, dans un vrai navigateur.
questions
étape suivante
Ajoutez le site, lancez npx cookiecrumbs init dans votre dépôt Nuxt, et le journal de consentement commence à enregistrer dans l’UE.