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. Unterstützt PrestaShop 8.0.0 bis 9.99.99.

Voraussetzungen und unterstützte Versionen

  • PrestaShop Version 8.0.0 bis 9.99.99.
  • 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

Das ZIP wird von der CookiePilot Anwendung unter der unten stehenden Adresse ausgeliefert und nie über Dritt-Marktplätze vertrieben. Vergleichen Sie nach dem Download die SHA-256-Prüfsumme mit dem veröffentlichten Wert, um zu bestätigen, dass die Datei unterwegs nicht verändert wurde.

Größe: 228.8 KBSHA-256: 9ac5668263574e760e6f860a4a939c3ee67445d15624e02f6b03d14e5fdb95d9
ZIP herunterladen

Führen Sie unter Linux oder macOS den Befehl unten aus. Unter Windows verwenden Sie certutil -hashfile mit der heruntergeladenen Datei. Die Ausgabe muss exakt mit dem veröffentlichten Hash übereinstimmen.

tmp=$(mktemp)
trap 'rm -f "$tmp"' EXIT
curl -fsSL https://app.cookiepilot.io/downloads/cookiepilot-prestashop-addons-1.0.0.zip -o "$tmp"
echo "9ac5668263574e760e6f860a4a939c3ee67445d15624e02f6b03d14e5fdb95d9  $tmp" | sha256sum --check

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 Ihre PrestaShop Version zwischen 8.0.0 und 9.99.99 liegt 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. Das Modul schließt den Login ab, sobald die Adresse verifiziert ist.
  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 das CookiePilot Skript in den head jeder Storefront-Seite ein, genau einmal und vor den Analytics-Tags. Sie fügen keinen Code in das Theme ein, und doppelte Hooks in einem Theme führen nicht zu einer zweiten Kopie.
  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.

dataLayer in der Konsole prüfen

Öffnen Sie die Storefront in einem privaten Fenster, öffnen Sie die Browser-Konsole und fügen Sie das Snippet unten ein. Vor jeder Entscheidung sollte genau ein default-Eintrag mit denied-Werten sichtbar sein. Nach einer Entscheidung muss ein update-Eintrag mit den gewährten Kategorien folgen.

(window.dataLayer || []).forEach(function (entry) {
  if (entry && entry[0] === 'consent') {
    console.log(entry[1], entry[2]);
  }
});

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: Die gewährten Kategorien starten, und der dataLayer enthält ein consent update mit granted-Werten.
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 lädt außerhalb der Consent-Ebene. Verschieben Sie diese Tags hinter das Autoblocking des Moduls oder in ein per Einwilligung gesteuertes Tag-Setup.

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.

Das Modul in einem echten Shop

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.