Koszyk
Automatyczne śledzenie zdarzeń e-commerce
Moduł obsługuje kompletny zestaw zdarzeń wymaganych przez Google Dynamic Remarketing w modelu retail. Każde zdarzenie przesyła identyfikator produktu (items[].id) zgodny z feedem Google Merchant Center oraz parametr google_business_vertical: 'retail', co pozwala Google precyzyjnie dopasować reklamy do produktów z Twojego katalogu.
| Zdarzenie Google | Kiedy się odpala | Dane w zdarzeniu |
|---|---|---|
| view_item | Strona produktu + zmiana wariantu (AJAX) | ID produktu, cena, business vertical |
| view_item_list | Kategoria, nowości, bestsellery, promocje, producent, dostawca | Lista ID produktów, suma wartości |
| view_search_results | Wyniki wyszukiwania | Lista ID produktów, suma wartości |
| add_to_cart | Dodanie produktu do koszyka (AJAX, bez przeładowania) | ID produktu z wybranym wariantem, cena |
| purchase | Potwierdzenie zamówienia | Lista ID produktów, wartość zamówienia, waluta |
Konfigurowalny identyfikator produktu
Kluczowym wymogiem Google jest zgodność identyfikatora produktu w tagu remarketingowym z identyfikatorem w feedzie Google Merchant Center. Moduł pozwala wybrać format identyfikatora spośród 5 opcji:
- ID produktu — domyślne
id_productz bazy PrestaShop - ID produktu - ID atrybutu — format
id_product-id_product_attribute(myślnik) - ID produktu _ ID atrybutu — format
id_product_id_product_attribute(podkreślenie) - Reference — indeks / numer katalogowy produktu
- EAN-13 — europejski kod kreskowy
Dla produktów z kombinacjami (wariantami), moduł automatycznie pobiera identyfikatory specyficzne dla wybranej kombinacji — jeśli wariant ma własny EAN lub referencję, to właśnie ten identyfikator zostanie przesłany do Google, a nie identyfikator produktu głównego.
Obsługiwane strony listingowe
Moduł śledzi zdarzenie view_item_list na wszystkich stronach z listami produktów w PrestaShop:
- Strony kategorii
- Strony producenta
- Strony dostawcy
- Nowości
- Bestsellery
- Promocje (obniżki cen)
Na każdej z tych stron moduł najpierw próbuje pobrać listę produktów z danych już załadowanych przez PrestaShop (zmienne Smarty), co eliminuje dodatkowe zapytania SQL. Jeśli dane nie są dostępne (np. niestandardowy motyw), moduł automatycznie przełącza się na bezpośrednie zapytanie do bazy danych jako fallback.
Inteligentne śledzenie wariantów i koszyka
Na stronie produktu, gdy klient zmienia wariant (kolor, rozmiar), moduł wysyła asynchroniczne zapytanie AJAX do serwera, pobiera identyfikator i cenę konkretnej kombinacji, a następnie natychmiast wysyła zaktualizowane zdarzenie view_item do Google — bez przeładowania strony. Analogicznie, dodanie produktu do koszyka generuje zdarzenie add_to_cart z poprawnym identyfikatorem wariantu.
Globalny tag Google (gtag.js)
Moduł może automatycznie załadować skrypt gtag.js z identyfikatorem konwersji Google Ads, ustawiając jednocześnie walutę i kraj sklepu. Jeśli masz już zainstalowany Google Tag Manager lub inny moduł ładujący gtag.js, możesz wyłączyć tę opcję, aby uniknąć duplikacji tagu — zdarzenia remarketingowe będą nadal wysyłane poprawnie.
Pełna kompatybilność
- PrestaShop 1.7.x – 9.x — jeden moduł na wszystkie wersje
- PHP 7.0 – 8.5 — bez Composera, bez zależności zewnętrznych
- Multistore — każdy sklep może mieć własny identyfikator konwersji Google Ads
- Wszystkie motywy — Classic, Starter Theme, Hummingbird i motywy niestandardowe
- Wielojęzyczność — panel konfiguracji w języku polskim i angielskim
Dlaczego warto
- Jeden klik — pełna integracja — podaj Google Conversion ID, zapisz i gotowe; wszystkie zdarzenia działają automatycznie na każdej stronie sklepu
- Zgodność z Google Merchant Center — identyfikator produktu w tagu odpowiada identyfikatorowi w feedzie, co umożliwia dynamiczne reklamy produktowe z prawidłowymi zdjęciami i cenami
- Śledzenie wariantów w czasie rzeczywistym — zmiana koloru, rozmiaru lub innego atrybutu natychmiast aktualizuje dane w tagu remarketingowym, bez przeładowania strony
- Wydajność — na stronach listingowych moduł korzysta z danych już załadowanych przez PrestaShop; zero dodatkowych zapytań SQL w standardowym flow
- Bezpieczeństwo — walidacja tokenów AJAX, weryfikacja origin/referer, escapowanie wszystkich zmiennych w szablonach, ochrona przed CSRF i XSS
- Weryfikacja właściciela zamówienia — zdarzenie purchase odpala się tylko dla klienta, który złożył zamówienie; nie ma ryzyka wycieku danych zamówienia
- Brak konfliktów — opcja wyłączenia globalnego tagu pozwala współistnieć z Google Tag Manager bez duplikacji skryptów
- Pełne pokrycie stron — kategorie, producenci, dostawcy, nowości, bestsellery, promocje, wyszukiwanie, produkty, koszyk i zamówienie
Wymagania
- PrestaShop 1.7.0 lub nowszy (w tym 8.x i 9.x)
- PHP 7.0 lub nowszy
- Konto Google Ads z aktywnym remarketingiem dynamicznym
- Feed produktowy w Google Merchant Center (dla dynamicznych reklam produktowych)
Instalacja i konfiguracja
- Zainstaluj moduł przez panel administracyjny PrestaShop (Moduły → Załaduj moduł)
- Przejdź do konfiguracji modułu
- Wklej Google Ads Conversion ID (format:
AW-123456789) - Wybierz, czy moduł ma ładować globalny tag
gtag.js(wyłącz jeśli masz GTM) - Wybierz format identyfikatora produktu odpowiadający Twojemu feedowi w Google Merchant Center
- Zapisz — remarketing dynamiczny działa natychmiast na wszystkich stronach sklepu