Jak skonfigurować GA4, GTM i Search Console w PrestaShop

Twój sklep PrestaShop może już wysyłać wizyty do Google Analytics 4, ale zamówienia, zgłoszenia kontaktowe lub kwoty nie zgadzają się z tym, co widzisz w zamówieniach. Moduł Google Tracking łączy GA4, Google Tag Manager, Google Ads i Search Console z panelu administracyjnego, bez zmiany szablonu. Oto jak go skonfigurować, jakie zdarzenia e-commerce wysyła, jak sprawdzić śledzenie i co się dzieje, gdy licencja dobiega końca.

Dla kogo jest ten moduł i kiedy potrzeba więcej?

Jest dla sprzedawców, którzy chcą niezawodnego śledzenia GA4, Tag Managera lub Google Ads bez ingerencji w kod szablonu, ze spójnymi danymi produktu od karty produktu do zakupu.

Moduł pasuje do sklepu na standardowym szablonie, do katalogu multisklepowego, który potrzebuje innych identyfikatorów dla każdego sklepu, oraz do zespołu, który testuje ścieżki bez zanieczyszczania raportów. Wysyła 15 zdarzeń, zachowuje ten sam produkt, markę i kategorię z jednego zdarzenia do następnego i pozwala wysłać identyfikator produktu używany w pliku Merchant Center.

Nie zastępuje banera zgody, polityki prywatności ani raportów GA4. Nie wysyła zwrotów ani zakupów zapasowych z serwera, nie prowadzi Tag Managera po stronie serwera i nie dodaje identyfikatora użytkownika GA4. W zakresie zgody przekazuje sygnały Consent Mode v2 zapisane przez Twój banner; nie decyduje o Twojej podstawie prawnej.

Jak skonfigurować GA4, GTM i Search Console w PrestaShop?

Konfiguracja odbywa się w panelu administracyjnym przez wklejenie identyfikatora Google, bez zmiany pliku szablonu.

1. Otwórz Moduły > Menedżer modułów, kliknij Prześlij moduł i wybierz archiwum.
2. Otwórz konfigurację i aktywuj licencję kluczem licencji i sekretem licencji z Twojego konta klienta. Bez ważnej licencji moduł pozostaje wyłączony.
3. Wybierz tryb integracji: Google Analytics 4 bezpośrednio, Google Tag Manager lub tylko Google Ads.
4. Wklej identyfikator wybranego trybu: identyfikator pomiaru G-XXXXXXXXXX (GA4 > Administracja > Strumienie danych) lub kontener GTM-XXXXXXX, albo identyfikator Google Ads AW-XXXXXXXXX.
5. W przypadku Search Console wklej tag HTML weryfikacji lub tylko jego wartość content; moduł wyodrębni kod.
6. Zapisz. Panel stanu pokaże Aktywne i wybrany tryb.

Żaden tag Google ani żadne zdarzenie nie jest dodawane do stron, dopóki identyfikator wybranego trybu jest pusty; tag weryfikacji Search Console jest niezależny. W trybach GA4 bezpośrednio i Tylko Google Ads śledzenie między domenami utrzymuje sesję między Twoimi domenami. W multisklepie każdy sklep może mieć własne identyfikatory. Dokumentacja modułu opisuje każdą kartę, a karta modułu przypomina obsługiwane tryby.

Dlaczego w GA4 brakuje zdarzenia view_item lub zakupu?

Zdarzenia zwykle brakuje, bo jest wyłączone na karcie Zdarzenia, bo zgoda odwiedzającego je wyklucza albo bo inny moduł już wysyła GA4.

Moduł wysyła view_item przy otwarciu karty produktu, z wybranym wariantem. Sprawdź, czy zdarzenie jest włączone, czy strona naprawdę pokazuje kartę produktu i czy szablon zachowuje standardowe pozycje. Karta Diagnostyka zgłasza brakujące hooki w szablonach motywu i aktywne moduły śledzenia Google. Dwa moduły wysyłające GA4 mogą policzyć tę samą wizytę lub zakup dwa razy.

Zakup jest wysyłany po wyświetleniu strony potwierdzenia, tylko raz na zamówienie i wyłącznie w ciągu 24 godzin od zamówienia. Jeśli klient odświeży stronę, moduł nie wyśle zakupu ponownie. Brak zakupu może więc wynikać z odmowy zgody, wyłączonego zdarzenia lub opóźnienia przetwarzania po stronie Google. Moduł nie może zmusić Google do pokazania zdarzenia, którego odwiedzający odmówił.

Jak liczyć zgłoszenia kontaktowe jako konwersje?

Moduł liczy zgłoszenie, gdy komunikat o powodzeniu formularza jest rzeczywiście widoczny, i może wysłać je do Google Ads jako konwersję.

Natywny formularz kontaktowy PrestaShop jest wykrywany po stronie serwera. W przypadku formularza wysyłanego bez przeładowania strony podaj jego selektory CSS w Inne formularze kontaktowe (selektory CSS), a selektory komunikatu w Komunikat o powodzeniu (selektory CSS), oddzielone przecinkami. Od wersji 2.1.0 komunikat pokazany przez zmianę klasy lub stylu jest liczony; komunikat obecny, ale ukryty, nie jest liczony. Liczone jest jedno zgłoszenie na stronę.

W Google Ads podaj identyfikator AW-…, etykietę konwersji Kontakt i, jeśli chcesz, szacowaną wartość. Konwersja jest wysyłana ze zgłoszeniem, bez podwójnego liczenia z natywnym formularzem.

Jak wykluczyć roboty i sprawdzić śledzenie bez wysyłania danych?

