Lista skryptów, tagów i adresów
Spisz wszystkie skrypty i tagi, które ładuje żywa strona – z ruchu sieciowego, nie z listy w panelu – i przy każdym zapisz, kto go wstawia oraz po czym poznasz, że działa po przełączeniu.
| Co spisać | Kto uruchamia | Skąd wziąć listę | Dowód działania po przełączeniu |
|---|---|---|---|
| Skrypty i tagi | integracja platformy, aplikacja czy własny kod | ruch sieciowy żywej strony i kod starego szablonu | te same zapytania na nowej stronie, odsłony w czasie rzeczywistym w GA4 |
| Zdarzenia zakupu i usługi analityki, do których trafiają | platforma – do usług ze swoich integracji; usługa wpięta własnym kodem dostaje je dopiero po skopiowaniu zdarzeń | dataLayer na karcie produktu, w koszyku i po zamówieniu | zdarzenia po przejściach linkiem i „wstecz”, bez dubli |
| Aplikacje i integracje | panel sklepu | panel sklepu i znaczniki w HTML strony | czy każda działa albo świadomie jej nie przenosimy |
Lista kontrolna: przed przełączeniem, pierwszego dnia i później
- Przed przełączeniem i pierwszego dniazakup na telefonie i komputerze, zgody na cookies (odrzucenie, akceptacja, zmiana decyzji), tagi i zdarzenia zakupu porównane z listą sprzed migracji, dostęp Google do skryptów Storefrontu (robots.txt), kluczowe adresy z listy – przekierowanie albo 404/410 zgodnie z planem.
- Pierwszy tydzieńte same kontrole powtórzone na danych z analityki i na różnych ścieżkach: wejście z wyszukiwarki, przejścia bez przeładowania, powrót z historii, zakup z kodem rabatowym.
- Kolejne tygodnieindeksowanie i raport błędów w Search Console, ruch na starych adresach, nowe 404 oraz zgodność liczby zakupów w analityce z zamówieniami w panelu.
Zestaw 1 z 2 Skrypty, tagi i zdarzenia
W sklepie, który przenosiliśmy, kod wpięty w szablon RWD po aktywacji Storefrontu przestał się ładować, a Storefront przechodził między podstronami bez przeładowania, więc skrypty modułów i analityka zachowywały się inaczej niż w RWD.
Objaw: „coś przestało działać od migracji”
W sklepie, który przenosiliśmy na Storefront 06–08.09.2026, trzy tygodnie po przełączeniu porównaliśmy żywą stronę z kodem starego szablonu i znaleźliśmy braki: nie ładowały się dwie konfiguracje GA4, mapa ciepła i okno zapisu do newslettera. Wszystkie trzy przywróciliśmy 29.09.2026 we właściwych miejscach Storefrontu. Jedna wtyczka kasy z RWD nie przeszła celowo, bo na Storefroncie była zbędna.
| Element z RWD | Na Storefroncie |
|---|---|
| dwie konfiguracje GA4 | nie ładowały się; przywrócone 29.09 |
| mapa ciepła | nie ładowała się; przywrócona 29.09 |
| okno zapisu do newslettera | nie ładowało się; przywrócone 29.09 |
| wtyczka kasy | nie przeszła celowo: na Storefroncie zbędna |
Takie braki nie psują wyglądu, więc przy odbiorze łatwo ich nie zauważyć. Dlatego lista kontrolna z sekcji 1 przenosi ich kontrolę przed przełączenie i na pierwszy dzień.
Dlaczego skrypty nie przechodzą same
W opisywanym sklepie kod wklejony w nagłówek, stopkę i moduły szablonu RWD po aktywacji Storefrontu przestał się ładować – Storefront ma własne miejsca na kod. Nic nie zasygnalizowało, że część kodu została w starym szablonie.
Spis zrobiony z kodu starego szablonu też bywa zawodny. W naszym przypadku jeden widżet był w spisie opisany nazwą innego narzędzia i przez to go pominięto. Dlatego listę kontrolną robimy z ruchu sieciowego żywej strony: każde zapytanie do narzędzia zewnętrznego musi mieć odpowiednik po migracji albo świadomą decyzję, że go nie przenosimy.
- jeden widżet opisany nazwą innego narzędzia i przez to pominięty
- nic nie sygnalizuje, że część kodu została w RWD
- każde zapytanie do narzędzia zewnętrznego ma odpowiednik po migracji
- albo świadomą decyzję, że go nie przenosimy
Kto wstawia który tag
Na jednej stronie sklepu tagi mogą pochodzić z trzech źródeł: z integracji platformy (np. GA4 i reklamy ustawione w panelu), z aplikacji z panelu i z własnego kodu w szablonie. W opisywanym sklepie po migracji działało tylko to, co było ustawione w panelu, a i tu jedna z usług GA4 wpisana w panelu ładowała się na stronie tylko z naszego kodu. Warto więc sprawdzić każdą aktywną integrację na żywej stronie, a nie w panelu.
Druga sprawa to zdarzenia sklepu. W tym sklepie platforma wysyłała zdarzenia zakupu do usług ze swoich integracji, a dodatkowa usługa GA4 wpięta własnym kodem dostawała same odsłony – bez dodań do koszyka i zakupów – dopóki nie skopiowaliśmy do niej zdarzeń. Przed migracją warto więc spisać nie tylko tagi, ale też to, które usługi dostają które zdarzenia.
- Z ruchu sieciowego żywej strony spisz każde zapytanie do narzędzia zewnętrznego, przy nim źródło tagu (integracja platformy, aplikacja, własny kod) i usługi, które dostają zdarzenia zakupu.
- Każde zapytanie z listy ma odpowiednik na nowej stronie albo świadomą decyzję, że go nie przenosimy; zdarzenia przychodzą po przejściach linkiem i „wstecz”, bez dubli – sprawdzone na żywej stronie, a nie w panelu.
Przejścia bez przeładowania strony
W opisywanym sklepie Storefront przełączał podstrony bez przeładowania okna (Hotwire Turbo): pobierał nową treść i podmieniał ją na miejscu, a skrypty modułów szablonu uruchamiały się raz na wizytę. Po powrocie z karty produktu karuzela stała, a dwa moduły były pustymi miejscami. W analityce odsłona przy takim przejściu nie docierała do jednej z usług, a zdarzenie obejrzenia produktu przychodziło dwa razy.
Cel jest jeden: inicjalizacja modułu musi działać przy każdym przejściu i przy powrocie z historii, nie dublować nasłuchów i poprawnie odtwarzać działanie modułu. Metod jest kilka; w tym sklepie zadziałało rozwiązanie poniżej.
Rozwiązanie, które zadziałało w tym sklepie
- Inicjalizacja przy każdym przejściulogika modułu w funkcji uruchamianej od razu i przy każdym przejściu (zdarzenie
turbo:load) - Znacznik „już uruchomione”trzymany jako właściwość elementu – w tym szablonie elementy po przejściu były nowe, a nasłuchy na całym oknie rejestrowane raz
- Odsłona przy przejściuwysyłana tam, gdzie platforma jej nie wysyłała; to samo zdarzenie powtórzone w krótkim odstępie odrzucane
- Link, potem „wstecz”kliknięcie linku na stronie, potem „wstecz”, i sprawdzenie modułów oraz zdarzeń
Zestaw 2 z 2 Stare adresy i indeksowanie
Stare adresy trzeba obsłużyć samemu: przekierowaniem tam, gdzie jest strona zastępcza, i odpowiedzią 404 lub 410 tam, gdzie treści już nie ma.
Stare adresy, robots.txt i mapa witryny
W opisywanym sklepie Shoper sam przekierowywał stare adresy kategorii i wpisów, jeśli w adresie był identyfikator, który nadal istniał. Stare wpisy bez odpowiednika kończyły się przekierowaniem tymczasowym na stronę główną i traciły ruch z Google.
Adres, który ma odpowiednią stronę zastępczą, powinien dostać przekierowanie 301 na tę stronę – w panelu albo przez zasób przekierowań w API – i to przed zmianą adresów. Jeśli treść usunięto i nie ma sensownego zamiennika, lepsza jest odpowiedź 404 albo 410 niż przekierowanie na stronę główną lub przypadkową podstronę. W tym sklepie kilka takich adresów celowo zostawiliśmy z odpowiedzią 404.
Listę starych adresów zbierz z kilku źródeł: raportu skuteczności w Search Console (filtr stron i stały zakres dat sprzed migracji – bez niego raport pokazuje ostatnie miesiące), mapy witryny starego sklepu, skanu starego sklepu przed przełączeniem oraz danych o wejściach i linkach zewnętrznych. Adres, który trzeba zachować, nie musi wystąpić w raporcie skuteczności.
Stare adresy i robots.txt w tabeli
skąd wziąć listę i jak sprawdzić po przełączeniu
| Co spisać | Skąd wziąć listę | Jak sprawdzić po przełączeniu |
|---|---|---|
| Stare adresy | Search Console (zakres dat sprzed migracji), mapa witryny i skan starego sklepu, dane o wejściach i linkach | 301 tam, gdzie jest strona zastępcza; 404 lub 410 tam, gdzie treść usunięto bez zamiennika |
| robots.txt i mapa witryny | ustawienia SEO w panelu i Search Console | Google pobiera skrypty Storefrontu, mapa jest zgłoszona |
Disallow: /application/blokowało też /application/assets/ z głównym skryptem StorefrontuDisallow: /libraries/bibliotekiAllow: /application/assets/wyjątek dopisany w ustawieniach SEO paneluAllow: /libraries/- robots.txt: w opisywanym sklepie reguła
Disallow: /application/blokowała też katalog/application/assets/, z którego Storefront ładuje główny skrypt, aDisallow: /libraries/– biblioteki. Pomogły wyjątkiAllowdla obu katalogów, dopisane w ustawieniach SEO panelu. - Mapa witryny: Shoper udostępnia ją pod adresem
/console/integration/execute/name/GoogleSitemap, a nie/sitemap.xml. Warto sprawdzić, czy jest zgłoszona w Search Console. - Linki wpisane na sztywno: w karuzelach i banerach zostają adresy w starym formacie; w opisywanym sklepie linki
/pl_PL/c/zamieniliśmy na/pl/.
Kiedy poradzisz sobie sam, a kiedy z kimś
Sam
Mały sklep z tagami ustawionymi w integracjach panelu, bez własnego kodu w szablonie i bez starych wpisów z ruchem. Wtedy wystarczy próba zakupu, test zgód i kontrola GA4 oraz Search Console.
Z kimś, kto to robił
Sklep z własnym kodem w szablonie, kilkoma usługami analityki, aplikacjami, blogiem z ruchem z Google i modułami, które muszą działać przy przejściach bez przeładowania.
Jak prowadzimy taką migrację – od spisu, przez szablon obok działającego sklepu, po pierwsze tygodnie po przełączeniu – opisujemy na stronie migracji Shopera z RWD na Storefront. Cały zakres prac w sklepie, o którym mowa w tym poradniku, opisuje realizacja CMP Polska.