consentement cookies pour Astro
@cookiecrumbs/astro insère la balise comme premier élément du head de chaque page, au build pour les pages prérendues et à chaque requête en SSR. Un middleware alimente le lecteur de cookie côté serveur.
la règle
Les îlots Astro hydratent les statistiques dès leur montage. Sans couche de consentement, le premier rendu d’un site de contenu embarque déjà un traceur.
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
Les sites Astro sont surtout du HTML statique avec des îlots d’interactivité, et c’est une bonne nouvelle pour le consentement : le runtime peut être écrit dans le HTML au build, en premier dans le head de chaque page, sans rien pour lui faire concurrence. L’intégration fait exactement cela pour les pages prérendues et le répète à chaque requête pour celles rendues côté serveur, si bien qu’un site hybride se comporte partout de la même façon.
Les îlots sont là où se cachent les traceurs. Un GTM chargé par Partytown, un îlot d’analytics côté client, une vidéo YouTube dans un composant client:visible : chacun reçoit une catégorie sur sa balise script ou vérifie l’état du consentement avant de se monter. L’intégration fournit les composants partagés, et le middleware expose le consentement sur Astro.locals pour qu’une page décide côté serveur de rendre un embed ou son placeholder.
Les sites de contenu ont souvent des centaines de pages, et le scan les parcourt dans chaque état de consentement jusqu’au budget de votre offre. Le résultat alimente la déclaration cookies, que vous pouvez monter sur votre page de confidentialité avec CookieDeclaration et qui se met à jour quand le scan suivant trouve du nouveau.
mise en place
Cinq étapes. La CLI en fait l’essentiel, et chacune est aussi un clic dans le tableau de bord.
Détecte Astro, relie le site, écrit la config.
npx cookiecrumbs login
npx cookiecrumbs initUne ligne dans astro.config.mjs. Avec auto: false, vous placez <CookieCrumbs /> vous-même dans votre layout.
npm i @cookiecrumbs/astro
// astro.config.mjs
import { defineConfig } from 'astro/config';
import cookiecrumbs from '@cookiecrumbs/astro';
export default defineConfig({
integrations: [cookiecrumbs({ site: 'pk_live_…', env: 'production' })],
});Les balises soumises au consentement reçoivent type="text/plain" et une catégorie. Les îlots qui chargent des traceurs peuvent vérifier l’état du consentement avant de se monter.
<script type="text/plain" data-cc-category="analytics"
src="https://www.googletagmanager.com/gtag/js?id=G-XXXX"></script>Le middleware place le consentement sur locals, si bien qu’une page peut sauter entièrement un embed pour les visiteurs qui ont dit non.
// src/pages/index.astro
const { consent } = Astro.locals;
const showVideo = consent?.isGranted('marketing');Le scan parcourt le site construit dans chaque état de consentement. Classez une fois, publiez.
npx cookiecrumbs scan --wait
npx cookiecrumbs push --env productionLes sites Astro font souvent tourner GTM via Partytown dans un web worker. Les valeurs par défaut du consentement doivent quand même exister avant son chargement, ce que l’intégration garantit en écrivant le runtime en premier.
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 Astro, et le journal de consentement commence à enregistrer dans l’UE.