Guide d'installation Shopware

Ajoutez Velo
à Shopware.

Installez la bannière de cookies Velo et Google Consent Mode v2 sur Shopware avec une seule ligne dans le template de votre storefront. La plupart des installations prennent quelques minutes si vous disposez déjà d'un accès administrateur au site. Si vous utilisez Google Tag Manager, cette méthode figure aussi sur cette page.

Instructions et sources des images revues le 23 septembre 2026.

Commencer

Oùstorefront/base.html.twig → base_head

PrérequisThème personnalisé ou plugin

ActifAprès une recompilation

Durée typeEnviron six minutes

Collez une ligne
dans base.html.twig.

Ajoutez l'extrait de votre site dans le head commun à tout le site, puis publiez et testez le résultat. Si vos balises de mesure passent déjà par Google Tag Manager, utilisez la méthode ci-dessous.

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

Trois étapes · environ six minutes

01

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.

<script src="https://cdn.veloconsent.com/v1/velo.js" data-api="https://app.veloconsent.com" data-velo-site="your-site-id" async></script>
02
Étendre le template d'en-tête du storefront

Dans votre thème personnalisé ou votre plugin, étendez storefront/base.html.twig et surchargez base_head. Collez l'extrait Velo complet avant l'appel parent(), en conservant la sortie du parent. Déployez, compilez le thème et videz le cache. Ne modifiez pas les templates du cœur de Shopware.
Shopware · template du storefront
```
{% sw_extends '@Storefront/storefront/base.html.twig' %}
{% block base_head %}
  {# Paste the complete Velo snippet from your dashboard here. #}
  {{ parent() }}
{% endblock %}
```
Référence de configuration vérifiée · 23 septembre 2026
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.
Documentation de la plateforme ↗
03

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.

Capture de l'interface réelle · 23 septembre 2026
La vraie bannière de veloconsent.com, capturée le 23 septembre 2026. Le texte, la mise en page et les réglages régionaux de votre bannière peuvent différer.
Site Velo en production ↗Voir en taille réelle ↗

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.

Vous comparez encore les options ? Découvrez pourquoi des équipes utilisent Velo sur Shopware, ou consultez toutes les plateformes prises en charge.

Recommandé si vous avez déjà un conteneur

Ou ajoutez la balise
dans Tag Manager.

Vous avez déjà un conteneur web Google Tag Manager sur ce site ? Ajoutez Velo depuis la Community Template Gallery et configurez-le à cet endroit. Si vous devez d'abord installer le conteneur, utilisez l'intégration prise en charge par votre plateforme et vérifiez-le sur l'URL publiée.

01Ajoutez le modèle CMP de VeloTemplates→Tag Templates→New→Search Gallery
02Créez la baliseTags→New→Velo CMP template
03Passez en revue les options avancéesAdvanced→url_passthrough→ads_data_redaction
04Déclenchez-la sur Consent Initialization – All PagesTriggering→Consent Initialization – All Pages
05Activez la vue d'ensemble du consentementAdmin→Container Settings→Enable consent overview
06Prévisualisez, puis publiezPreview→Submit→Publish

Velo CMP · configuration de la balise

Velo site ID: Copiez l'identifiant exact du site depuis votre tableau de bord Velo.
Banner theme: Light ou Dark
Velo API endpoint (optional): Utilisez le point de terminaison d'API indiqué dans vos paramètres d'installation Velo.

Champs du modèle vérifiés · 23 septembre 2026

Noms des champs vérifiés dans le modèle Velo CMP publié. Utilisez votre propre identifiant de site et votre propre point de terminaison d'API.

Modèle Velo CMP ↗

Le guide complet de Tag Manager Six étapes, une dizaine de minutes, identiques sur toutes les plateformes.

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 ?

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

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 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 · Shopware

Installez Velo sur Shopware.

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

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 ampliodata) 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 ; elles sont toutes deux 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 votre thème personnalisé ou votre plugin, étendez storefront/base.html.twig et surchargez base_head. Collez l'extrait Velo complet avant l'appel parent(), en conservant la sortie du parent. Déployez, compilez le thème et videz le cache. Ne modifiez pas les templates du cœur de Shopware.

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.

Comment configurer Google Consent Mode v2 sur Shopify Placez vos valeurs par défaut sur denied au dessus du conteneur, puis écrivez le choix du visiteur à la fois dans Google Consent Mode et dans la Customer Privacy API de Shopify, au même clic. 2 septembre 2026

Google Consent Mode sur Squarespace : configuration et limites La bannière native de Squarespace bloque les cookies de mesure d’audience, mais n’envoie aucun signal Consent Mode. 16 août 2026

Qu'est-ce que la modélisation du consentement, et quand démarre-t-elle ? La modélisation du consentement estime ce qu'ont fait les visiteurs qui ont refusé. 11 août 2026

Tous les articles