PS PrestaShop Średnio zaawansowany

Google Tag Pro (GTM i GA4) — Kompletny przewodnik

Instalacja, konfiguracja i weryfikacja Google Tag Pro: kontener Tag Manager, zdarzenia e-commerce GA4, Consent Mode v2, Enhanced Conversions, eksport kontenera, debuger i diagnostyka, dla PrestaShop 1.7.8, 8 i 9.

Zaktualizowano Wersja modułu 2.0.0

Google Tag Pro (moduł dfgtagmanager, wersja 2.0.0) ładuje Twój kontener Google Tag Manager i wypełnia dataLayer zdarzeniami e-commerce GA4 z całej ścieżki zakupowej. Wysyła wartości domyślne Google Consent Mode v2 przed Tag Manager, przekazuje dane Enhanced Conversions dopiero po wyrażeniu zgody, zapisuje każdy zakup jeden raz na zamówienie i eksportuje kontener odpowiadający tym zdarzeniom. Debuger, dziennik zdarzeń i diagnostyka zduplikowanych tagów są wbudowane w panel administracyjny.

Wymagania

  • PrestaShop 1.7.8, 8 lub 9 (PHP 7.1 lub nowszy). Przetestowano na wersjach 1.7.8.11 (PHP 7.4), 8.2.1 (PHP 8.1) i 9.1.5 (PHP 8.5), z szablonami Classic i Hummingbird.
  • Kontener internetowy Google Tag Manager (GTM-XXXXXXX) i usługa Google Analytics 4 (G-XXXXXXXXXX).
  • Baner zgody wysyłający aktualizacje Google Consent Mode, na przykład DataFirefly Cookie Manager (tarteaucitron) z włączonymi sygnałami Google Consent Mode.
  • Opcjonalnie: Google Ads (identyfikator konwersji AW-… i etykieta), Merchant Center, Tag Manager po stronie serwera.

Instalacja i aktualizacja

  1. W menu Moduły > Menedżer modułów kliknij Prześlij moduł i wybierz plik dfgtagmanager-2.0.0.zip.
  2. Otwórz Ulepszenia > Google Tag Manager. Nowa instalacja nie ładuje niczego w sklepie, dopóki nie włączysz śledzenia w asystencie.

Aktualizacja z wersji 1.x: prześlij nowy plik zip na stary moduł. Wszystkie ustawienia są zachowywane (dodawane są tylko nowe), historia zakupów jest scalana do jednego wiersza na zamówienie, a zamówienia już wyświetlone przez wersję 1.x nigdy nie są wysyłane ponownie. Jeśli śledzenie było włączone, pozostaje włączone.

1. Asystent konfiguracji

Asystent konfiguracji Google Tag Manager: kroki, stan śledzenia i wskaźniki wysłanych zakupów
Asystent konfiguracji Google Tag Manager: kroki, stan śledzenia i wskaźniki wysłanych zakupów

Asystent przedstawia sześć kroków: identyfikator kontenera, zgoda, dane e-commerce, Google Ads i Enhanced Conversions (opcjonalnie), import kontenera i testowa wizyta. Panel po prawej stronie pokazuje, za okres 30 dni, wysłane zakupy, odsetek potwierdzonych przez przeglądarkę, zablokowane duplikaty oraz odzyskane zakupy i zwroty. Śledzenie pozostaje wyłączone dla odwiedzających, dopóki nie klikniesz Włącz dla odwiedzających: do tego czasu dataLayer otrzymuje tylko Twoja przeglądarka debugowania.

2. Dane e-commerce

Dane e-commerce GA4: ceny netto lub brutto, item_id z pliku danych Merchant Center, kategorie, odzyskiwanie zakupów i zwroty
Dane e-commerce GA4: ceny netto lub brutto, item_id z pliku danych Merchant Center, kategorie, odzyskiwanie zakupów i zwroty
  • Ceny i wartość: netto (Google wymaga, aby value = suma price × quantity, bez kosztów wysyłki i podatku) lub brutto. Ten sam wybór dotyczy wszystkich zdarzeń, od list po zwrot.
  • Kody rabatowe są rozkładane na ceny pozycji, tak aby price pozostawała jednostkową ceną po rabacie, a value sumą pozycji. discount to rabat jednostkowy.
  • Waluty: każde zdarzenie używa waluty odwiedzającego, każdy zakup waluty zamówienia.
  • item_id: ID + separator + kombinacja, ID + _ + kombinacja, ID produktu, indeks, EAN-13, UPC lub MPN. Użyj tego samego formatu co id w pliku danych Merchant Center. Pusty indeks jest zastępowany identyfikatorem produktu.
  • Ścieżka kategorii: od item_category do item_category5, od kategorii najwyższego poziomu do kategorii domyślnej produktu. item_variant zawiera kombinację (na przykład „M / Biały”).
  • Odzyskiwanie zakupów i Zwroty: patrz sekcje 6 i 7.
