Guide d'installation Astro

Ajoutez Velo à Astro

Installez la bannière de cookies Velo et Google Consent Mode v2 sur Astro avec une seule ligne dans votre layout partagé. Avec un accès au code du site, la plupart des installations prennent quelques minutes. Si vous utilisez Google Tag Manager, cette page couvre aussi cette méthode.

Instructions et sources des images revues le 7 novembre 2026.

Compatible avec les plateformes sur lesquelles vous créez

WordPressShopifyWebflowWixHubSpotPrestaShopDrupalBigCommerceShopwareNext.jsAstroSquare

Ce qu’il vous faut sur Astro

Avant de commencer

  • Où. src/layouts/Layout.astro → head
  • Prérequis. Tout projet Astro
  • Actif. Après votre prochain déploiement
  • Durée type. Environ cinq minutes

Une fois en ligne

  • Votre bannière suit les réglages par défaut que vous définissez pour la région de chaque visiteur.
  • Les balises attendent que le visiteur ait choisi.
  • Chaque choix est enregistré, et Consent Mode v2 le transmet à vos balises Google.
CMConsent Mode v2GPCGlobal Privacy ControlUERGPDUSLois des États américains

Deux façons d’installer Velo sur Astro

Choisissez la méthode qui correspond à la façon dont votre site charge déjà ses balises. Les deux aboutissent à la même bannière et aux mêmes signaux.


Collez une ligne dans votre layout

Ajoutez l’extrait de votre site dans le head commun à tout le site, puis publiez et testez-le sur le site en ligne. Si vos balises de mesure passent déjà par Google Tag Manager, utilisez plutôt la méthode plus bas.

Vous utilisez Tag Manager ? Oubliez le code

Si Google Tag Manager est déjà installé sur votre site, c'est le moyen le plus simple d'ajouter Velo. Aucun code à toucher, quatre étapes courtes, et toutes vos balises restent au même endroit.

Environ cinq minutesTemps d’installation habituel sur Astro
Après votre prochain déploiementQuand la bannière est mise en ligne
1,500Sessions mensuelles avec l’offre Free, pour un site
Si vous utilisez ClientRouter, Astro remplace tout le body de la page à chaque navigation, ce qui supprime la bannière et le bouton qui la rouvre. Ajoutez le court second script de l’étape 2 et les deux restent. Sans ClientRouter, chaque lien recharge entièrement la page et vous n’avez pas besoin de ce script.
!
Un point de vigilanceInstallation Astro
Voir toutes les plateformes prises en charge

Tout ce dont une configuration de consentement a besoin

La même bannière, les mêmes registres et les mêmes analyses dans toutes les offres. Pro ajoute des sites illimités, des analyses illimitées et votre propre logo.


Votre bannière pose la question dans la langue du visiteur et suit les réglages par défaut que vous définissez pour sa région.

Chaque choix est enregistré, et Consent Mode v2 le transmet à vos balises Google.


Google Consent Mode v2Mode avancé dans toutes les offres, avec un modèle Google Tag Manager.
Règles selon le pays du visiteurOpt-in là où la loi le demande, et des règles plus strictes pour 60 pays au maximum.
Lois américaines sur la vie privéeUne bannière opt-out avec l’option « Ne pas vendre ni partager ».
Global Privacy ControlLes signaux GPC sont respectés dans toutes les offres.
Refuser, aussi simple qu’accepterRefuser figure à côté d’Accepter dès le premier niveau.
La langue du visiteurChoisie d’après son navigateur, avec vos propres textes de bannière dans chaque langue.
Mises en page et thèmesCoin, barre ou fenêtre centrée, à vos couleurs, en clair ou en sombre.
Testez votre bannière en A/BFaites tourner de 2 à 8 versions de la bannière en parallèle.
Journal des consentementsChaque décision est conservée 3 ans, avec recherche de reçu par identifiant.
Tableau de bord du consentementTaux d’acceptation et de refus sur 7 à 90 jours.
Analyses des cookies et traceursCatégories d’après des signatures connues, plus des suggestions de l’IA que vous approuvez.
Blocage des scriptsLes scripts attendent leur catégorie de consentement avant de s’exécuter.

Collez une ligne dans votre layout

Ajoutez l’extrait de votre site dans le head commun à tout le site, puis publiez et testez-le sur le site en ligne. Si vos balises de mesure passent déjà par Google Tag Manager, utilisez plutôt la méthode plus bas.

Copier la ligne

Copiez l'extrait d'installation complet de ce site depuis votre tableau de bord Velo. L'exemple ci-dessous montre le format ; remplacez your-site-id avant de l'utiliser. Conservez l'endpoint d'API fourni par votre tableau de bord.

