Google Analytics GA4: konfiguracja i pomoc

Wykonaj kroki opisane w sekcji Szybki start.

Otwórz "Configure" w "Module Manager". Użyj sekcji Ustawienia do konfiguracji identyfikatorów i śledzenia, a sekcji Diagnostyka do kontroli. Dostępne są osobne strony Licencja, Wsparcie, Aktualizuj i "Integrity".

"Enhanced Conversions" haszuje e-mail, telefon, imię, nazwisko, miasto, region i kod pocztowy po usunięciu skrajnych spacji i zamianie na małe litery. Kod ISO kraju jest wysyłany bez haszowania. Pola adresu pochodzą z pierwszego adresu klienta, jeśli jest dostępny. Ta opcja jest oddzielna od śledzenia zahaszowanego ID klienta.

Zaangażowanie w produkt

Wspólny tracker rozpoznaje też zmiany wariantów i interakcje ze szczegółami produktu. Domyślnie ogranicza wysokie zainteresowanie do jednego razu na produkt/sesję. Zachowaj to oddzielnie od głównej konfiguracji konwersji zakupowych.

Gdy Cookies Revolution jest aktywny, moduł wykrywa go i może przesunąć się na koniec displayHeader, aby CMP najpierw inicjowała Consent Mode. W razie potrzeby użyj Napraw kolejność hooków w sekcji Diagnostyka.

Bez tej wykrytej CMP moduł emituje domyślne wartości Consent Mode odmawiające przechowywania analitycznego, reklamowego, danych użytkownika reklam i personalizacji, przy zezwoleniu na przechowywanie związane z bezpieczeństwem. To domyślny fragment kodu. Nie tworzy banera ani nie uzyskuje zgody. Skonfiguruj aktualizacje zgody przez narzędzie zgód.

Bramka kwalifikacji przeglądarkowej pomija kontrolery spoza frontu, rozpoznane boty/narzędzia audytu, wykluczonych pracowników i przeglądarkę z mpr_notrack=1. Aby wykluczyć przeglądarkę testową:

document.cookie = 'mpr_notrack=1; path=/; max-age=31536000; SameSite=Lax';

Zakupy serwerowe wymagają zapisanej zgody analitycznej kupującego, jego pierwotnych identyfikatorów klienta i sesji GA oraz przypisania temu modułowi obsługi skonfigurowanej usługi GA4. Obowiązują też rezygnacje ze śledzenia w przeglądarce i wykluczenia pracowników. "Server-Side Purchase Fallback" jest domyślnie wyłączone. Aby je włączyć, wpisz prawidłowe dane uwierzytelniające i ustaw "Purchase recovery hostname" na nazwę hosta HTTPS sklepu produkcyjnego, bez protokołu i ścieżki.

Moduł ładuje GA4 asynchronicznie przez displayHeader. Wysyła zdarzenia e-commerce następującymi ścieżkami:

Ten formularz nie ma osobnych przełączników standardowych zdarzeń e-commerce. Ich obecność zależy od odpowiednich hooków i przebiegu działania motywu.

Dane zakupu obejmują numer referencyjny zamówienia jako transaction_id, wartość, walutę, podatek, wysyłkę, kupony i pozycje. Dostępne pola pozycji obejmują ID, nazwę, cenę, ilość, markę, kategorię, wariant i rabat. Sprawdź te wartości na testowym zamówieniu ze swoją konfiguracją podatków, rabatów i wysyłki.

"Track custom events" domyślnie ma wartość Nie. Pole "Custom event rules" jest początkowo puste. Dodaj reguły, włącz przełącznik i zapisz:

[
  {"event":"gallery_browse","trigger":"click","selector":".product-images img,.images-container img","params":{"component":"product_gallery"},"once":false},
  {"event":"checkout_page_seen","trigger":"url","contains":["/order"],"params":{"area":"checkout"},"once":true},
  {"event":"module_page_seen","trigger":"controller","controllers":["module"],"modules":["mprwishlist"]},
  {"event":"size_guide_opened","trigger":"event","dom_event":"shop:size-guide-opened","params":{"component":"size_guide"},"once":false}
]

document.dispatchEvent(new CustomEvent('shop:size-guide-opened'));

