Analyse gratuite Guides d'installation Développeurs Comparer les CMP À propos Assistance Contact
Adopter Velo

Vous avez déjà un compte ? Se connecter

Guide d'installation Shopware

Ajoutez Velo à Shopware.

Installez la bannière de cookies Velo et Google Consent Mode v2 sur Shopware en quelques minutes. Une ligne dans le template de votre storefront suffit. Si vous utilisez déjà Google Tag Manager, cette méthode figure aussi sur cette page.

storefront/base.html.twig → base_head
PrérequisShopware 6
ActifAprès une recompilation
DuréeEnviron six minutes

Collez une ligne
dans base.html.twig.

Une ligne dans Shopware, et la bannière est sur toutes les pages, avec la valeur Consent Mode par défaut posée avant qu'aucune autre balise ne puisse se déclencher. Même bannière, même câblage et même journal d'audit que par la méthode Tag Manager.

Vous utilisez déjà Google Tag Manager ? Passez plutôt par là ↓

Trois étapes · environ six minutes

  1. 01

    Copier la ligne

    Une balise script, la même sur toutes les pages du site. Tout ce qui suit consiste à la placer au bon endroit, et cet endroit est toujours le head, avant les balises qu'elle gouverne.

    <!-- Avant vos autres balises. C'est tout l'intérêt de cet ordre. --> <script src="https://veloconsent.com/v1/velo.js" data-velo-site="your-site-id" defer></script>
  2. 02

    Ajoutez la balise à votre storefront

    Sur Shopware 6, étendez le bloc base_head de storefront/base.html.twig depuis votre thème et ajoutez-y l'extrait, ou utilisez une extension d'injection d'en-tête du Shopware store si vous préférez ne pas toucher aux templates.

    votre-boutique.com/admin · Theme
    L'administration Shopware avec l'extrait Velo collé dans le head du site
  3. 03

    Recompilez et videz le cache

    Recompilez le thème et videz le cache pour que le storefront prenne la modification en compte. La bannière s'affiche au chargement de page suivant, avec la valeur Consent Mode par défaut posée avant qu'aucune autre balise ne puisse se déclencher.

    votre-site.com
    Une page web ordinaire avec la bannière de consentement Velo dans le coin inférieur gauche
Un point de vigilance

Si la bannière ne s'affiche pas après la modification, c'est presque toujours le cache du thème : recompilez le thème, videz le cache, rechargez en forçant. Vérifiez ensuite que l'extrait se trouve bien dans le bloc base_head que votre thème étend réellement, avec l'appel parent() toujours en place.

Recommandé si vous avez déjà un conteneur

Ou importez la balise
dans Tag Manager.

Une seule balise, aucun code sur la page, et toute votre mesure reste au même endroit. Pas encore de Tag Manager ? Une extension GTM du Shopware store, ou ce même bloc de template de base, installe le conteneur. Ensuite, commencez ici.

  1. 01Importez le modèle CMP de VeloTemplatesTag TemplatesNewImport
  2. 02Créez la baliseTagsNewVelo CMP template
  3. 03Cochez les deux options de récupérationAdvancedurl_passthroughads_data_redaction
  4. 04Déclenchez-la sur Consent Initialization – All PagesTriggeringConsent Initialization – All Pages
  5. 05Activez la vue d'ensemble du consentement dans AdminAdminContainer SettingsEnable consent overview
  6. 06Prévisualisez, puis publiezPreviewSubmitPublish
tagmanager.google.com
Une nouvelle balise dans Google Tag Manager utilisant le modèle Velo Consent Banner, avec l'identifiant du site renseigné
Le guide Tag Manager, écran par écran Six écrans, une dizaine de minutes, identique sur toutes les plateformes.

Puis vérifiez
sur du trafic réel.

Quelle que soit la méthode choisie, la console Velo guette le premier signal réel de votre site Shopware — le chargement de la bannière ou l'enregistrement d'une décision — et passe en statut installé dès qu'il arrive.

La bannière de consentement Velo sur un site en production, proposant Refuser, Préférences et Tout accepter
La bannière s'afficheSur un chargement de page neuf, la bannière apparaît avant que quoi que ce soit d'autre ne demande des données.
Tout démarre en refuséDepuis l'EEE, le Royaume-Uni ou la Suisse, tous les signaux de consentement démarrent refusés jusqu'à ce que le visiteur choisisse.
Chaque choix bascule les signauxAccepter ou refuser bascule la mise à jour de consentement correspondante, et la décision atterrit dans le journal d'audit.

Lancez l'analyse gratuite une fois en production : elle lit le résultat comme le ferait un premier visiteur.

Vos questions Shopware,
nos réponses.

Ce que demandent d'abord les équipes qui installent sur Shopware.

Quelle version de Shopware est couverte ?

Les étapes visent Shopware 6. Shopware 5 fonctionne de la même façon via son template index, mais il est en fin de vie : la méthode Tag Manager y est donc plus propre pendant que vous préparez la mise à niveau.

Shopware embarque sa propre barre de cookies.

Désactivez-la pour ce canal de vente afin que Velo soit la seule couche de consentement active. Deux bannières perdent les visiteurs, et seul Velo relie la décision à Consent Mode et au journal d'audit.

