PrestaShop

CookiePilot dla PrestaShop: instalacja i Consent Mode v2

Moduł instalujesz z jednego pliku ZIP. Po połączeniu sklepu CookiePilot doda banner i Consent Mode v2 do każdej strony, bez zmian w motywie. Działa z PrestaShop od wersji 8.0.0 do 9.99.99.

Zanim zaczniesz

  • PrestaShop w wersji od 8.0.0 do 9.99.99.
  • Dostęp do zaplecza sklepu i możliwość instalowania modułów.
  • Konto CookiePilot. Możesz je założyć lub zalogować się bezpośrednio w module.
  • Plik ZIP modułu w wersji 1.0.0. Pobierz go poniżej i nie rozpakowuj.

Pobierz moduł

Pobierz plik ZIP bezpośrednio z CookiePilot. Modułu nie publikujemy w zewnętrznych marketplace. Jeśli chcesz sprawdzić plik przed instalacją, porównaj jego sumę SHA-256 z wartością podaną poniżej.

Rozmiar: 228.8 KBSHA-256: 9ac5668263574e760e6f860a4a939c3ee67445d15624e02f6b03d14e5fdb95d9
Pobierz plik ZIP

Na Linuksie lub macOS możesz użyć gotowego polecenia. Na Windows uruchom certutil -hashfile dla pobranego pliku. Jeśli suma się nie zgadza, nie instaluj modułu i pobierz go ponownie.

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

Zainstaluj moduł w PrestaShop

  1. 1.W zapleczu sklepu przejdź do Moduły > Module Manager i kliknij Załaduj moduł.
  2. 2.Wskaż pobrany plik ZIP. PrestaShop zainstaluje go i doda pozycję CookiePilot CMP do listy modułów.
  3. 3.Przy module CookiePilot CMP kliknij Konfiguruj.
  4. 4.Jeśli PrestaShop odrzuci plik, sprawdź wersję sklepu i pobierz ZIP jeszcze raz. Nie rozpakowuj ani nie modyfikuj archiwum.

Połącz sklep z CookiePilot

  1. 1.Na stronie konfiguracji zaloguj się do CookiePilot albo załóż nowe konto.
  2. 2.Jeśli tworzysz konto, kliknij link w wiadomości weryfikacyjnej. Po potwierdzeniu adresu wrócisz do modułu jako zalogowany użytkownik.
  3. 3.Kliknij przycisk połączenia sklepu. Moduł doda domenę do Twojego konta. Jeśli ta domena już istnieje, użyje istniejącego wpisu zamiast tworzyć duplikat.
  4. 4.W sekcji Shop connection zobaczysz domenę, konto, plan i status CONNECTED.

Gdzie pojawi się skrypt CookiePilot

  1. 1.Moduł dodaje skrypt CookiePilot do sekcji head każdej strony sklepu. Robi to dokładnie raz i przed tagami analitycznymi. Nie musisz edytować motywu.
  2. 2.Jeśli wcześniej wkleiłeś CookiePilot ręcznie do motywu albo GTM, usuń ten kod. Zostawienie dwóch bannerów powoduje sprzeczne stany zgody i błędne dane.
  3. 3.Przełącznik Enable CookiePilot banner and Consent Mode w sekcji Storefront status pokazuje, czy moduł dodaje skrypt do sklepu.

Jak działa Consent Mode v2

  1. 1.Przy pierwszym wejściu moduł ustawia opcjonalne sygnały Google Consent Mode v2 na denied. Dzieje się to zanim klient wybierze cokolwiek na bannerze.
  2. 2.Accept All zmienia dozwolone kategorie na granted. Reject All pozostawia je jako denied. Przy wyborze własnych ustawień moduł aktualizuje tylko zaznaczone kategorie.
  3. 3.Skrypty dodane w module czekają na zgodę przypisaną do ich kategorii. Skrypt analityczny nie uruchomi się bez zgody na analitykę, a marketingowy bez zgody marketingowej.

