PrestaShop

CookiePilot Modul für PrestaShop mit Consent Mode v2

Laden Sie ein einziges ZIP im Module Manager hoch, verbinden Sie die Shop-Domain, und das Modul liefert den Consent-Banner im head jeder Storefront-Seite aus. Das Modul unterstützt PrestaShop 8.x und 9.x.

Voraussetzungen und unterstützte Versionen

  • Das Modul unterstützt PrestaShop 8.x und 9.x.
  • Zugang zum Back Office mit der Berechtigung, Module zu installieren.
  • Ein CookiePilot Konto. Registrierung, E-Mail-Verifizierung und Login sind direkt im Modul möglich.
  • Das Modul-ZIP in Version 1.0.0, heruntergeladen über den Link unten. Entpacken Sie es nicht.

Modul herunterladen

Laden Sie das offizielle CookiePilot-Installations-ZIP herunter, speichern Sie es und laden Sie es ohne Entpacken in PrestaShop hoch.

ZIP herunterladen

ZIP im Module Manager installieren

  1. 1.Öffnen Sie im Back Office Module, dann Module Manager, und klicken Sie auf Modul hochladen.
  2. 2.Ziehen Sie das heruntergeladene ZIP in den Upload-Dialog. PrestaShop installiert das Modul und führt es als CookiePilot CMP auf.
  3. 3.Klicken Sie beim Eintrag CookiePilot CMP auf Konfigurieren, um die Konfigurationsseite des Moduls zu öffnen.
  4. 4.Wird der Upload abgelehnt, prüfen Sie, ob Ihr Shop PrestaShop 8.x oder 9.x nutzt und ob das ZIP die originale, unveränderte Datei ist.

Registrieren, E-Mail verifizieren und Shop verbinden

  1. 1.Erstellen Sie auf der Konfigurationsseite ein CookiePilot Konto oder melden Sie sich mit einem bestehenden an. Für die Registrierung genügen E-Mail-Adresse und Passwort.
  2. 2.Bestätigen Sie die Verifizierungs-E-Mail, kehren Sie zum PrestaShop Back Office zurück, öffnen Sie die CookiePilot CMP Konfiguration erneut und melden Sie sich bei Bedarf mit dem verifizierten Konto an.
  3. 3.Verbinden Sie den Shop: Das Modul legt die Domain in Ihrem CookiePilot Konto automatisch an oder verbindet sich erneut mit einer bestehenden Domain mit demselben Hostnamen.
  4. 4.Das Panel Shop connection zeigt anschließend die verbundene Domain, das Konto und den aktuellen Plan mit dem Status CONNECTED.

Wo das Skript eingebunden wird

  1. 1.Das Modul fügt ein CookiePilot-Skript in den head jeder Storefront-Seite ein und nutzt einen frühen Modul-Hook. Skripte, die früher direkt im Theme eingefügt wurden, können trotzdem zuerst laufen. Binden Sie sie deshalb in das Autoblocking von CookiePilot ein oder konfigurieren Sie sie in GTM so, dass sie auf die Einwilligung warten.
  2. 2.Falls im Theme oder in einem Tag-Container bereits ein manuell eingefügtes CookiePilot Snippet oder ein anderer Consent-Banner liegt, entfernen Sie ihn. Zwei Consent-Ebenen auf einer Seite konkurrieren um den Einwilligungsstatus und verfälschen die Messung.
  3. 3.Das Panel Storefront status hat einen einzigen Schalter, Enable CookiePilot banner and Consent Mode, sodass Sie jederzeit prüfen können, ob das Skript ausgeliefert wird.

Consent Mode v2 Zuordnung

  1. 1.Das Modul setzt die Standardwerte von Google Consent Mode v2 auf denied, bevor der Besucher eine Entscheidung trifft. Analytics- und Marketing-Speicherung bleiben denied, bis eine Einwilligung vorliegt.
  2. 2.Accept All gewährt alle Kategorien. Reject All belässt alle Kategorien auf denied. Die granulare Einwilligung gewährt genau die Kategorien, die der Besucher in der Einstellungsansicht ausgewählt hat.
  3. 3.Optionale statische und dynamische Skripte, die im Modul registriert sind, werden nach denselben Kategorien blockiert und freigegeben. Ein Skript läuft also nur, wenn seine Kategorie gewährt wurde.