Pourquoi la bannière ne s'affiche-t-elle pas après la modification ?

Presque toujours le cache du thème : recompilez le thème et videz le cache, puis rechargez en forçant. Si elle ne s'affiche toujours pas, vérifiez que l'extrait se trouve bien dans le bloc base_head que votre thème étend réellement.

Est-ce que ça va ralentir le site ?

Non. Le script se charge en différé, ne bloque jamais le rendu, et la région du visiteur est résolue sur le nœud le plus proche avant que la page finisse de s'afficher. La bannière elle-même, c'est quelques kilo-octets de code statique.

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é.

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é.

Le prompt

Collez-le en premier message, puis remplacez your-site-id par l'identifiant qui figure sur votre tableau de bord Velo. Tout le reste dont l'agent a besoin y est déjà écrit, y compris ce qu'il faut vérifier avant de publier.

Prompt d'installation · Shopware
# Installer Velo sur Shopware : bannière de cookies + Google Consent Mode v2 Vous installez Velo, une plateforme de gestion du consentement, sur mon site Shopware. Velo affiche la bannière de cookies, définit les valeurs par défaut de Google Consent Mode v2 avant qu'aucune autre balise ne puisse se déclencher, et enregistre chaque décision. Demandez-moi ceci avant de toucher à quoi que ce soit : - Mon identifiant de site Velo. Il figure dans le tableau de bord Velo. Pas encore de compte ? Envoyez-moi sur https://veloconsent.com/get-started et attendez l'identifiant. - Si le site utilise déjà Google Tag Manager, et quel conteneur. - Quelle bannière de cookies ou quel outil de consentement est en place sur le site aujourd'hui. ## Méthode A : via Google Tag Manager (à privilégier si GTM tourne) 1. Templates → Tag Templates → New, puis ⋮ → Import. Importez le template.tpl depuis github.com/ampliodata/velo-cmp ("Velo CMP"). 2. Créez une balise à partir de ce modèle. Renseignez mon identifiant de site Velo et choisissez le thème clair ou sombre. 3. Déclenchez-la sur le trigger "Consent Initialization – All Pages". Pas Initialization, pas All Pages. Les deux s'exécutent trop tard pour définir les valeurs de consentement par défaut. 4. Preview, vérifiez l'onglet Consent dans Tag Assistant, puis Submit et Publish. Pas encore de conteneur ? Sur Shopware, Shopware 6 n'a pas de champ GTM dans l'admin de base : la plupart des boutiques ajoutent donc un plugin GTM depuis le Shopware Store et collent l'identifiant du conteneur dans les réglages de canal de vente du plugin. ## Méthode B : l'extrait de code, directement dans le site Placez cette ligne dans le <head>, au-dessus de toutes les balises d'analytics et de publicité : <script src="https://veloconsent.com/v1/velo.js" data-velo-site="MY_SITE_ID" defer></script> Sur Shopware : étendez le bloc base_head de storefront/base.html.twig depuis le thème et ajoutez-y l'extrait, ou utilisez une extension d'injection d'en-tête du Shopware store pour éviter de toucher aux templates. ## Règles - Une seule méthode, jamais les deux. Deux installations, deux bannières. - Velo se charge en premier. Tout ce qui mesure ou fait de la publicité vient ensuite. - Un seul outil peut définir les valeurs par défaut de Consent Mode. Désactivez la barre de cookies native de Shopware pour ce canal de vente afin que Velo soit l'unique couche de consentement active. Ne laissez pas non plus de gtag('consent', 'default', ...) codé en dur ailleurs. - Ne changez rien au-delà de ce que cette installation exige. Prévenez-moi d'abord si un fichier de thème, un plugin ou une balise existante doit être modifié. ## Vérifiez, puis faites-moi un retour - La bannière s'affiche sur un chargement neuf en fenêtre privée. - Avant mon choix, tous les signaux de consentement sauf security_storage sont refusés depuis l'EEE, le Royaume-Uni ou la Suisse. - Accepter et refuser basculent chacun les signaux correspondants, et un événement velo_consent_update arrive dans le data layer. - Les balises Google restent en mode sans cookies tant que le consentement n'est pas accordé, et toute balise conditionnée à la main ne se déclenche qu'après. - window.Velo est défini, et Velo.open() rouvre le panneau de préférences. - Sur une installation Tag Manager, Tag Assistant montre la balise Velo se déclencher sur Consent Initialization avant toutes les autres. Dites-moi ce que vous avez changé, où, et ce qu'a montré chaque vérification. Si une vérification échoue, corrigez-la et relancez les vérifications. Guide complet : https://veloconsent.com/shopware Plus de contexte pour les agents : https://veloconsent.com/llms.txt

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.

Les exigences RGPD pour une bannière de cookies en 2026, et la vérification qui prouve chacune d'elles Ce qu'une bannière de cookies doit faire en 2026 sous le RGPD, chaque point accompagné de la vérification en navigateur qui prouve que la vôtre le fait vraiment. 29 juillet 2026
Comment vérifier que votre bannière de cookies envoie bien le signal Consent Mode v2 Deux lectures suffisent : les quatre signaux de consentement dans le navigateur, et l'état réellement transmis à Google dans la requête. 26 juillet 2026