Asttero

Jak przygotować dane do migracji sklepu i uniknąć błędów w imporcie?

Shopify Opublikowano 25 czerwca 2026 Zaktualizowano 26 czerwca 2026 8 min
Jak przygotować dane do migracji sklepu i uniknąć błędów w imporcie?

Przeniesienie sklepu e-commerce na nową platformę to proces, którego sukces zależy w dużej mierze od jakości przygotowanej bazy danych. Migracja nie ogranicza się jedynie do eksportu i importu plików, lecz wymaga rzetelnego audytu, czyszczenia oraz mapowania informacji zgodnie z architekturą docelowego systemu. Błędy w strukturze danych mogą prowadzić do paraliżu analityki, problemów z SEO oraz błędów w obsłudze zamówień. Poniższy przewodnik techniczny opisuje, jak przygotować dane do migracji, aby zapewnić ich spójność i zminimalizować ryzyko przestojów operacyjnych.

Dlaczego jakość danych decyduje o sukcesie migracji?

W procesie zmiany platformy e-commerce często obowiązuje zasada 'garbage in, garbage out'. Oznacza to, że wszelkie błędy, duplikaty czy nieaktualne informacje obecne w starym systemie zostaną przeniesione do nowego, jeśli nie zostaną poddane wcześniejszej weryfikacji. Proces przygotowania bazy jest kluczowy, gdy planowana jest migracja do Shopify, szczególnie z systemów o innej strukturze danych, takich jak Magento czy WooCommerce. Niespójne dane produktowe mogą negatywnie wpłynąć na filtrowanie w sklepie, a błędy w rekordach klientów utrudniają personalizację komunikacji marketingowej. Odpowiednie przygotowanie plików pozwala uniknąć kosztownych poprawek ręcznych po uruchomieniu nowej wersji sklepu. Błędne dane rzutują bezpośrednio na raportowanie i analitykę - jeśli identyfikatory produktów lub kategorie zostaną zmapowane niepoprawnie, historyczne porównania sprzedaży staną się niemożliwe do przeprowadzenia bez zaawansowanej obróbki danych. Koszty operacyjne naprawiania błędów po uruchomieniu sklepu, takie jak ręczna edycja tysięcy wariantów czy korygowanie stanów magazynowych, często wielokrotnie przewyższają nakłady na rzetelny audyt przedmigracyjny.

Audyt bazy źródłowej: selekcja danych do przeniesienia

Pierwszym krokiem jest inwentaryzacja posiadanych zasobów. Nie wszystkie dane gromadzone przez lata w starym systemie są warte przeniesienia. Nadmiarowe informacje mogą niepotrzebnie obciążać bazę i wydłużać proces importu. Przed importem zakres danych możliwych do przeniesienia pozwala odpowiednio posegregować pliki i ustalić priorytety. Decyzja o tym, co trafi do nowego systemu, powinna opierać się na analizie przydatności biznesowej i technicznej.

Kryteria selekcji rekordów

Data Cleaning: techniki czyszczenia kodu HTML i usuwania duplikatów

Czyszczenie danych (data cleaning) to najbardziej pracochłonny etap przygotowań. Systemy takie jak WordPress często przechowują w opisach produktów zbędne tagi HTML, style inline oraz klasy CSS, które w nowym szablonie mogą powodować błędy w wyświetlaniu treści. Standaryzacja danych obejmuje także walidację adresów e-mail (usuwanie spacji, sprawdzanie formatu) oraz numerów telefonów, aby były zgodne ze standardem międzynarodowym (np. +48).

Usuwanie zbędnego formatowania z opisów

Podczas eksportu danych z systemów open-source opisy produktów często zawierają fragmenty kodu typu <div style="color: #000;"> lub specyficzne klasy edytorów wizualnych. Przed importem należy oczyścić te teksty, pozostawiając jedynie podstawowe znaczniki semantyczne, takie jak <ul>, <li>, <strong> czy <h2>. W arkuszach kalkulacyjnych można wykorzystać formułę =REGEXREPLACE(A1; "<[^>]*>"; "") do całkowitego usunięcia tagów lub bardziej zaawansowane skrypty zachowujące wybrane znaczniki. Pozwala to uniknąć sytuacji, w której stary layout 'rozbija' nowoczesny, responsywny szablon.

