Installationsanleitung für Shopware

Velo in
Shopware einbinden.

Installieren Sie das Velo-Cookie-Banner und Google Consent Mode v2 auf Shopware mit einer Zeile in Ihrem Storefront-Template. Die meisten Installationen dauern ein paar Minuten, wenn Sie bereits Admin-Zugriff auf den Shop haben. Wenn Sie Google Tag Manager nutzen, finden Sie diesen Weg ebenfalls auf dieser Seite.

Anleitung und Bildquellen geprüft am 23. September 2026.

Loslegen

Wostorefront/base.html.twig → base_head

TarifEigenes Theme oder Plugin

LiveNach dem Neukompilieren

Typische DauerEtwa sechs Minuten

Eine Zeile
in base.html.twig einfügen.

Fügen Sie das Snippet Ihrer Website in den websiteweiten head-Bereich ein, veröffentlichen Sie und testen Sie das Ergebnis. Wenn Ihre Mess-Tags bereits über Google Tag Manager laufen, nehmen Sie den Weg unten.

Sie nutzen bereits Google Tag Manager? Dann diesen Weg nehmen ↓

Drei Schritte · etwa sechs Minuten

01

Zeile kopieren

Kopieren Sie das vollständige Installations-Snippet für diese Website aus Ihrem Velo-Dashboard. Das Beispiel unten zeigt das Format; ersetzen Sie your-site-id, bevor Sie es verwenden. Behalten Sie den API-Endpunkt bei, den Ihr Dashboard vorgibt.

<script src="https://cdn.veloconsent.com/v1/velo.js" data-api="https://app.veloconsent.com" data-velo-site="your-site-id" async></script>
02
Head-Template des Storefronts erweitern

Erweitern Sie in Ihrem eigenen Theme oder Plugin storefront/base.html.twig und überschreiben Sie base_head. Fügen Sie das vollständige Velo-Snippet vor dem Aufruf parent() ein und erhalten Sie die Ausgabe des Parent-Templates. Deployen Sie, kompilieren Sie das Theme und leeren Sie den Cache. Bearbeiten Sie nicht die Core-Templates von Shopware.
Shopware · Storefront-Template
```
{% sw_extends '@Storefront/storefront/base.html.twig' %}
{% block base_head %}
  {# Paste the complete Velo snippet from your dashboard here. #}
  {{ parent() }}
{% endblock %}
```
Geprüfte Konfigurationsreferenz · 23. September 2026
Konfigurationsreferenz, abgeglichen mit der Dokumentation der Plattform. Kein Screenshot aus dem Admin-Bereich.
Dokumentation der Plattform ↗
03

Veröffentlichen und die Live-Website prüfen

Speichern und veröffentlichen Sie die Änderung mit den Schritten Ihrer Plattform oben und leeren Sie danach den Website- oder CDN-Cache. Öffnen Sie die veröffentlichte URL in einer neuen Browsersitzung. Prüfen Sie das Banner dort, wo Ihre Regionsregeln es verlangen, testen Sie Zustimmen und Ablehnen und kontrollieren Sie, dass die Consent-Standardwerte und -Updates greifen, bevor Ihre Mess-Tags laufen. Prüfen Sie zum Schluss, ob die Website in Ihrem Velo-Dashboard als installiert angezeigt wird.

Live-Aufnahme der Oberfläche · 23. September 2026
Das echte Banner auf veloconsent.com, aufgenommen am 23. September 2026. Texte, Layout und Regionseinstellungen Ihres Banners können abweichen.
Velo-Live-Website ↗In voller Größe ansehen ↗

Darauf sollten Sie achten

Wenn das Banner nach der Änderung nicht erscheint, liegt es fast immer am Theme-Cache: Theme neu kompilieren, Cache leeren, Hard Reload. Prüfen Sie dann, ob das Snippet im Block base_head steht, den Ihr Theme tatsächlich erweitert, und ob der Aufruf parent() noch vorhanden ist.

