Installationsanleitung für PrestaShop
Velo in PrestaShop einbinden
Installieren Sie das Velo-Cookie-Banner und Google Consent Mode v2 auf PrestaShop mit einer Zeile im Head-Template Ihres Themes. Mit Admin-Zugriff auf den Shop dauern die meisten Installationen nur ein paar Minuten. Wenn Sie Google Tag Manager nutzen, beschreibt diese Seite auch diesen Weg.
Anleitung und Bildquellen geprüft am 3. November 2026.
Was Sie für PrestaShop brauchen
Bevor Sie beginnen
- Wo. Child-Theme → head.tpl
- Voraussetzung. PrestaShop 1.7, 8 oder 9
- Live. Nach dem Leeren des Cache
- Typische Dauer. Etwa fünf Minuten
Sobald es live ist
- Ihr Banner folgt den Standardwerten, die Sie für die Region jedes Besuchers festlegen.
- Tags warten, bis der Besucher entschieden hat.
- Jede Entscheidung wird protokolliert, und Consent Mode v2 gibt sie an Ihre Google-Tags weiter.
Zwei Wege, Velo auf PrestaShop zu installieren
Wählen Sie den Weg, der dazu passt, wie Ihre Website ihre Tags bereits lädt. Beide führen zum selben Banner und zu denselben Signalen.
Eine Zeile in head.tpl einfügen
Fügen Sie das Snippet Ihrer Website in den websiteweiten head-Bereich ein, veröffentlichen Sie und testen Sie es auf der Live-Website. Wenn Ihre Mess-Tags bereits über Google Tag Manager laufen, nehmen Sie stattdessen den Weg weiter unten.
Sie nutzen Tag Manager? Dann ohne Code
Wenn Google Tag Manager bereits auf Ihrer Website läuft, ist das der einfachste Weg, Velo einzubinden. Sie müssen keinen Code anfassen, es sind vier kurze Schritte, und alle Ihre Tags bleiben an einem Ort.
Wenn das Banner nach der Änderung nicht erscheint, ist fast immer der Cache die Ursache. Leeren Sie ihn unter Erweiterte Einstellungen → Leistung und laden Sie die Seite hart neu. Prüfen Sie dann, ob das Child-Theme das aktive Theme ist und ob das Snippet oberhalb des Blocks hook_header steht, in dem Module ihre eigenen Tags einfügen.
Alles, was ein Consent-Setup braucht
Dasselbe Banner, dieselben Nachweise und Analysen in jedem Tarif. Pro bietet zusätzlich unbegrenzt viele Websites, unbegrenzte Analysen und Ihr eigenes Logo.
Ihr Banner fragt in der Sprache des Besuchers und folgt den Standardwerten, die Sie für seine Region festlegen.
Jede Entscheidung wird protokolliert, und Consent Mode v2 gibt sie an Ihre Google-Tags weiter.
Eine Zeile in head.tpl einfügen
Fügen Sie das Snippet Ihrer Website in den websiteweiten head-Bereich ein, veröffentlichen Sie und testen Sie es auf der Live-Website. Wenn Ihre Mess-Tags bereits über Google Tag Manager laufen, nehmen Sie stattdessen den Weg weiter unten.
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-staging.veloconsent.com" data-velo-site="your-site-id" async></script>
Head-Template des Themes bearbeiten
Kopieren Sie in einem Child-Theme Ihres aktiven Themes die Datei templates/_partials/head.tpl aus dem Parent-Theme und fügen Sie das vollständige Velo-Snippet direkt nach dem Block head_charset ein, oberhalb des Blocks hook_header, in dem Module ihre Tags einfügen. Speichern Sie und leeren Sie dann den Cache unter Erweiterte Einstellungen → Leistung. Das Parent-Theme direkt zu bearbeiten funktioniert auch, aber ein Theme-Update überschreibt die Änderung.
{* In your child theme: templates/_partials/head.tpl,
copied from the parent theme *}
{block name='head_charset'}
<meta charset="utf-8">
{/block}
{* Paste the complete Velo snippet from your dashboard here. *}
{* …the rest of the parent's head.tpl, unchanged… *}
{block name='hook_header'}
{$HOOK_HEADER nofilter}
{/block}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.
Das Velo-Banner in seinem Standardaussehen. Text, Farben und Regionseinstellungen Ihres Banners können abweichen.Sie nutzen Tag Manager? Dann ohne Code
Wenn Google Tag Manager bereits auf Ihrer Website läuft, ist das der einfachste Weg, Velo einzubinden. Sie müssen keinen Code anfassen, es sind vier kurze Schritte, und alle Ihre Tags bleiben an einem Ort.
Die komplette Anleitung für Tag ManagerVelo zu Tag Manager hinzufügen
Öffnen Sie die Velo-Vorlage, klicken Sie auf Add to workspace und wählen Sie Ihren Container. Velo-Vorlage öffnen ↗
Site-ID einfügen
Öffnen Sie in Tag Manager Tags und klicken Sie auf New. Klicken Sie auf Tag Configuration, wählen Sie Velo CMP und fügen Sie Ihre Site-ID ein. Sie finden sie in Ihrem Velo-Dashboard. Alles andere lassen Sie unverändert.
Als Erstes laden
Klicken Sie auf Triggering, wählen Sie Consent Initialization – All Pages und klicken Sie auf Save. So startet Velo vor Ihren anderen Tags.
Veröffentlichen und prüfen
Klicken Sie auf Submit und dann auf Publish. Preview allein schaltet Velo nicht live. Öffnen Sie danach Ihre Website in einem privaten Fenster, testen Sie das Banner und prüfen Sie, ob die Website in Ihrem Velo-Dashboard als installiert angezeigt wird.
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.
Mit KI installierenDer 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.
Installieren Sie Velo auf PrestaShop. Aktuelle Anleitung: https://veloconsent.com/prestashop 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 veloconsent) 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; ads_data_redaction und url_passthrough 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: Kopieren Sie in einem Child-Theme Ihres aktiven Themes die Datei templates/_partials/head.tpl aus dem Parent-Theme und fügen Sie das vollständige Velo-Snippet direkt nach dem Block head_charset ein, oberhalb des Blocks hook_header, in dem Module ihre Tags einfügen. Speichern Sie und leeren Sie dann den Cache unter Erweiterte Einstellungen → Leistung. Das Parent-Theme direkt zu bearbeiten funktioniert auch, aber ein Theme-Update überschreibt die Änderung. 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.
Aus dem Blog
Notizen zu Cookie-Bannern, Consent Mode und den Daten, die dazwischen verloren gehen.
Google Consent Mode v2 in Velo: Das ist neu
Google Consent Mode v2 auf Shopify einrichten
Häufige Fragen zu Velo auf PrestaShop
Welche PrestaShop-Version wird abgedeckt?
Die Schritte gelten für PrestaShop 1.7, 8 und 9 mit dem Classic-Theme, Hummingbird oder einem darauf aufbauenden Theme, da diese den Head der Seite in templates/_partials/head.tpl führen. Themes für PrestaShop 1.6 führen ihn in einem anderen Template, dort ist der Weg über Tag Manager daher einfacher.
Mein Shop zeigt bereits ein Cookie-Banner aus einem Modul.
Deaktivieren Sie dieses Modul unter Module → Module Manager, 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 liegt es am Cache. Leeren Sie ihn unter Erweiterte Einstellungen → Leistung und laden Sie die Seite hart neu. Erscheint das Banner dann immer noch nicht, prüfen Sie, ob das Child-Theme das aktive Theme ist und ob seine head.tpl unter templates/_partials/head.tpl liegt, im selben Pfad wie im Parent-Theme.
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.
Kostenlos für eine Website
Banner, Analyse und Einwilligungsnachweise für eine Website, kostenlos. Pro ab 7 € im Monat, zzgl. MwSt., für unbegrenzt viele Websites.