30 posts 117 tags 7 domains

PrestaShop: GTM, piksele i kody konwersji bez grzebania w motywie

Jak dodać Google Tag Manager, piksel Meta i dataLayer GA4 z danymi produktu i zamówienia do PrestaShop bez edycji head.tpl i bez podwójnych konwersji.

Problem: kod do wklejenia, a motyw nie jest Twój

Prędzej czy później każdy sklep dostaje kawałek kodu do wklejenia na stronę: kontener Google Tag Managera, piksel Meta, skrypt czatu, kod konwersji od agencji reklamowej, weryfikację w Search Console. W PrestaShop zwykle kończy się to na jeden z trzech sposobów:

  • Wklejenie do szablonu motywu (head.tpl, footer.tpl). Działa do pierwszej aktualizacji albo zmiany motywu. Każda poprawka to FTP i programista, a po roku nikt nie pamięta, co gdzie siedzi.
  • Osobny moduł na każdy piksel. Pięć modułów, pięć konfiguracji, każdy dokłada swój JS i swoje hooki.
  • Kod konwersji na stronie „dziękujemy” bez zabezpieczeń. Klient odświeża stronę albo wraca do niej z maila i ten sam zakup liczy się drugi raz. Kampania wygląda lepiej, niż jest.

Do tego dochodzi pytanie, które pojawia się zawsze: „a da się wysłać do GTM wartość zamówienia i listę produktów?”. Da się, ale zwykle oznacza to pisanie własnego modułu.

Rozwiązanie: wszystkie kody w jednym miejscu w panelu

Moduł Własne kody na stronie (infinitycustomcodes) trzyma wszystkie wklejane kody w jednej liście w panelu PrestaShop. Każdy kod ma nazwę, miejsce, listę stron, na których ma działać, i przełącznik „aktywny”.

Lista kodów w module Własne kody na stronie
Lista kodów: miejsce wstawienia, strony, gotowy widget do szablonu i znacznik „raz na zamówienie”.

Motyw zostaje nietknięty. Zmiana motywu albo aktualizacja PrestaShop niczego nie kasuje, a wyłączenie kodu to jedno kliknięcie zamiast szukania go w plikach.

Moduł czy wklejenie do head.tpl?

Kontener GTM da się wkleić ręcznie do templates/_partials/head.tpl (w {literal}, żeby Smarty nie zjadł klamer). Przy jednym kodzie na stałe to wystarczy. Różnica wychodzi przy kolejnych:

Ręcznie w motywieModuł
aktualizacja lub zmiana motywukod znikakod zostaje
zmiana koduFTP, programista, czyszczenie cacheedycja w panelu
kod tylko na wybranych stronachwarunki w Smartylista typów stron
dane produktu i zamówieniawłasny kod w szabloniezmienne {{…}}
konwersja liczona razbrak„raz na zamówienie”
kto i co wstawiłhistoria FTPlista kodów z nazwami

Gdzie można wstawić kod

MiejsceTypowe użycie
nagłówek strony (<head>)Google Tag Manager, Consent Mode, weryfikacje, dataLayer
początek <body><noscript> z GTM
koniec <body>czaty, widżety opinii, skrypty, które mogą poczekać
potwierdzenie zamówieniakody konwersji z danymi zamówienia
widget w szablonie .tplblok HTML w konkretnym miejscu motywu

Każdy kod można ograniczyć do wybranych typów stron: główna, kategoria, produkt, koszyk, checkout, potwierdzenie zamówienia, CMS, wyszukiwarka, producent. Czat nie musi wisieć na stronach składania zamówienia, a piksel produktu nie musi ładować się na stronie głównej.

Dane sklepu w kodzie: zmienne {{…}}

Najwięcej czasu oszczędzają zmienne. W treści kodu wpisujesz {{product.price}} albo {{order.reference}}, a moduł wstawia wartości z bieżącej strony. Tak wygląda zdarzenie view_item dla GA4 przez dataLayer, ustawione tylko na kartę produktu:

Formularz kodu z dataLayer i zmiennymi produktu
Kod view_item dla GA4. Miejsce: nagłówek strony, strony: tylko produkt.

Dostępne są dane sklepu, strony (typ, język, waluta), klienta, produktu (indeks, EAN, nazwa, ceny brutto i netto, kategoria, producent), kategorii, koszyka i zamówienia. Modyfikatory pilnują formatu:

  • {{product.name}} domyślnie jest bezpiecznie escapowane do JS, więc apostrof w nazwie produktu nie rozsypie skryptu,
  • {{order.products|json}} wstawia całą listę produktów jako JSON,
  • |html i |url służą do atrybutów HTML i parametrów w adresach pikseli.

Jeśli kod używa danych, których na danej stronie nie ma (np. zmiennych produktu poza kartą produktu), moduł go pomija. Na stronie nie pojawia się w takiej sytuacji skrypt z pustymi wartościami.

Podgląd przed zapisaniem

Pod formularzem jest podgląd: wybierasz typ strony i ID produktu, kategorii albo zamówienia, a moduł pokazuje, co dokładnie trafi na stronę.

Podgląd renderowania kodu dla wybranego produktu
Podgląd dla wybranego produktu: gotowy skrypt i wartości wszystkich zmiennych.

Konwersje liczone raz