Sie vergleichen noch? Lesen Sie, warum Teams Velo auf Shopware nutzen, oder sehen Sie alle unterstützten Plattformen.

Empfohlen, wenn Sie einen Container nutzen

Oder fügen Sie das Tag
im Tag Manager hinzu.

Läuft auf dieser Website bereits ein Web-Container von Google Tag Manager? Dann fügen Sie Velo aus der Community Template Gallery hinzu und konfigurieren es dort. Wenn Sie den Container erst installieren müssen, nutzen Sie die unterstützte Integration Ihrer Plattform und prüfen Sie ihn auf der veröffentlichten URL.

01Velo-CMP-Vorlage hinzufügenTemplates→Tag Templates→New→Search Gallery
02Tag anlegenTags→New→Velo-CMP-Vorlage
03Erweiterte Optionen prüfenAdvanced→url_passthrough→ads_data_redaction
04Bei „Consent Initialization – All Pages“ auslösenTriggering→Consent Initialization – All Pages
05Consent-Übersicht aktivierenAdmin→Container Settings→Enable consent overview
06Vorschau prüfen, dann veröffentlichenPreview→Submit→Publish

Velo CMP · Tag-Konfiguration

Velo-Site-ID: Kopieren Sie die genaue Site-ID aus Ihrem Velo-Dashboard.
Banner-Design: Hell oder dunkel
Velo-API-Endpunkt (optional): Verwenden Sie den API-Endpunkt aus Ihren Velo-Installationseinstellungen.

Geprüfte Vorlagenfelder · 23. September 2026

Feldnamen abgeglichen mit der veröffentlichten Velo-CMP-Vorlage. Verwenden Sie Ihre eigene Site-ID und Ihren eigenen API-Endpunkt.

Velo-CMP-Vorlage ↗

Die komplette Anleitung für Tag Manager Sechs Schritte, etwa zehn Minuten, auf jeder Plattform gleich.

Fragen zu Shopware,
beantwortet.

Was Teams bei der Installation auf Shopware zuerst fragen.

Welche Shopware-Version wird abgedeckt?

Die Schritte beziehen sich auf Shopware 6. Shopware 5 funktioniert über sein Index-Template genauso, hat aber das Ende seines Lebenszyklus erreicht. Dort ist der Weg über Tag Manager daher sauberer, während Sie das Upgrade planen.

Shopware bringt eine eigene Cookie-Leiste mit.

Deaktivieren Sie sie für den Verkaufskanal, damit Velo die einzige aktive Consent-Ebene ist. Zwei Banner verwirren Besucher, und nur Velo überträgt die Entscheidung in Consent Mode und das Audit-Log.

Warum erscheint das Banner nach der Änderung nicht?

Fast immer am Theme-Cache: Kompilieren Sie das Theme neu, leeren Sie den Cache und laden Sie die Seite hart neu. Erscheint es dann immer noch nicht, prüfen Sie, ob das Snippet im Block base_head steht, den Ihr Theme tatsächlich erweitert.

Wird die Website dadurch langsamer?

Das Snippet aus dem Dashboard lädt asynchron. Wie bei jedem Skript sollten Sie die Auswirkung auf Ihre Website messen und die Reihenfolge Ihrer Tags prüfen. Asynchrones Laden allein garantiert nicht, dass die Consent-Standardwerte vor anderen Tags greifen.

Kann ein KI-Assistent das für mich erledigen?

Ja. Kopieren Sie den Prompt aus „Mit Agenten installieren“ direkt darunter in Claude, ChatGPT, Cursor oder den Assistenten, den Sie ohnehin nutzen. Er enthält die Schritte dieser Seite, die Reihenfolge, in der die Tags laden müssen, und die Prüfungen, die der Agent durchführen muss, bevor er Ihnen meldet, dass alles erledigt ist.

Oder übergeben Sie es
an einen Agenten.