Włącz tryb weryfikacji, aby zobaczyć każde obliczone zdarzenie w sklepie, a następnie opcję wykluczania robotów, jeśli raporty mieszają prawdziwe wizyty z ruchem narzędzi.

Na karcie Wykluczenia i weryfikacja tryb weryfikacji pokazuje panel w sklepie, tylko dla Twojej przeglądarki, z każdym zdarzeniem i jego danymi. Przez 24 godziny nic nie jest wysyłane do Google. Link Usuń oznaczenie tej przeglądarki go wyłącza. Jeśli testujesz w zautomatyzowanej przeglądarce, panel informuje, że przeglądarka jest traktowana jak robot, i nadal pokazuje, co zostałoby wysłane.

Opcja Wykluczaj roboty i zautomatyzowane przeglądarki jest domyślnie wyłączona. Pomija przeglądarki bez interfejsu, testy wydajności (Lighthouse, PageSpeed Insights, GTmetrix, WebPageTest), usługi monitoringu (Pingdom, UptimeRobot, StatusCake…) oraz roboty wyszukiwarek, które wykonują JavaScript. Decyzja zapada w przeglądarce każdego odwiedzającego: strony serwowane z pamięci podręcznej pozostają takie same dla wszystkich, a tag weryfikacji Search Console zostaje na każdej stronie. Blokada reklam lub rozszerzenie prywatności, które uniemożliwia wczytanie skryptu Google, pozostawia wizytę poza GA4; tryb weryfikacji pokazuje zdarzenia obliczone przez moduł, a nie to, co otrzymało Google.

Przeglądarka panelu administracyjnego jest już wykluczona, a Ty możesz dodać adresy IP lub zakresy. Karta Diagnostyka uzupełnia te kontrole o identyfikatory, zgodę, duplikaty i ostatnie wysłane zamówienia. Moduł pamięci podręcznej działa z tą opcją, ponieważ strona w pamięci podręcznej nie zależy od odwiedzającego.

Jak zachować poprawne kwoty przy kuponie na darmową dostawę?

Od wersji 2.1.0 wartość wysyłana dla produktów nie jest już pomniejszana o darmową dostawę, a wysyłane koszty dostawy odpowiadają temu, co klient rzeczywiście zapłacił.

PrestaShop liczy darmową dostawę w sumie rabatów i zachowuje cenę przewoźnika w zamówieniu. Poprzednia wersja odejmowała tę cenę od wartości produktów i zgłaszała dostawę, której klient nie zapłacił. Błędna kwota trafiała do GA4, DataLayer i konwersji Google Ads. Wersja 2.1.0 oblicza część rzeczywiście oferowaną, odejmuje ją od kosztów dostawy i pozostawia wartość produktów bez zmian. Kupon łączący rabat i darmową dostawę zachowuje swój rabat.

Konkretny przypadek: klient dodaje produkt, stosuje kupon łączący rabat i darmową dostawę, a następnie składa zamówienie. Raport GA4 pokazuje rabat na produktach i brak kosztów dostawy, a konwersja Google Ads otrzymuje tę samą kwotę. Moduł promocji, który tworzy takie kupony, nie wymaga zmian.

Na karcie Zdarzenia wybierz identyfikator produktu (ID produktu, ID produktu i ID kombinacji lub kod referencyjny), czy ceny zawierają podatek, oraz wartość zakupu (łączna zapłacona kwota albo produkty netto po rabatach). Użyj identyfikatora z pliku Merchant Center, jeśli korzystasz z remarketingu dynamicznego.

Co się dzieje, gdy licencja wygasa lub serwer nie odpowiada?

Bez ważnej licencji moduł wyłącza się w sklepie i zachowuje ustawienia oraz śledzone zamówienia; strona konfiguracji włącza go ponownie.

Licencja wygasła, zawieszona, unieważniona, nierozpoznana dla tej domeny lub brak licencji odcina tag Google i kontener Tag Managera, zatrzymuje zdarzenia, aktualizacje zgody i konwersje oraz usuwa tag Search Console. Ustawienia, lista śledzonych zamówień i sekret cookies pozostają. Strona konfiguracji pokazuje typ licencji, domenę, datę końca i pozostałe dni oraz przycisk Dezaktywuj, który po potwierdzeniu zwalnia domenę.

Po zapisanej dacie końca odnowiona subskrypcja jest sprawdzana na serwerze licencji: moduł czeka siedem dni bez zapytania, a potem odpytuje serwer najwyżej raz na godzinę. Poprawna odpowiedź zapisuje nową datę. Wyraźna odmowa wyłącza moduł. Odpowiedź przejściowa — błąd serwera, limit zapytań, przesunięty zegar, nieosiągalny serwer — nigdy nie wyłącza opłaconej licencji: siedmiodniowa tolerancja liczy się od pierwszego błędu. Jeśli Twój moduł 2.0.1 wyłączył się, gdy subskrypcja była ważna, otwórz raz stronę konfiguracji.

Wizyty i zamówienia przyjęte podczas wyłączenia nie są odzyskiwane: śledzenie wraca po ponownym włączeniu. Consent Mode przekazuje wybór odwiedzającego; nie zastępuje banera, polityki prywatności ani analizy podstawy prawnej. Więcej szczegółów znajdziesz w dokumentacji, a karta modułu danych strukturalnych pokazuje, jak wzbogacić karty produktów odczytywane przez Search Console.

Moduł Google Analytics 4, GTM i Search Console instaluje się w PrestaShop 1.7.8, 8.0+ i 9.0+ z PHP 7.4 lub nowszym. Przetestuj ścieżkę w trybie weryfikacji, zanim odczytasz raporty.