Exemple d’extrait de code
<script src="https://cdn.veloconsent.com/v1/velo.js" data-api="https://app-staging.veloconsent.com" data-velo-site="your-site-id" async></script>

Collez-la dans votre layout partagé

Ouvrez le layout partagé par toutes les pages, en général src/layouts/Layout.astro. Collez votre extrait Velo complet dans <head>, au-dessus de toute balise d’analyse ou de publicité, et ajoutez is:inline à la balise script pour qu’Astro la laisse telle quelle. Si le layout utilise <ClientRouter />, Astro remplace le body à chaque navigation, ce qui supprime la bannière. Pour la conserver, ajoutez dans le même head un script is:inline qui stocke #velo-banner-host et #velo-reopener-host sur astro:before-swap et les ajoute à document.body sur astro:after-swap. Ensuite, compilez et déployez.

Astro · layout partagé
<!-- src/layouts/Layout.astro: the layout every page shares -->
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <!-- Paste the complete Velo snippet from your dashboard here, then add is:inline. -->
    <script is:inline src="https://cdn.veloconsent.com/v1/velo.js"
            data-api="https://app-staging.veloconsent.com"
            data-velo-site="your-site-id" async></script>

    <!-- Only if this layout uses <ClientRouter />: keeps the banner across page swaps. -->
    <script is:inline>
      document.addEventListener('astro:before-swap', () => {
        window.veloHosts = [...document.querySelectorAll('#velo-banner-host, #velo-reopener-host')];
      });
      document.addEventListener('astro:after-swap', () => {
        document.body.append(...window.veloHosts);
      });
    </script>
  </head>
  <body>
    <slot />
  </body>
</html>
Référence de configuration vérifiée d'après la documentation de la plateforme. Ce n'est pas une capture d'écran de l'administration. Référence de configuration vérifiée · 7 novembre 2026. Documentation de la plateforme ↗

Publier et vérifier le site en ligne

Enregistrez et publiez la modification en suivant les étapes de la plateforme ci-dessus, puis videz le cache du site ou du CDN. Ouvrez l'URL publiée dans une nouvelle session de navigateur. Vérifiez la bannière là où vos règles régionales l'exigent, testez l'acceptation et le refus, et vérifiez les valeurs de consentement par défaut et leurs mises à jour avant que vos balises de mesure ne se déclenchent. Confirmez que le site apparaît comme installé dans votre tableau de bord Velo.

La bannière de Velo dans son apparence par défaut. Le texte, les couleurs et les réglages par région de votre bannière peuvent être différents.

Vous utilisez Tag Manager ? Oubliez le code

Si Google Tag Manager est déjà installé sur votre site, c'est le moyen le plus simple d'ajouter Velo. Aucun code à toucher, quatre étapes courtes, et toutes vos balises restent au même endroit.

Le guide complet de Tag Manager

Ajoutez Velo à Tag Manager

Ouvrez le modèle Velo, cliquez sur Add to workspace, puis choisissez votre conteneur. Ouvrir le modèle Velo ↗

Collez l'identifiant de votre site

Dans Tag Manager, ouvrez Tags et cliquez sur New. Cliquez sur Tag Configuration, choisissez Velo CMP et collez l'identifiant de votre site. Vous le trouverez dans votre tableau de bord Velo. Laissez tout le reste tel quel.

Faites-le charger en premier

Cliquez sur Triggering, choisissez Consent Initialization – All Pages, puis cliquez sur Save. Ainsi, Velo démarre avant vos autres balises.

Publiez et vérifiez

Cliquez sur Submit, puis sur Publish. Preview seul ne met pas Velo en ligne. Ouvrez ensuite votre site dans une fenêtre privée, testez le bandeau et vérifiez que le site apparaît comme installé dans votre tableau de bord Velo.

Ou confiez-le à un agent

Copiez le prompt dans Claude, ChatGPT, Cursor ou l'assistant que vous utilisez déjà. Il contient tout ce qui est sur cette page : les deux méthodes, l'ordre dans lequel les balises doivent se charger et les vérifications qui prouvent que ça a marché.

Installer avec l’IA

Le prompt

Collez ce prompt dans votre assistant, puis fournissez l'identifiant de votre site et l'extrait de code d'installation complet, ou les réglages GTM, de votre tableau de bord Velo.

Prompt d'installation · Astro
Installez Velo sur Astro.

Guide à jour : https://veloconsent.com/astro

Avant toute modification, récupérez mon identifiant de site et l'extrait d'installation complet ou les paramètres GTM dans le tableau de bord Velo. Vérifiez quel outil de consentement et quelles balises de mesure tournent déjà sur le site.