Google Consent Mode v2: wartości domyślne przed Tag Managerem, region, wykryty baner cookies i kod zapisany na stronie
Google Consent Mode v2: wartości domyślne przed Tag Managerem, region, wykryty baner cookies i kod zapisany na stronie

Na każdej stronie, przed Tag Manager, moduł zapisuje gtag('consent', 'default', …) z ad_storage, ad_user_data, ad_personalization i analytics_storage ustawionymi domyślnie na denied oraz wait_for_update (domyślnie 500 ms).

  • Automatycznie (zalecane): jeśli Twój baner już wysyła własne wartości domyślne, moduł nie wysyła żadnych. Gdy DataFirefly Cookie Manager ma włączone sygnały Google Consent Mode, Tag Manager ładuje się zaraz po wartościach domyślnych banera.
  • Zawsze moduł: moduł zawsze wysyła wartości domyślne; baner wysyła tylko aktualizacje.
  • Region: wszyscy odwiedzający albo tylko Europejski Obszar Gospodarczy, Wielka Brytania i Szwajcaria (parametr region).
  • ads_data_redaction jest włączony; url_passthrough jest domyślnie wyłączony.

Gdy odwiedzający dokona wyboru, baner wysyła aktualizację. Moduł uwzględnia każde wywołanie gtag('consent', 'update', …) i udostępnia również:

window.dfgtm.update({
  ad_storage: 'granted',
  ad_user_data: 'granted',
  ad_personalization: 'granted',
  analytics_storage: 'granted'
});

Moduł wysyła sygnały zgody Google; nie decyduje o tym, o co musi pytać Twój sklep. Twój baner zgody i jego ustawienia pozostają Twoją odpowiedzialnością.

4. Google Ads i Enhanced Conversions

Google Ads i Enhanced Conversions: konwersja zakupu, Merchant Center, e-mail i telefon zahaszowane SHA-256 po wyrażeniu zgody
Google Ads i Enhanced Conversions: konwersja zakupu, Merchant Center, e-mail i telefon zahaszowane SHA-256 po wyrażeniu zgody

Wprowadź identyfikator i etykietę konwersji, aby dodać do eksportowanego kontenera konwersję zakupu Google Ads i Conversion Linker. Po podaniu identyfikatora Merchant Center konwersja zawiera także pozycje (dane koszyka).

Gdy funkcja Enhanced Conversions jest włączona, strona potwierdzenia zamówienia przygotowuje adres e-mail i numer telefonu z zamówienia: małe litery, usunięte spacje, usunięte kropki przed @gmail.com i @googlemail.com, telefon w formacie E.164, a następnie SHA-256 (sha256_email_address, sha256_phone_number). Można dodać imię, nazwisko, kod pocztowy i kraj (domyślnie wyłączone). Te dane user_data są wysyłane dopiero po przyznaniu ad_user_data. Żaden adres e-mail w postaci jawnej nie pojawia się na stronie, w dataLayer, w dzienniku ani w żądaniach modułu.

5. Zdarzenia wysyłane do dataLayer

Każde zdarzenie e-commerce jest poprzedzone { ecommerce: null }.

Zdarzenie Kiedy
view_item_list Strony list produktów (kategoria, wyszukiwanie, marka, najlepiej sprzedające się…) z rzeczywiście wyświetlonymi produktami; strona główna i bloki produktów na podstawie miniatur produktów; po filtrowaniu AJAX
select_item Kliknięcie miniatury produktu, wraz z jej listą
view_item Strona produktu i szybki podgląd
add_to_cart / remove_from_cart Po każdej aktualizacji koszyka (strona produktu, szybki podgląd, strona koszyka, ilość, usunięcie), na podstawie rzeczywistych pozycji koszyka
view_cart Strona koszyka, z kodami rabatowymi
begin_checkout Realizacja zamówienia, raz na zawartość koszyka
add_shipping_info Osiągnięcie etapu płatności, z shipping_tier (przewoźnik)
add_payment_info Wybór metody płatności, z payment_type
purchase Strona potwierdzenia zamówienia, raz na zamówienie (transaction_id = numer referencyjny zamówienia, tax, shipping, coupon, customer_type)
refund Korekta lub zamówienie zwrócone / anulowane po jego zakupie
search, login, sign_up Strona wyszukiwania (adres e-mail wpisany w polu nigdy nie jest wysyłany), logowanie, utworzenie konta
add_to_wishlist, view_promotion, select_promotion Przycisk listy życzeń; banery z atrybutem data-dfgtm-promotion-id