Używaj nazw zdarzeń i parametrów zaczynających się literą, zawierających litery, cyfry lub podkreślenia i mających maksymalnie 40 znaków. Zastrzeżone nazwy i prefiksy są odrzucane. Klucze parametrów przypominające dane osobowe są filtrowane. Selektory kliknięć mogą mieć do 500 znaków. once domyślnie wynosi false dla kliknięć i true dla reguł URL, kontrolera i DOM. Dopasuj filtry kontrolera/modułu do rzeczywistej trasy.

Walidacja zamówienia zapisuje kwalifikujące się zakupy do odzyskania. Po 30 minutach bez potwierdzenia przeglądarkowego wspólne zadanie cron kolejkuje i wysyła kwalifikujące się zdarzenia Measurement Protocol purchase, korzystając z danych kupującego zapisanych przy składaniu zamówienia:

task: send_ga4_measurement_protocol
callable: mprgoogleanalytics::cronProcessMeasurementProtocolQueue
schedule: every:300
context: any
timeout: 30

Upewnij się, że wspólny runner cron MPR wykonuje to zadanie. Sprawdź dziennik zdarzeń w sekcji Diagnostyka i wspólną kolejkę konwersji. Wiersze dziennika używają prefiksu bazy, po którym jest mpr_analytics_events; ps_ to tylko zwykły przykład. Czyszczenie retencji działa po kwalifikującej się walidacji zamówienia. Odzyskiwanie zakupu wygasa 72 godziny po zamówieniu. Przechowywanie rekordów odzyskiwania podlega ustawieniu "Log Retention (days)".

Zakupy przeglądarkowe i serwerowe używają numeru referencyjnego zamówienia jako transaction_id. Wspólny rejestr wysyłki przypisuje każdy zakup do jednego kanału. Odzyskiwanie serwerowe obejmuje tylko zamówienia, dla których po 30 minutach nadal brakuje potwierdzenia przeglądarkowego.

Identyfikatory klienta i sesji dla zakupów serwerowych pochodzą z pierwotnych cookies GA zapisanych przed zamówieniem. Brakujące lub nieprawidłowe identyfikatory wstrzymują odzyskiwanie; moduł nie generuje zastępczych tożsamości. Kolejka nie zamienia zdarzeń tylko przeglądarkowych w serwerowe.

Otwórz sekcję Diagnostyka i użyj Uruchom testy. Sprawdź wymaganą konfigurację, poprawność reguł, kolejność hooków, widoczność grupy modułu, wykrywanie CMP, podwójne skrypty, wykluczenia i status Measurement Protocol. Użyj Napraw kolejność hooków lub Napraw grupę modułów, gdzie potrzeba.

Użyj zwykłej przeglądarki klienta do sprawdzenia żądań sieciowych i GA4 DebugView. Agenty botów/audytu mogą być celowo wykluczone. Przetestuj wyświetlenie produktu, zmiany koszyka, składanie zamówienia, logowanie, rejestrację, wyszukiwanie i pełne zamówienie. Zweryfikuj numer referencyjny transakcji i sumy pozycji.

Jeśli tag się nie ładuje, sprawdź "Enable Tracking", "Measurement ID", wykluczenia pracowników/rezygnacji, wykonywanie hooków i podwójne przypisanie właściciela. Jeśli motyw pomija displayProductActions lub displayBeforeCarrier, powiązane zdarzenie może nie wystąpić.

Jeśli brakuje zakupu serwerowego, sprawdź przełącznik awaryjny, ID, sekret, przypisanie modułowi obsługi funkcji śledzenia, worker kolejki i najnowszy log HTTP/błędów. Pusty sekret pozostawia śledzenie przeglądarkowe dostępne. Sumy GA4 mogą różnić się od PrestaShop przez blokowane skrypty, zgodę, atrybucję, opóźnienia raportów i zwroty. Śledzenie zakupów tego modułu nie jest systemem uzgadniania księgowości.

Ustaw "Enable Tracking" na Nie i zapisz, aby wstrzymać integrację. Odinstaluj przez "Module Manager", aby usunąć menu, rejestrację cron i konfigurację. Wspólna tabela kolejki pozostaje, jeśli inny moduł używa pakietu konwersji; w przeciwnym razie helper odinstalowania ją usuwa. Zarządzaj usługą GA4 i jej danymi historycznymi w Google Analytics. Dziennik zdarzeń korzysta ze wspólnego magazynu; nie usuwaj wspólnej tabeli ręcznie.

Korzystaj z powyższych nazw ustawień, gdy zrzut różni się od zainstalowanej wersji.