Verhalten im Multistore

  1. 1.In einer Multistore-Installation wird die Konfiguration pro Shop gespeichert. Jeder Shop verbindet seine eigene Domain und behält seine eigenen Schlüssel.
  2. 2.Ein neu angelegter Shop erbt die Schlüssel des Hauptshops nicht. Öffnen Sie die Modulkonfiguration im Kontext jedes Shops und verbinden Sie ihn separat.

Tracker-Tests in fünf Zuständen

Führen Sie jeden Zustand in einer frischen privaten Sitzung durch und lassen Sie den Network-Tab geöffnet. Diese fünf Zustände sind der Abnahmetest, gegen den das Modul selbst verifiziert wird.

Vor der Einwilligung: Solange der Banner offen ist, zeigt der Network-Tab keine Analytics- oder Marketing-Requests, und es werden keine Tracking-Cookies geschrieben.
Nur Analytics: Gewähren Sie in der granularen Ansicht ausschließlich Analytics. Analytics-Requests starten, Marketing-Requests und Marketing-Cookies bleiben aus.
Nur Marketing: Gewähren Sie ausschließlich Marketing. Marketing-Tags dürfen feuern, während die Analytics-Speicherung denied bleibt.
Accept All: Nachdem alle Einwilligungen akzeptiert wurden, dürfen Analytics- und Marketing-Tools gemäß der Shop-Konfiguration laufen.
Reject All: Der Shop funktioniert weiter, einschließlich Warenkorb und Checkout, und die Tracker bleiben auch nach einem Neuladen still.

Meta Pixel und TikTok Pixel lesen Consent Mode nicht aus, Consent Mode v2 allein stoppt sie also nicht. Sie müssen vom Autoblocking des Moduls erfasst oder per Event-Gating erst nach der Marketing-Einwilligung ausgelöst werden.

Deaktivieren, Deinstallieren, Neuinstallieren

Das Deaktivieren des Moduls entfernt das CookiePilot Skript aus der Storefront. Die Domain in Ihrem CookiePilot Konto bleibt unangetastet.

Das Deinstallieren entfernt die lokalen Secrets und die Hooks aus der Shop-Datenbank. Es löscht weder die entfernte Domain noch die gespeicherten Einwilligungsnachweise.

Neuinstallation und erneutes Verbinden derselben Domain funktionieren: Das Modul hängt sich wieder an die bestehende Domain, statt ein Duplikat anzulegen.

Fehlerbehebung

Der Banner erscheint nach der Installation nicht

Leeren Sie den PrestaShop Cache unter Erweiterte Einstellungen, Leistung, und leeren Sie Ihr CDN, falls Sie eines verwenden. Zwischengespeichertes HTML liefert weiter Seiten aus, die vor der Aktivierung des Moduls erzeugt wurden.

Zwei Banner oder ein widersprüchlicher Einwilligungsstatus

Entfernen Sie manuell eingefügte Consent-Snippets aus dem Theme, aus Hosting-Tools und aus Tag-Containern. Es darf genau eine Consent-Ebene laufen, und das Modul bindet sie bereits einmal ein.

Tracker feuern vor dem Banner

Ein Theme oder ein anderes Modul mit fest eingebautem GA4, Meta oder TikTok kann außerhalb der Consent-Ebene laden. Konfigurieren Sie die automatische Blockierung von CookiePilot, um diese Tags zu blockieren oder abzudecken, oder konfigurieren Sie sie in GTM so, dass sie erst nach der erforderlichen Einwilligung ausgeführt werden.

Setups mit Google Tag Manager

Lassen Sie das Modul die einzige Einwilligungsquelle sein. Knüpfen Sie jeden GTM-Tag an den passenden Einwilligungsstatus oder feuern Sie ihn nach dem consent update, und fügen Sie nie einen zweiten CookiePilot Loader in den Container ein.

Meta- oder TikTok-Requests erscheinen weiterhin

Diese Pixel ignorieren Consent Mode. Prüfen Sie, ob sie vom Autoblocking oder Event-Gating erfasst sind. Ein fest im Theme eingebauter Pixel feuert weiter, bis er hinter die Marketing-Einwilligung verschoben wird.

Modul installieren und Shop testen

Laden Sie das ZIP herunter, verbinden Sie Ihre Domain und durchlaufen Sie die fünf Tracker-Zustände in einer sauberen Sitzung. Die gesamte Einrichtung findet im Back Office statt.

CookiePilot Konto erstellenAlle Integrationen ansehen