Shopify ogranicza zdjęcia produktów do 20 MB i 20 megapikseli; aplikacja automatycznie zmniejsza większe zdjęcia. Większość problemów z dopasowaniem wynika z powtarzających się identyfikatorów, pustych identyfikatorów lub drobnych błędów w nazwach, a wszystkie widać w podglądzie przed przesłaniem.
Limity
| Limit | Wartość | Co robi aplikacja |
|---|---|---|
| Rozmiar pliku | 20 MB (Shopify) | Zmniejsza i ponownie koduje jpg, jpeg, png, webp, gif. Zgłasza jasny błąd tylko wtedy, gdy plik nadal się nie mieści. |
| Rozdzielczość | 20 megapikseli (Shopify) | Zmniejsza do około 18 MP i próbuje ponownie. |
| Zdjęcia na produkt | 250 (Shopify) | Własny limit Shopify |
| Darmowy plan | Łącznie 25 zdjęć | Zadanie zatrzymuje się z komunikatem „Free upload limit reached”. |
| Tabele podglądu | Po 5000 widocznych wierszy | Liczniki i eksport CSV obejmują wszystko. |
| Wyniki dopasowania | Przechowywane 2 godziny | Dopasuj ponownie, jeśli czekasz dłużej. |
| Limit szybkości plików w Shopify | Dla całego sklepu | Automatyczne wstrzymanie (3 s → 6 s → 12 s) i ponowienie. |
Zdjęcia przekraczające limity są wymienione w ostrzeżeniu na stronie podglądu przed przesłaniem.
Zalecane parametry: JPG lub WEBP, od 2048 do 4096 px na dłuższym boku, sRGB, poniżej 5 MB.
Jak długo trwa duże przesyłanie
Shopify ogranicza tempo zmian plików w sklepie, dla całego sklepu. Aplikacja pobiera i przesyła równolegle, a po osiągnięciu limitu automatycznie zwalnia, więc duże zadania postępują równomiernie, a nie szybko. Przy dziesiątkach tysięcy zdjęć licz się z godzinami, nie minutami. Postęp jest zapisywany dla każdego zdjęcia, więc po restarcie praca wznawia się tam, gdzie się zatrzymała.
Problemy z dopasowaniem
| Objaw | Prawdopodobna przyczyna | Rozwiązanie |
|---|---|---|
| Żadne zdjęcie nie zostało dopasowane | Zły typ dopasowania lub folder albo pusty identyfikator w wariantach | Porównaj kolumnę Expected SKU z danymi produktów |
| Część zdjęć niedopasowana | Literówki, spacje na końcu, brak rozszerzenia, przyrostek niebędący liczbą | Wyeksportuj CSV niedopasowanych zdjęć i porównaj z eksportem produktów |
| Zdjęcie trafiło do złego wariantu | Powtarzające się identyfikatory lub opcja „zawiera” trafiająca na krótszy kod | Przejdź na opcję dokładną lub nadaj unikalne kody |
| Mniej dopasowań przy powtarzających się SKU | Zostaje tylko pierwszy wariant z danym identyfikatorem | Poproś o dopasowanie do wielu wariantów lub nadaj unikalne identyfikatory |
| Dopasowanie po tytule zawodzi przy znakach diakrytycznych | Znaki są inaczej kodowane w nazwach plików (macOS) i w Shopify | Poproś o normalizację Unicode lub dopasuj po SKU |
| Edytowane produkty nadal pasują do starych wartości | Katalog jest w pamięci podręcznej | Kliknij Wyczyść cache |
| Nowe zdjęcia się nie pojawiają | Lista folderu jest w pamięci podręcznej | Kliknij Dopasuj ponownie lub odśwież wybór folderu |
| Dopasowanie przekracza limit czasu | Bardzo duży katalog i folder | Poproś o filtr kolekcji lub podziel folder |
Komunikaty przesyłania
| Komunikat | Znaczenie | Co zrobić |
|---|---|---|
Image size is larger than 20MB / 20 megapixels | Nie udało się zmniejszyć poniżej limitu | Wyeksportuj mniejsze zdjęcie |
hit the Shopify file rate limit; retrying in Ns | Zwykłe ograniczenie Shopify | Nic. Aplikacja ponowi próbę |
Your shop reached Shopify API rate limit | Inna aplikacja lub zadanie korzysta z API | Nie uruchamiaj dwóch dużych zadań jednocześnie |
Free upload limit reached | Wykorzystano 25 darmowych zdjęć | Przejdź na wyższy plan |
This folder already in process | Zadanie dla tego folderu wciąż trwa | Poczekaj lub je zatrzymaj |
product has only default variant… | Zdjęcie trafiło do produktu, a nie do wariantu | Oczekiwane działanie |
Zadanie kończy się statusem finished with errors | Część zdjęć się nie udała | Przeczytaj wiersze błędów. Nieudane zdjęcia są ponawiane automatycznie |
Lista kontrolna do testu pilotażowego
- Produkt z jednym zdjęciem dostaje jedno zdjęcie, ustawione jako zdjęcie wariantu.
- Produkt z kilkoma zdjęciami dostaje je w kolejności
_0/_1/_2. - Każdy wariant produktu wielowariantowego pokazuje własne zdjęcie.
- Tekst alternatywny w Shopify zgadza się z podglądem.
- Celowo błędna nazwa pliku pojawia się wśród niedopasowanych zdjęć i w CSV.
- Tryb zastępowania na produkcie testowym zostawia dokładnie nowy zestaw zdjęć.
Jak uzyskać pomoc
Skontaktuj się z nami, podając domenę sklepu, nazwę folderu, typ dopasowania, przybliżony czas uruchomienia oraz dwie lub trzy przykładowe nazwy plików z SKU lub kodem kreskowym, do którego powinny pasować. Możemy zarejestrować pełny ślad dopasowania i powiedzieć dokładnie, dlaczego zdjęcie zostało dopasowane właśnie tak.