6. Zakup wysyłany raz na zamówienie

Zakupy GA4: jeden na zamówienie, zablokowane ponowne wczytania potwierdzenia, odzyskane i potwierdzone zakupy
Zakupy GA4: jeden na zamówienie, zablokowane ponowne wczytania potwierdzenia, odzyskane i potwierdzone zakupy

Każde zamówienie ma w module jeden wiersz. Zakup jest zapisywany na stronie potwierdzenia zamówienia tylko przy jej pierwszym wyświetleniu: ponowne wczytanie, przycisk Wstecz, druga karta lub powrót od dostawcy płatności niczego nie zapisują i są liczone jako zablokowany duplikat. Przeglądarka zapamiętuje także transaction_id każdego wysłanego zakupu. Zamówienia z błędem lub anulowane nie wysyłają zakupu.

Ponowne wczytanie strony potwierdzenia: zakup nie jest wysyłany ponownie, zgoda przed Tag Managerem, poprawne zdarzenia
Ponowne wczytanie strony potwierdzenia: zakup nie jest wysyłany ponownie, zgoda przed Tag Managerem, poprawne zdarzenia

Odzyskiwanie: jeśli strona potwierdzenia nigdy nie została wyświetlona (dostawca płatności bez powrotu do sklepu) lub została zamknięta przed załadowaniem Tag Manager, zakup jest wysyłany jeden raz na następnej stronie tego samego klienta, w ciągu 48 godzin, z tym samym transaction_id. Google wskazuje, że GA4 deduplikuje zdarzenia zakupu z tym samym identyfikatorem transakcji.

7. Zwroty

Korekta wysyła refund ze zwróconymi pozycjami; zamówienie przeniesione do stanu Zwrot pieniędzy lub Anulowane po jego zakupie wysyła pełny zwrot (nigdy po zwrotach częściowych). Zwrot jest wysyłany przy następnej wizycie klienta. Opcjonalnie może go wysłać z serwera Measurement Protocol: wprowadź własny klucz tajny API (GA4 > Administracja > Strumienie danych > Measurement Protocol). Jest on używany tylko dla zamówień, których zakup został zmierzony przy przyznanym analytics_storage, zgodnie ze zgodą z tamtej wizyty. Nic innego nie jest wysyłane z serwera.

8. Debuger dataLayer

Debuger dataLayer: test sklepu na żywo, każde zdarzenie trafia do panelu administracyjnego
Debuger dataLayer: test sklepu na żywo, każde zdarzenie trafia do panelu administracyjnego

Test sklepu na żywo otwiera sklep w nowej karcie z podpisanym linkiem ważnym przez dwie godziny. Tylko ta przeglądarka otrzymuje dataLayer, gdy śledzenie jest wyłączone dla odwiedzających, a każde zdarzenie pojawia się na żywo w panelu administracyjnym.

Panel debugowania na stronie produktu: add_to_cart z kombinacją, rabatem i kategoriami
Panel debugowania na stronie produktu: add_to_cart z kombinacją, rabatem i kategoriami

W sklepie panel wyświetla każdy push wraz z jego JSON, stan zgody i kontrole strony.

Proces zamówienia: begin_checkout, add_shipping_info z przewoźnikiem i add_payment_info z metodą płatności
Proces zamówienia: begin_checkout, add_shipping_info z przewoźnikiem i add_payment_info z metodą płatności
Podgląd dataLayer strony produktu: view_item i add_to_cart sprawdzone według dokumentacji zdarzeń GA4
Podgląd dataLayer strony produktu: view_item i add_to_cart sprawdzone według dokumentacji zdarzeń GA4

dataLayer strony pokazuje, niczego nie zmieniając, co wysłałaby strona produktu, kategoria, koszyk i realizacja zamówienia, potwierdzenie zamówienia lub wyszukiwanie, i sprawdza każdy push względem dokumentacji zdarzeń GA4 (items, currency, gdy ustawiono value, value = suma pozycji, transaction_id…).

9. Dziennik zdarzeń