PrestaShop Multistore

  1. 1.Każdy sklep w multistore ma własne połączenie z CookiePilot i własne klucze. Konfiguracja jednego sklepu nie zmienia pozostałych.
  2. 2.Po utworzeniu kolejnego sklepu otwórz moduł w jego kontekście i połącz właściwą domenę. Klucze sklepu głównego nie są kopiowane.

Sprawdź dataLayer w konsoli

Otwórz sklep w prywatnym oknie przeglądarki i wklej poniższy kod do konsoli. Przed wyborem na bannerze powinien pojawić się wpis default z wartościami denied. Po zapisaniu zgody pojawi się kolejny wpis update.

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

Sprawdź pięć wariantów zgody

Każdy wariant testuj w nowym prywatnym oknie z otwartą zakładką Network. Dzięki temu poprzednia zgoda i zapisane cookies nie wpłyną na wynik.

Przed wyborem: nie powinny pojawić się połączenia do narzędzi analitycznych ani reklamowych. Przeglądarka nie powinna też zapisywać ich cookies.
Tylko analityka: narzędzia analityczne mogą się uruchomić. Tagi reklamowe i ich cookies nadal powinny być zablokowane.
Tylko marketing: tagi reklamowe mogą się uruchomić, ale analytics_storage powinno pozostać na denied.
Accept All: dozwolone tagi mogą się uruchomić, a w dataLayer powinien pojawić się consent update z wartościami granted.
Reject All: tagi opcjonalne pozostają wyłączone, również po odświeżeniu. Koszyk i checkout nadal muszą działać.

Meta Pixel i TikTok Pixel nie korzystają bezpośrednio z Google Consent Mode. Trzeba je zablokować w module albo uruchamiać dopiero po zgodzie marketingowej. Sam wpis consent w dataLayer ich nie zatrzyma.

Wyłączenie i ponowna instalacja

Po wyłączeniu modułu skrypt CookiePilot znika ze sklepu. Domena nadal pozostaje na Twoim koncie CookiePilot.

Odinstalowanie usuwa z PrestaShop lokalne klucze i podpięcie modułu. Nie usuwa domeny ani zapisanych dowodów zgód z CookiePilot.

Po ponownej instalacji możesz połączyć tę samą domenę. Moduł użyje istniejącego wpisu, zamiast tworzyć drugi.

Gdy coś nie działa

Banner nie pojawia się po instalacji

Wyczyść pamięć podręczną w Parametry zaawansowane > Wydajność. Jeśli korzystasz z CDN, wyczyść również jego cache. Stara wersja HTML może nie zawierać jeszcze skryptu modułu.

Na stronie są dwa bannery

Sprawdź motyw, panel hostingu i kontener GTM. Usuń wcześniej wklejony kod CookiePilot lub inny banner. Na stronie powinien działać tylko jeden CMP.

Tagi uruchamiają się przed bannerem

Najczęściej tag jest wpisany bezpośrednio w motyw albo dodaje go inny moduł. Przenieś go do CookiePilot lub ustaw jego uruchomienie dopiero po właściwej zgodzie.

Sklep korzysta z Google Tag Managera

CookiePilot powinien być jedynym źródłem stanu zgody. Ustaw warunki zgody dla każdego tagu GTM i nie dodawaj drugiego skryptu CookiePilot do kontenera.

Meta lub TikTok łączą się przed zgodą

Consent Mode nie blokuje tych pikseli samodzielnie. Dodaj je do blokowania w CookiePilot albo uruchamiaj dopiero po zgodzie marketingowej. Sprawdź też, czy kod piksela nie został wpisany bezpośrednio w motyw.

Zobacz moduł w sklepie

Zainstaluj moduł i sprawdź swój sklep

Pobierz ZIP, połącz domenę i wykonaj pięć testów zgody w prywatnym oknie. Nie musisz zmieniać motywu ani wklejać skryptu ręcznie.