Blueberry Studio

Blue Analytics: Google Analytics 4 dla PrestaShop

Moduł, który wpina kod śledzenia Google Analytics 4 (gtag.js) do sklepu i automatycznie wyklucza ruch z panelu administracyjnego. W statystykach masz klientów, nie własne kliknięcia sprzedawcy i obsługi.

Moduł blueanalytics • wersja 1.1.0 • PrestaShop 1.7+

W jednym zdaniu: Wklejasz swój identyfikator GA4 (format G-XXXXXXXXXX) w konfiguracji modułu, zapisujesz — moduł od razu zaczyna wysyłać dane do Google Analytics dla klientów, a nie dla Ciebie i obsługi (dopóki jesteście zalogowani w panelu). Bez ręcznego wklejania kodu w motyw, bez edycji plików.

Zanim zaczniesz, najważniejsze pojęcia (przeczytaj, to zajmie minutę):

Google Analytics 4 (GA4): darmowa usługa Google do zliczania odwiedzin i zachowań na stronie. Zastąpiła stary „Universal Analytics” w połowie 2023.
Identyfikator pomiaru (Measurement ID): unikalny kod strumienia w GA4 w formacie G-XXXXXXXXXX. Każda strona ma swój.
gtag.js: mały skrypt Google, który wysyła dane o odwiedzinach. Moduł wkleja go w nagłówek każdej strony sklepu.
Panel administracyjny (back office): strona pod adresem typu /admin445rpri6/, na której zarządzasz sklepem. Ruch z tego adresu nie powinien trafiać do statystyk.
Cache (pamięć podręczna): sklep zapamiętuje wygląd stron dla szybkości. Po zmianach zwykle trzeba ją „wyczyścić”, żeby zobaczyć efekt.

Spis treści

Co dokładnie robi moduł
Skąd wziąć identyfikator GA4
Instalacja / aktualizacja
Konfiguracja
Test: czy śledzenie działa
Test: czy panel jest wykluczony
Najczęstsze pytania i problemy

1.Co dokładnie robi moduł

Blue Analytics dokłada do sklepu jedną małą, ale ważną rzecz: skrypt śledzenia GA4, poprawnie wpięty w każdą stronę front-endu. Bez ręcznego wklejania kodu do motywu i bez modyfikacji plików.

Dodatkowo pilnuje, żeby ruch z panelu admina nie zawyżał statystyk. Robi to dwutorowo:

Po stronie PHP — jeśli strona jest wykrywana jako administracyjna, kod GA nie jest w ogóle wysyłany do przeglądarki.
Po stronie JavaScript — dodatkowy filtr wyłącza wysyłkę zdarzeń dla ścieżek zawierających /admin, /administrator, /backoffice itd. Zabezpieczenie na wypadek niestandardowej konfiguracji.

2.Skąd wziąć identyfikator GA4

Wejdź na analytics.google.com i zaloguj się kontem Google.
Jeśli masz już właściwość (property) dla sklepu — pomiń do kroku 4. Jeśli nie: Administracja → Utwórz właściwość, uzupełnij nazwę i strefę czasową.
W nowo utworzonej właściwości: Strumienie danych → Sieć → Dodaj strumień, wpisz adres sklepu.
W widoku strumienia skopiuj „Identyfikator pomiaru” w formacie G-XXXXXXXXXX.

Uwaga terminologiczna. Nie mylić z ID strumienia (długi numer typu 15003238830) ani z Google Ads Customer ID (AW-...) — moduł potrzebuje wyłącznie G-XXXXXXXXXX.

3.Instalacja / aktualizacja

Zaloguj się do panelu administracyjnego sklepu.
Z menu wybierz Moduły → Menedżer modułów.
W prawym górnym rogu kliknij „Prześlij moduł”.
Wskaż plik blueanalytics.zip.
Poczekaj na komunikat o powodzeniu i, jeśli trzeba, kliknij „Zainstaluj”.

4.Konfiguracja

W Menedżerze modułów znajdź Blue Analytics → „Konfiguruj”.
W polu „ID Google Analytics” wklej identyfikator G-XXXXXXXXXX ze strumienia danych.
Pozostaw włączoną opcję „Wyklucz panel administracyjny”. Wyłącz tylko, gdy chcesz świadomie liczyć też ruch z back office (rzadko potrzebne).
Kliknij „Zapisz”.
Wyczyść cache: Zaawansowane → Wydajność → Wyczyść cache.