Kopieren Sie den Prompt in Claude, ChatGPT, Cursor oder den Assistenten, den Sie ohnehin nutzen. Er enthält alles von dieser Seite: beide Wege, die Reihenfolge, in der die Tags laden müssen, und die Prüfungen, die zeigen, dass alles funktioniert.

Der Prompt

Fügen Sie diesen Prompt in Ihren Assistenten ein und geben Sie dann Ihre Site-ID sowie das vollständige Installations-Snippet oder die GTM-Einstellungen aus Ihrem Velo-Dashboard an.

Installations-Prompt · Shopware

Installieren Sie Velo auf Shopware.

Aktuelle Anleitung: https://veloconsent.com/shopware

Holen Sie vor jeder Änderung meine Site-ID und das vollständige Installations-Snippet oder die GTM-Einstellungen aus dem Velo-Dashboard. Prüfen Sie, welches Consent-Tool und welche Mess-Tags bereits auf der Website laufen.

Wählen Sie einen Installationsweg:
A. Wenn die Website bereits Google Tag Manager nutzt, fügen Sie die Vorlage Velo CMP (veröffentlicht von ampliodata) aus der Community Template Gallery hinzu. Tragen Sie meine Site-ID, das Theme und den API-Endpunkt aus dem Dashboard ein. Prüfen Sie die erweiterten Optionen; beide sind standardmäßig deaktiviert. Verwenden Sie Consent Initialization – All Pages, nutzen Sie dann Preview und prüfen Sie die Einwilligung vor dem Veröffentlichen. Alle Schritte: https://veloconsent.com/google-tag-manager

B. Für die direkte Installation: Erweitern Sie in Ihrem eigenen Theme oder Plugin storefront/base.html.twig und überschreiben Sie base_head. Fügen Sie das vollständige Velo-Snippet vor dem Aufruf parent() ein und erhalten Sie die Ausgabe des Parent-Templates. Deployen Sie, kompilieren Sie das Theme und leeren Sie den Cache. Bearbeiten Sie nicht die Core-Templates von Shopware.

Lassen Sie nicht zugehörigen Code unverändert. Vermeiden Sie doppelte Velo-Installationen oder konkurrierende Consent-Standardwerte. Gehen Sie nicht davon aus, dass die Platzierung im Head oder asynchrones Laden allein die Reihenfolge der Tags garantiert.

Prüfen Sie die veröffentlichte Website in einer neuen Sitzung. Prüfen Sie das Banner unter den konfigurierten Regionsregeln, die anfänglichen Consent-Standardwerte, die Updates nach Zustimmen und Ablehnen sowie das Ereignis velo_consent_update. Prüfen Sie, ob Nicht-Google-Tags ihren zugewiesenen Kategorien folgen. Testen Sie eine zweite Seite und jeden separaten Checkout-Bereich. Bestätigen Sie, dass die Signale im Velo-Dashboard ankommen.

Berichten Sie, was geändert wurde, wo es geändert wurde und welches Ergebnis jede Prüfung hatte. Beschreiben Sie fehlende Zugänge oder Prüfungen, die Sie nicht abschließen konnten.

Ihr Agent liest Webseiten? Verweisen Sie ihn auf veloconsent.com/llms.txt und /install.md, dort steht derselbe Kontext als reiner Text.

Aus dem Blog.

Google Consent Mode v2 auf Shopify einrichten Setzen Sie die Standardwerte „denied“ oberhalb Ihres Containers und schreiben Sie die Entscheidung der Besucher mit demselben Klick in Google Consent Mode und in die Customer Privacy API von Shopify. 2. September 2026

Google Consent Mode auf Squarespace: Einrichtung und Grenzen Das native Banner von Squarespace blockiert Analytics-Cookies, sendet aber keine Consent-Mode-Signale. 16. August 2026

Was ist Consent-Modellierung, und wann setzt sie ein? Consent-Modellierung schätzt, was Besucher getan haben, die abgelehnt haben. 11. August 2026

Alle Beiträge