Kod w miejscu potwierdzenie zamówienia dostaje pełne dane zamówienia: referencję, kwoty brutto i netto, dostawę, rabaty, podatek, walutę i listę produktów. To wystarczy do zdarzenia purchase w GA4, konwersji Google Ads czy zdarzenia Purchase w pikselu Meta.

Podgląd kodu purchase dla zamówienia
Zdarzenie purchase z danymi zamówienia, sprawdzone w podglądzie przed publikacją.

Opcja „raz na zamówienie” zapamiętuje, że kod już się wykonał dla danego zamówienia. Odświeżenie strony albo powrót z maila nie wyśle konwersji drugi raz. Warto to połączyć z transaction_id: '{{order.reference}}' w zdarzeniu GA4 i event_id w pikselu Meta: wtedy także systemy reklamowe odrzucą ewentualny duplikat. Do Enhanced Conversions jest gotowy skrót SHA-256 adresu e-mail ({{order.email_sha256}}).

Kolejność kodów na liście to kolejność na stronie. Domyślne ustawienia Consent Mode v2 (gtag('consent', 'default', …)) można więc postawić jako pierwszy kod w nagłówku, przed kontenerem GTM, tak jak wymaga tego Google.

Widget: kod w dowolnym miejscu szablonu

Każdy kod ma gotowe wywołanie do szablonu, np. {widget name='infinitycustomcodes' code='czas-wysylki'}. Kod w miejscu „tylko widget” pojawia się wyłącznie tam, gdzie wstawisz to wywołanie. Parametry widgetu przekazują dane do środka (param_dni=2 → {{param.dni}}) albo wskazują konkretny produkt czy kategorię. Treść bloku zmieniasz potem w panelu, bez ponownej edycji szablonu.

Nie wszystko musi być skryptem śledzącym. Pasek z informacją o darmowej dostawie to też kilka linijek kodu w miejscu „koniec body”:

Pasek z informacją o darmowej dostawie na stronie sklepu
Pasek dodany kodem w module, bez zmian w motywie.

Diagnostyka

Tryb debug otacza każdy kod w źródle strony komentarzem z ID i nazwą, a kody pominięte zostawiają komentarz z powodem („strona spoza listy”, „brak danych”, „już wyrenderowany dla zamówienia”). Gdy agencja pyta, czy piksel na pewno jest na stronie, odpowiedź jest w źródle strony.

html
<!-- icc #13: dataLayer: widok produktu (head) -->
<script>
window.dataLayer = window.dataLayer || [];
dataLayer.push({ event: 'view_item', ... });
</script>

Kody przez czat AI

Jeśli sklep korzysta z serwera MCP dla PrestaShop, czat AI może przejrzeć listę kodów, sprawdzić podgląd i zaproponować nowy kod albo poprawkę. Zmiana trafia do panelu jako propozycja i wchodzi na stronę dopiero po akceptacji pracownika.

Wymagania

  • PrestaShop 8.1 lub nowszy, PHP 8.1+.
  • Działa z każdym motywem, który wywołuje standardowe hooki (displayHeader, displayAfterBodyOpeningTag, displayBeforeBodyClosingTag, displayOrderConfirmation).
  • Moduł nie dokłada własnego JS ani CSS na froncie. Na stronę trafia tylko to, co wpiszesz.

Najczęstsze pytania

Czy potrzebuję Google Tag Managera?

Nie. Moduł wstawia dowolny kod: GTM, bezpośrednio gtag.js, piksel Meta czy TikToka, skrypt czatu albo zwykły HTML. GTM jest wygodny, gdy tagów jest dużo, ale nie jest wymagany.

Czy moduł spowalnia sklep?

Moduł nie dokłada własnego JavaScriptu ani CSS na froncie i pobiera kody z bazy jednym zapytaniem na stronę. O szybkości decydują wstawione skrypty, dlatego warto ograniczać je do stron, na których są potrzebne.

Czy kody przetrwają aktualizację PrestaShop albo zmianę motywu?

Tak. Kody są zapisane w bazie modułu, nie w plikach motywu. Nowy motyw musi tylko wywoływać standardowe hooki, co robi każdy motyw zgodny z PrestaShop 8.

Jak sprawdzić, czy kod jest na stronie?

Podgląd w panelu pokazuje wynik dla wybranego produktu, kategorii albo zamówienia. Na żywej stronie tryb debug zostawia w źródle komentarz przy każdym kodzie, a przy kodzie pominiętym podaje powód. Samo zdarzenie w GTM sprawdzisz dalej w trybie podglądu Tag Assistant.

Jak uniknąć podwójnych konwersji?

Kod konwersji ustaw w miejscu „potwierdzenie zamówienia” z włączoną opcją „raz na zamówienie”, a w samym zdarzeniu przekaż transaction_id (GA4) albo event_id (Meta) z referencją zamówienia.

Demo i pełna wersja

Wersję demo możesz pobrać z GitHuba: github.com/infinitywebpl/infinitycustomcodes. Zainstaluj ją na sklepie testowym i poklikaj, żeby zobaczyć, jak wygląda praca z modułem. Kody zapisane w demie zostają po przejściu na pełną wersję.

Pełną wersję instaluję i konfiguruję w Twoim sklepie: przenoszę kody, które dziś siedzą w szablonach, ustawiam dataLayer i konwersje i sprawdzam, czy dane dochodzą do GTM i systemów reklamowych. Napisz, czego potrzebujesz. Pozostałe moduły znajdziesz na stronie moduły PrestaShop.