Ustawienie	Do czego	Domyślnie
ID Google Analytics	Twój identyfikator strumienia w formacie `G-XXXXXXXXXX`	puste
Wyklucz panel administracyjny	Nie liczyć wizyt w back office	Tak (włączone)

5.Test: czy śledzenie działa

Otwórz stronę główną sklepu w trybie incognito (żeby uniknąć rozszerzeń blokujących GA).
Wciśnij F12, przejdź na zakładkę Network, w filtrze wpisz google.
Odśwież stronę. Powinno pojawić się co najmniej jedno żądanie do googletagmanager.com/gtag/js i do google-analytics.com/g/collect.
Wejdź na analytics.google.com → Raporty → Czas rzeczywisty. Powinieneś widzieć swoją wizytę w ciągu ~30 sekund.

Jeśli widzisz siebie w „Czasie rzeczywistym”, moduł działa. Można iść na kawę.

6.Test: czy panel jest wykluczony

Zaloguj się do panelu administracyjnego sklepu.
Otwórz F12 → Network, filtr google.
Kliknij po kilku sekcjach w menu admina.
W zakładce Network nie powinno być żądań do googletagmanager.com ani google-analytics.com/g/collect.
Równolegle sprawdź w GA4 Czas rzeczywisty: nie powinno być tam odsłon z URL-i zaczynających się na Twój adres panelu.

Jeśli w Network pojawiają się żądania do google-analytics z panelu: upewnij się, że opcja „Wyklucz panel administracyjny” jest włączona i wyczyść cache PrestaShop. Sprawdź też, czy adres Twojego panelu zaczyna się od /admin, /administrator, /backoffice lub podobnego wzorca (moduł je rozpoznaje). Jeśli używasz nietypowego prefiksu, zgłoś nam adres — dopiszemy wzorzec.

7.Najczęstsze pytania i problemy

W kodzie strony nie widzę `gtag('config','G-...')`

Sprawdź, czy moduł jest zainstalowany i aktywny (Moduły → Menedżer modułów).
Sprawdź, czy w konfiguracji uzupełniłeś ID w formacie G-XXXXXXXXXX (nie UA-..., nie samą liczbę).
Wyczyść cache PrestaShop.
Zajrzyj do kodu strony (Ctrl+U), poszukaj googletagmanager. Jeśli nie ma, sprawdź czy motyw nie usuwa kodu z hooka displayHeader.

Statystyki są dziwnie niskie

Rozszerzenia blokujące reklamy (uBlock, AdBlock, tryb prywatny Firefoxa) blokują żądania do Google. Utrata 10–30% ruchu w statystykach jest zjawiskiem normalnym w krajach z wysoką penetracją takich narzędzi.
Sprawdź, czy nie masz ciasteczek Cookiebota / OneTrust — jeśli klient nie kliknie „Akceptuję”, GA nie wystartuje. To poprawne prawnie i celowe.

Chcę używać Google Tag Managera (GTM) zamiast bezpośredniego GA4

W tej wersji moduł wkleja bezpośrednio gtag.js. Jeśli używasz GTM w motywie (np. przez własny kod w head.tpl), wyłącz moduł lub zostaw pole „ID GA” puste — inaczej będziesz liczył ruch podwójnie.
Wersja z opcją GTM jest planowana; jeśli potrzebujesz jej pilnie, napisz.

Panel admin ma nietypowy adres (np. `/moje-narzedzia/`) i moduł nadal go liczy

Moduł rozpoznaje wzorce zawierające admin, administrator, backoffice. Wysoce nietypowy prefiks trzeba dopisać w kodzie modułu — daj znać, dodamy do wzorców.
Jako obejście: w Google Analytics dodaj filtr wykluczający po Twoim adresie panelu (Administracja → Ustawienia danych → Filtry danych → Wyklucz ruch).

Chcę śledzić zdarzenia typu „dodanie do koszyka”, „zakup”

Ta wersja obsługuje podstawowe śledzenie odsłon. Zdarzenia e-commerce (Enhanced E-commerce w GA4) można podpiąć osobno przez GTM albo dedykowany moduł. Napisz jeśli potrzebujesz — mamy gotowy zestaw dla PS 8.x.