Standaryzacja atrybutów i wariantów

Niespójność w nazewnictwie to częsty problem w dużych bazach. Przykładowo, ten sam kolor może być zapisany jako 'Czerwony', 'czerwony' lub 'RED'. Przed mapowaniem danych należy ujednolicić wszystkie wartości atrybutów. W arkuszach kalkulacyjnych pomocne są funkcje takie jak PROPER() do standaryzacji wielkości liter lub TRIM(), która usuwa zbędne spacje przed i po tekście. Usunięcie duplikatów SKU (Stock Keeping Unit) jest niezbędne, ponieważ system wymaga unikalnych identyfikatorów dla każdego wariantu produktu. Jeśli dwa różne produkty mają to samo SKU, importer zgłosi błąd lub nadpisze dane.

Mapowanie architektury: dopasowanie pól do logiki Shopify

Struktura danych w Shopify różni się od logiki stosowanej w systemach takich jak Magento, gdzie kategorie są drzewiaste. Shopify opiera się na kolekcjach (Collections), które mogą być ręczne lub automatyczne (bazujące na tagach, cenach lub słowach kluczowych). Kluczowym elementem jest zrozumienie roli kolumny 'Handle' oraz sposobu definiowania wariantów produktów.

Logika kolumny Handle i jej wpływ na SEO

Handle to unikalna nazwa produktu, która służy jako identyfikator w bazie oraz element adresu URL (np. domena.pl/products/nazwa-produktu). Każdy produkt musi mieć unikalny Handle. Jeśli produkt posiada wiele wariantów (np. różne rozmiary), wszystkie wiersze odpowiadające tym wariantom w pliku CSV muszą posiadać ten sam Handle. Pozwala to systemowi zgrupować je pod jedną kartą produktu. Przy generowaniu Handle z nazw produktów należy pamiętać o usuwaniu polskich znaków i zastępowaniu spacji myślnikami, aby zachować spójność z dotychczasowym SEO.

Mapowanie wariantów: Option Name i Option Value

W pliku importu warianty definiuje się za pomocą kolumn Option1 Name (np. Rozmiar) i Option1 Value (np. XL). System pozwala na zdefiniowanie do 3 opcji dla jednego produktu (np. Rozmiar, Kolor, Materiał). Ważne jest, aby nazwy opcji były identyczne dla wszystkich produktów w danej kategorii. Przykładowo, używanie zamiennie 'Rozmiar' i 'Wielkość' uniemożliwi poprawne działanie filtrów na listach produktów. Każdy wariant powinien mieć przypisane własne SKU, wagę (Variant Grams) oraz cenę (Variant Price).

Techniczne aspekty plików CSV: kodowanie, separatory i limity

Pliki CSV muszą spełniać rygorystyczne wymogi techniczne. Najważniejszym parametrem jest kodowanie znaków UTF-8. Użycie innego standardu (np. Windows-1250) spowoduje błędy w wyświetlaniu polskich znaków diakrytycznych. Jako separatora pól należy używać przecinka, a wartości zawierające znaki specjalne powinny być ujęte w cudzysłów. Należy również pamiętać o limitach: standardowy importer obsługuje pliki o wielkości do 15 MB. Jeden produkt może posiadać maksymalnie 100 wariantów (chyba że sklep korzysta z planu Shopify Plus i nowych interfejsów API wspierających większą liczbę wariantów). W przypadku dużych baz konieczne jest dzielenie plików na mniejsze paczki lub wykorzystanie zewnętrznych narzędzi do masowego importu.

Zarządzanie multimediami i Metafields

Zdjęcia produktów nie są przesyłane bezpośrednio w pliku CSV. Plik zawiera jedynie publicznie dostępne adresy URL do grafik. Podczas importu system pobiera te pliki, optymalizuje je i zapisuje na własnych serwerach.

Hosting zdjęć podczas migracji

Najbezpieczniejszą metodą jest pozostawienie zdjęć na starym serwerze do czasu zakończenia migracji. Jeśli stary serwer zostanie wyłączony przed importem, grafiki nie zostaną pobrane. Alternatywą jest masowe przesłanie plików do sekcji 'Content -> Files' w panelu administracyjnym i wygenerowanie nowych linków. Należy zadbać o to, aby nazwy plików nie zawierały spacji ani znaków specjalnych, co mogłoby przerwać proces pobierania przez serwery Shopify.