Choisissez une seule méthode d'installation :
A. Si le site utilise déjà Google Tag Manager, ajoutez le modèle Velo CMP (publié par veloconsent) depuis la Community Template Gallery. Renseignez mon identifiant de site, le thème et l'endpoint d'API indiqués dans le tableau de bord. Passez en revue les options avancées ; ads_data_redaction et url_passthrough sont désactivées par défaut. Utilisez Consent Initialization – All Pages, puis passez par Preview et vérifiez le consentement avant de publier. Étapes complètes : https://veloconsent.com/google-tag-manager

B. Pour une installation directe : Dans le layout partagé par toutes les pages, en général src/layouts/Layout.astro, collez votre extrait Velo complet dans <head>, au-dessus de toute balise d'analyse ou de publicité, et ajoutez is:inline à la balise script pour qu'Astro la laisse telle quelle. Si le layout utilise <ClientRouter />, Astro remplace le body à chaque navigation, ce qui supprime la bannière : dans le même head, ajoutez un script is:inline qui stocke #velo-banner-host et #velo-reopener-host sur astro:before-swap et les ajoute à document.body sur astro:after-swap. Compilez et déployez.

Ne touchez pas au code sans rapport avec l'installation. Évitez les installations de Velo en double et les valeurs de consentement par défaut concurrentes. Ne partez pas du principe qu'un placement dans le head ou un chargement async suffit à garantir l'ordre des balises.

Contrôlez le site publié dans une nouvelle session. Vérifiez la bannière selon les règles régionales configurées, les valeurs de consentement initiales par défaut, les mises à jour après acceptation ou refus et l'événement velo_consent_update. Vérifiez que les balises non Google suivent les catégories qui leur sont attribuées. Testez une deuxième page et toute page de paiement séparée. Confirmez que les signaux arrivent bien dans le tableau de bord Velo.

Indiquez ce qui a changé, à quel endroit, et le résultat de chaque vérification. Signalez tout accès manquant et toute vérification que vous n'avez pas pu effectuer.
Vous travaillez avec un agent qui lit le web ? Envoyez-le sur veloconsent.com/llms.txt et /install.md pour le même contexte en texte brut.

Du journal

Notes sur les bannières de cookies, Consent Mode et les données qui se perdent entre les deux.


Sites canadiens et Google Consent Mode v2
V
Le journal Velo11 novembre 2026

Google Consent Mode v2 dans Velo : les nouveautés

2 novembre 2026Lire l’article

Comment configurer Google Consent Mode v2 sur Shopify

2 septembre 2026Lire l’article

Questions fréquentes sur Velo et Astro

Quels sites Astro sont concernés ?

Tout projet Astro doté d’un layout partagé, qu’il soit statique ou rendu côté serveur, car la balise se trouve dans le HTML produit par le layout. Nous avons testé ces étapes sur Astro 7 en sortie statique.

Dois-je ajouter is:inline ?

C’est le choix prudent. Astro laisse déjà tel quel tout script qui a d’autres attributs que src, donc l’extrait reste intact dans tous les cas, et is:inline le rend explicite. Gardez les attributs data exactement comme votre tableau de bord les affiche.

La bannière disparaît quand je clique sur un lien.

C’est ClientRouter qui remplace le body de la page quand les visiteurs naviguent. Ajoutez le second script de l’étape 2 dans le même head, et la bannière et le bouton qui la rouvre passent à chaque nouvelle page. transition:persist d’Astro n’aide pas ici, car Velo ajoute ces éléments une fois la page chargée.

Mon site a plusieurs layouts.

Placez l’extrait dans le layout de base que les autres englobent. Si vos layouts n’en partagent aucun, ajoutez-le à chacun. Velo ignore une seconde copie sur la même page, mais vérifiez que la bannière s’affiche dans chaque section du site.

Est-ce que ça va ralentir le site ?

L'extrait du tableau de bord se charge de manière asynchrone. Comme pour tout script, mesurez son effet sur votre site et vérifiez l'ordre de vos balises : le chargement asynchrone ne garantit pas à lui seul que les valeurs de consentement par défaut s'appliquent avant les autres balises.

Un assistant IA peut-il le faire à ma place ?

Oui. Copiez le prompt de la section Installer avec un agent, juste en dessous, dans Claude, ChatGPT, Cursor ou l'assistant que vous utilisez déjà. Il contient les étapes de cette page, l'ordre dans lequel les balises doivent se charger et les vérifications que l'agent doit faire avant de vous annoncer que c'est terminé.

Gratuit pour un site

Bannière, analyse et registres de consentement pour un site, gratuitement. Pro à partir de €7 par mois HT, pour des sites illimités.