Przejdź do treści

Migracja Shopera na Storefront: skrypty, tagi i adresy

Co spisać przed przełączeniem z RWD na Storefront, żeby niczego nie zgubić. Po przejściu sklepu na nowy szablon wygląd zwykle się zgadza, a problemy wychodzą później: w analityce brakuje części danych, nie pojawia się okno newslettera, a stare wpisy z Google prowadzą na stronę główną. Opisujemy, co sprawdzić przed przełączeniem, pierwszego dnia i w kolejnych tygodniach, na przykładzie sklepu, który przenosiliśmy we wrześniu 2026.

Wzór spisu przed przełączeniem

inwentarz · RWD → Storefrontwzór
Co spisaćKto uruchamiaCo sprawdza po przełączeniu
skrypty i tagiintegracja platformy, aplikacja albo własny kodte same zapytania na nowej stronie
zdarzenia zakupuplatforma; usługa z własnego kodu dopiero po skopiowaniu zdarzeńzdarzenia po przejściach linkiem i „wstecz”, bez dubli
aplikacjepanel sklepudziała albo świadomie jej nie przenosimy
stare adresypanel albo zasób przekierowań w API301 do strony zastępczej, 404 lub 410 bez zamiennika
Listę skryptów robimy z ruchu sieciowego żywej strony, nie z listy w panelu. Pełna tabela: sekcja 01.
01

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ć przed migracją Shopera z RWD na Storefront, kto to uruchamia i jak sprawdzić po przełączeniu
Co spisaćKto uruchamiaSkąd wziąć listęDowód działania po przełączeniu
Skrypty i tagiintegracja platformy, aplikacja czy własny kodruch sieciowy żywej strony i kod starego szablonute 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ówieniuzdarzenia po przejściach linkiem i „wstecz”, bez dubli
Aplikacje i integracjepanel sklepupanel sklepu i znaczniki w HTML stronyczy każda działa albo świadomie jej nie przenosimy

Lista kontrolna: przed przełączeniem, pierwszego dnia i później

  1. 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.
  2. 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.
  3. 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.
Najważniejsze kontrole warto zrobić przed przełączeniem i pierwszego dnia, a nie po kilku tygodniach.

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.

02

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.

żywa strona a kod starego szablonu · trzy tygodnie po przełączeniu
Element z RWDNa Storefroncie
dwie konfiguracje GA4nie ładowały się; przywrócone 29.09
mapa ciepłanie ładowała się; przywrócona 29.09
okno zapisu do newsletteranie ładowało się; przywrócone 29.09
wtyczka kasynie 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ń.

03

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.

Spis z kodu starego szablonu
  • jeden widżet opisany nazwą innego narzędzia i przez to pominięty
  • nic nie sygnalizuje, że część kodu została w RWD
Spis z ruchu sieciowego żywej strony
  • każde zapytanie do narzędzia zewnętrznego ma odpowiednik po migracji
  • albo świadomą decyzję, że go nie przenosimy
04

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.

Test przed przełączeniem
  • 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.
Test po przełączeniu
  • 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.
05

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

  1. Inicjalizacja przy każdym przejściuturbo:loadlogika modułu w funkcji uruchamianej od razu i przy każdym przejściu (zdarzenie turbo:load)
  2. Znacznik „już uruchomione”bez dublitrzymany jako właściwość elementu – w tym szablonie elementy po przejściu były nowe, a nasłuchy na całym oknie rejestrowane raz
  3. Odsłona przy przejściuanalitykawysyłana tam, gdzie platforma jej nie wysyłała; to samo zdarzenie powtórzone w krótkim odstępie odrzucane
  4. Link, potem „wstecz”testkliknię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.

06

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
Stare adresy, robots.txt i mapa witryny: skąd wziąć listę i jak sprawdzić po przełączeniu
Co spisaćSkąd wziąć listęJak sprawdzić po przełączeniu
Stare adresySearch Console (zakres dat sprzed migracji), mapa witryny i skan starego sklepu, dane o wejściach i linkach301 tam, gdzie jest strona zastępcza; 404 lub 410 tam, gdzie treść usunięto bez zamiennika
robots.txt i mapa witrynyustawienia SEO w panelu i Search ConsoleGoogle pobiera skrypty Storefrontu, mapa jest zgłoszona
robots.txt · w opisywanym sklepie
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, a Disallow: /libraries/ – biblioteki. Pomogły wyjątki Allow dla 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/.
07

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.

FAQ: migracja na Storefront

W sklepie, który przenosiliśmy, były dwie przyczyny. Tagi wpięte w kod starego szablonu RWD po aktywacji Storefrontu przestały się ładować. Dodatkowa usługa GA4 wpięta własnym kodem dostawała same odsłony, bo platforma wysyłała zdarzenia zakupu tylko do usług ze swoich integracji – dopóki nie skopiowaliśmy do niej zdarzeń. W innym sklepie warto sprawdzić obie rzeczy na żywej stronie.
Z kilku źródeł: raportu skuteczności w Search Console (filtr stron i stały zakres dat sprzed migracji), mapy witryny starego sklepu, skanu starego sklepu przed przełączeniem oraz danych o wejściach i linkach zewnętrznych. Adres, który ma odpowiednią stronę zastępczą, dostaje przekierowanie 301 na tę stronę; treść usunięta bez sensownego zamiennika – odpowiedź 404 albo 410, a nie przekierowanie na stronę główną.
W sklepie, który przenosiliśmy, Storefront przechodził między podstronami bez przeładowania okna, a skrypty modułów szablonu uruchamiały się raz na wizytę. Inicjalizacja modułu musi działać przy każdym przejściu i przy powrocie z historii, bez dublowania nasłuchów. W tym sklepie zadziałało uruchamianie logiki także na zdarzenie turbo:load.
Może. W sklepie, który przenosiliśmy, reguła Disallow: /application/ obejmowała też katalog /application/assets/, z którego Storefront ładuje główny skrypt, a Disallow: /libraries/ blokowała biblioteki. Pomogły wyjątki Allow dla obu katalogów, dopisane w ustawieniach SEO panelu.

Przechodzisz na Storefront? Przeniesiemy sklep razem z analityką, tagami i adresami

Zaczynamy od spisu tego, co działa dziś, budujemy szablon obok działającego sklepu i przełączamy dopiero po teście zakupu, zgód i analityki. Po przełączeniu pilnujemy przekierowań i indeksowania, żeby sklep nie stracił pomiaru ani ruchu z Google.

Podobna realizacjaStorefront z 13 własnymi modułami, Lighthouse 58 → 79⁠–⁠80CMP Polska · Shoper