Przygotowanie Metafields

Dane niestandardowe, takie jak składy produktów, instrukcje obsługi czy dodatkowe parametry techniczne, należy mapować na Metafields (metapola). Przed importem należy zdefiniować strukturę metapól w panelu administracyjnym, określając ich typ (np. tekst, liczba, plik). W pliku CSV kolumny dla metapól powinny być przygotowane zgodnie ze schematem namespace.key. Pozwala to na zachowanie specyficznych informacji produktowych, które nie mieszczą się w standardowym opisie.

Import testowy (Dry Run) i rozwiązywanie błędów

Przed finalnym importem na produkcyjną wersję sklepu niezbędne jest przeprowadzenie testu na sklepie deweloperskim (sandbox). Najczęstsze błędy podczas migracji do Shopify wynikają zazwyczaj z drobnych pomyłek w strukturze plików CSV, których można uniknąć dzięki weryfikacji na małej próbce danych (np. 20 produktów o różnej złożoności). Po próbnym imporcie należy sprawdzić, czy ceny promocyjne ('Compare at price') są widoczne, czy stany magazynowe zgadzają się z bazą źródłową oraz czy produkty zostały poprawnie przypisane do kolekcji. Scenariusz testowy powinien obejmować także próbę dodania zaimportowanego produktu do koszyka i przejście do checkoutu, aby upewnić się, że warianty i wagi są poprawnie interpretowane przez systemy wysyłkowe.

Podsumowanie techniczne przygotowania danych

Przygotowanie danych to proces wymagający precyzji i zrozumienia architektury docelowej platformy. Kluczem do sukcesu jest czysta baza, poprawne mapowanie kolumn oraz rygorystyczne przestrzeganie standardów technicznych plików CSV. Prawidłowe przygotowanie danych ułatwia także późniejszą analitykę Shopify w e-commerce, dając czysty obraz sprzedaży od pierwszego dnia i eliminując konieczność ręcznego poprawiania tysięcy rekordów w przyszłości. Systematyczne podejście do audytu i czyszczenia bazy minimalizuje ryzyko przestojów i błędów w obsłudze klienta po starcie nowej platformy.

FAQ

Jakie są najczęstsze przyczyny błędów podczas importu pliku CSV do Shopify?

Najczęstsze problemy to nieprawidłowe kodowanie znaków (brak UTF-8), błędy w strukturze nagłówków, brakujące wartości w kolumnie 'Handle' oraz przekroczenie limitów wielkości pliku lub liczby wariantów produktu.

Czy można zaimportować hasła klientów podczas migracji do Shopify?

Nie, ze względów bezpieczeństwa Shopify nie pozwala na import haseł w formie otwartej ani zaszyfrowanej. Po migracji należy wysłać do klientów zaproszenia do aktywacji kont w nowym systemie.

Jak przygotować zdjęcia produktów do masowego importu?

Zdjęcia muszą być dostępne pod publicznymi adresami URL. W pliku CSV należy umieścić bezpośrednie linki do plików graficznych, które Shopify pobierze i zoptymalizuje podczas procesu importu.

Czym jest 'Handle' w pliku importu Shopify i dlaczego jest ważny?

Handle to unikalny identyfikator produktu, który służy do tworzenia przyjaznych adresów URL oraz łączenia wariantów produktu w jeden rekord w bazie danych.

Jak poradzić sobie z importem danych niestandardowych, których nie ma w domyślnym CSV?

Dane niestandardowe, takie jak specyficzne parametry techniczne, należy mapować na Metafields (metapola). Wymaga to przygotowania odpowiedniej struktury kolumn w arkuszu lub użycia aplikacji wspierających import Metafields.

Jak uniknąć duplikowania produktów podczas ponownego importu?

Shopify identyfikuje produkty po kolumnie 'Handle'. Jeśli podczas importu zaznaczona zostanie opcja nadpisywania istniejących produktów, system zaktualizuje rekordy o tym samym Handle zamiast tworzyć nowe.

Bibliografia