Dziennik zdarzeń: zakupy, zwroty, sesje debugowania i ostrzeżenia, bez żadnych danych osobowych
Dziennik zdarzeń: zakupy, zwroty, sesje debugowania i ostrzeżenia, bez żadnych danych osobowych

Dziennik przechowuje zapisane zakupy, zablokowane duplikaty, odzyskania, zwroty i zdarzenia sesji debugowania, z filtrami i JSON każdego wiersza. Nigdy nie zawiera adresu e-mail ani user_data. Wiersze starsze niż okres przechowywania wybrany w Ustawieniach (domyślnie 30 dni) są usuwane automatycznie. Karta Zakupy pokazuje stan każdego zamówienia; pokazuje go również strona zamówienia w panelu administracyjnym.

10. Eksport kontenera

Eksport kontenera Tag Manager: tag Google, zdarzenia GA4, konwersja Google Ads, reguły i zgoda dla każdego tagu
Eksport kontenera Tag Manager: tag Google, zdarzenia GA4, konwersja Google Ads, reguły i zgoda dla każdego tagu

Eksport jest zgodny z formatem eksportu Tag Manager: tag Google (GA4), jeden tag zdarzenia GA4 zasilany przez dataLayer dla zdarzeń e-commerce, tagi search oraz login / sign_up, a jeśli zostały skonfigurowane, konwersja zakupu Google Ads, Conversion Linker i zmienna User-Provided Data dla Enhanced Conversions. Tagi Google zachowują wbudowane kontrole zgody; tagi Meta, TikTok i Pinterest wymagają ad_storage. Kontener nie zawiera tagu zgody: moduł zapisuje wartości domyślne na stronie.

  1. Kliknij Pobierz kontener.
  2. W Tag Manager otwórz Administracja > Importuj kontener, wybierz plik i nowy obszar roboczy.
  3. Wybierz Scal i Zmień nazwy kolidujących tagów, reguł i zmiennych.
  4. Sprawdź identyfikator GA4 i etykietę Google Ads, przetestuj w trybie podglądu i za pomocą debugera modułu, a następnie opublikuj.

11. Diagnostyka i inne moduły

Diagnostyka duplikatów: inne moduły Google Analytics lub banera cookies oraz analiza strony na żywo
Diagnostyka duplikatów: inne moduły Google Analytics lub banera cookies oraz analiza strony na żywo

Diagnostyka odczytuje, niczego w nich nie zmieniając, moduły, które mogą ładować tagi Google lub baner:

  • moduł PrestaShop Google Analytics (ps_googleanalytics) z identyfikatorem: wizyty liczone podwójnie;
  • DataFirefly All in One SEO, karta Śledzenie: ten sam lub inny kontener, GA4 ładowane bezpośrednio, zdarzenia e-commerce wysyłane podwójnie;
  • DataFirefly Cookie Manager: sygnały Google Consent Mode, usługi Tag Manager lub GA4 w banerze;
  • inne banery zgody i moduły, których nazwa wskazuje na tagi Google.

Analiza na żywo ładuje w tle stronę sklepu i zlicza skrypty ładujące Tag Manager i gtag.js, polecenia domyślnej zgody i ich kolejność, zduplikowane zdarzenia, brakujące ecommerce: null, nieprawidłowe zdarzenia i inne narzędzia śledzące.

Rozwiązywanie problemów

Nic nie dociera do Tag Manager

Sprawdź, czy identyfikator kontenera jest prawidłowy, czy śledzenie jest włączone w asystencie i czy moduł jest włączony w menedżerze modułów. Otwórz sesję debugowania: karta Kontrole pokazuje, czy wysłano domyślną zgodę i czy Tag Manager się załadował.

Zgoda pozostaje „denied”

Twój baner nie wysyła aktualizacji Google Consent Mode. Włącz jego sygnały Google Consent Mode lub wywołaj window.dfgtm.update(…), gdy odwiedzający dokona wyboru.

Brak add_to_cart przy innym szablonie

Moduł opiera się na standardowych zdarzeniach PrestaShop i miniaturach produktów. Przetestuj za pomocą debugera; szablon, który nie emituje updateCart, jest wykrywany po kliknięciu przycisku dodawania do koszyka.

Wizyty są liczone podwójnie

Otwórz diagnostykę: prawdopodobnie inny moduł również ładuje GA4 lub Tag Manager. Zostaw tylko jeden z nich.

Czy ta strona była pomocna?

Nadal utknąłeś? Napisz do wsparcia