Błędy w feedzie produktowym - jak je wykryć i naprawić automatycznie

Jak zbudować walidację feedu przed wysyłką

Walidacja feedu to zestaw testów uruchamianych w generatorze po zebraniu danych, a przed zapisaniem pliku pod publicznym adresem. Jej zadaniem jest zatrzymać zły plik, zanim zrobi szkody, i dać zespołowi listę produktów do poprawy. Dobrze ułożona walidacja działa na trzech poziomach: pojedynczego produktu, całego pliku i porównania z poprzednim przebiegiem.

[#chart:wpr35b]

Testy na poziomie produktu sprawdzają, czy są wszystkie wymagane pola, czy cena jest liczbą większą od zera, czy link prowadzi do domeny sklepu, czy GTIN ma poprawną sumę kontrolną i czy tytuł mieści się w limicie. Produkty, które nie przechodzą testów, generator pomija albo poprawia według reguł i zapisuje w raporcie. Testy na poziomie pliku sprawdzają poprawność XML lub CSV, kodowanie i unikalność identyfikatorów.

Porównanie z poprzednim przebiegiem to najprostsza i najskuteczniejsza ochrona przed awarią. Jeśli liczba produktów spadła o kilkadziesiąt procent, średnia cena zmieniła się wielokrotnie albo nagle połowa produktów ma stan zero, to prawie zawsze błąd w danych lub w zapytaniu, a nie realna zmiana oferty. Generator powinien wtedy zostawić poprzedni plik bez zmian i wysłać alert.

Przykład: walidacja GTIN w skrypcie

GTIN ma cyfrę kontrolną liczoną według algorytmu GS1, więc jego poprawność można sprawdzić bez zewnętrznych usług. Krótka funkcja w JavaScript: function gtinOk(g) { if (!/^(\d{8}|\d{12,14})$/.test(g)) return false; const d = g.split('').map(Number); const check = d.pop(); const sum = d.reverse().reduce((s, n, i) => s + n * (i % 2 === 0 ? 3 : 1), 0); return (10 - sum % 10) % 10 === check; }. Produkt z błędnym GTIN lepiej wysłać bez tego pola, z marką i MPN, niż z numerem, który platforma uzna za nieprawidłowy.

Jakie poprawki da się zautomatyzować

Większość błędów technicznych to powtarzalne problemy z formatem, które można poprawić regułą raz na zawsze. Typowy zestaw reguł w generatorze feedu wygląda tak:

1. Normalizacja ceny - zamiana przecinka na kropkę, dwa miejsca po przecinku i kod waluty, np. 49.90 PLN dla Google i Meta, a dla Ceneo sama liczba z kropką.

2. Czyszczenie opisów - usunięcie tagów HTML tam, gdzie platforma wymaga zwykłego tekstu, zamiana encji i usunięcie wielokrotnych spacji.

3. Przycinanie tytułów - do limitu platformy, na granicy słowa, z najważniejszymi informacjami na początku.

4. Mapowanie dostępności - stan magazynowy zamieniony na wartości wymagane przez kanał, np. in_stock dla Google, in stock dla Meta, czas wysyłki dla Ceneo.

5. Uzupełnianie marki - z kartoteki producentów albo z przypisania kategorii, gdy pole w produkcie jest puste.

6. Rozbijanie wariantów - każdy wariant jako osobny produkt z własnym id i wspólnym identyfikatorem grupy.

7. Wykluczenia - pominięcie produktów bez zdjęcia, z ceną zero albo oznaczonych w sklepie jako niereklamowane.

Reguły warto trzymać w jednym miejscu i opisać, co dokładnie robią. Gdy po pół roku ktoś zapyta, dlaczego produkt nie trafia do Google, odpowiedź powinna być w raporcie generatora, a nie w pamięci programisty, który pisał regułę. Dobrze sprawdza się prosta tabela: nazwa reguły, kanał, którego dotyczy, opis działania i data wprowadzenia.

Czego automatyczna naprawa feedu nie załatwi

Nie każdy błąd da się naprawić skryptem. Część problemów wymaga decyzji człowieka albo zmian poza feedem:

• naruszenia zasad reklamowych - produkty z ograniczeniami lub treści niezgodne z zasadami platformy wymagają zmiany oferty lub opisu,

• braki w danych źródłowych - jeśli producent nie podał EAN, a produkt go ma, trzeba go zdobyć i uzupełnić w sklepie,

• zdjęcia - skrypt wykryje za małe zdjęcie, ale nowego nie zrobi,

• ustawienia konta - zasady zwrotów, wysyłki, weryfikacja domeny i dane firmy ustawia się w panelach platform,

• błędy na stronie sklepu - jeśli strona pokazuje inną cenę niż koszyk, problem leży w sklepie, nie w feedzie.

Szczególnie trudne są rozbieżności cen, gdy ceny zmieniają się w kilku kanałach naraz albo zależą od reguł promocyjnych. Wtedy feed musi korzystać z tego samego źródła cen co strona, a promocje powinny trafiać do feedu jako sale_price z datami obowiązywania. Jak uporządkować ceny w wielu kanałach, piszemy we wpisie synchronizacja cen w wielu kanałach sprzedaży.

Monitoring feedu - jak szybko wykrywać nowe błędy

Walidacja przed wysyłką łapie problemy z danymi, ale nie wszystkie. Platformy mogą zmienić wymagania, zablokować pojedyncze produkty po sprawdzeniu strony albo odrzucić plik z powodów, których generator nie widzi. Dlatego drugi element to monitoring po wysyłce, czyli regularne sprawdzanie, ile produktów faktycznie zostało zaakceptowanych.

Najprostszy monitoring to codzienny raport z liczbą produktów w feedzie, liczbą zaakceptowanych i odrzuconych w każdej platformie oraz listą nowych typów błędów. Przy większej skali dane o statusach produktów pobiera się programowo, np. przez Merchant API w Google, i porównuje z poprzednim dniem. Alert powinien przychodzić wtedy, gdy odsetek odrzuconych wyraźnie rośnie albo pojawia się nowy typ problemu, a nie przy każdym pojedynczym ostrzeżeniu.

Warto też monitorować sam adres pliku. Zmiana certyfikatu SSL, reguła zapory sieciowej blokująca roboty, przekierowanie po migracji sklepu albo wtyczka bezpieczeństwa, która zaczyna wymagać logowania, potrafią sprawić, że platforma nie może pobrać feedu, choć generator działa poprawnie. Prosty test, który co godzinę pobiera plik z zewnątrz, sprawdza kod odpowiedzi, rozmiar i datę ostatniej modyfikacji, wykrywa takie sytuacje szybciej niż komunikat w panelu platformy. To kilka linijek kodu, które oszczędzają dni szukania przyczyny spadku wyświetleń.

Przykładowa ścieżka produktów od bazy sklepu do aktywnych reklam pokazuje, gdzie gubią się produkty:

[#chart:wpr35c]

Taki podgląd szybko pokazuje, na którym etapie trzeba działać. Duża strata między bazą a feedem oznacza zbyt ostre wykluczenia albo braki w danych. Duża strata między feedem a produktami zaakceptowanymi to problem z formatem lub zasadami platformy.

[#uwaga] Nie poprawiaj danych ręcznie w panelu platformy, jeśli feed jest pobierany automatycznie. Reguły w Merchant Center czy edycja produktu w katalogu Meta mogą pomóc doraźnie, ale tworzą drugie źródło prawdy, o którym łatwo zapomnieć. Trwała poprawka powinna trafić do danych sklepu albo do reguł generatora.

Od czego zacząć porządkowanie błędów feedu

Jeśli feed ma dziś setki ostrzeżeń w kilku platformach, nie próbuj naprawić wszystkiego naraz. Rozsądna kolejność wygląda tak: najpierw błędy, które blokują cały plik, czyli składnia, kodowanie i dostępność adresu. Potem błędy, które wyłączają najwięcej produktów, zwykle format ceny, brak wymaganych pól i zduplikowane identyfikatory. Dalej rozbieżności cen i dostępności ze stroną, a na końcu ostrzeżenia, które nie blokują wyświetlania, ale pogarszają dopasowanie, np. brak koloru, rozmiaru czy kategorii.

Przy każdej grupie błędów warto zadać to samo pytanie: czy poprawka powinna trafić do danych w sklepie, czy do reguły w generatorze? Jeśli problem dotyczy treści, np. brakującej marki albo złego zdjęcia, lepiej poprawić go u źródła, bo skorzysta na tym także strona sklepu i inne kanały. Jeśli dotyczy formatu wymaganego tylko przez jedną platformę, miejsce poprawki jest w warstwie mapowania tego kanału.

Po wdrożeniu poprawek daj platformom czas na ponowne przetworzenie danych i porównaj raporty z kilku kolejnych dni. Liczba odrzuceń powinna spadać w przewidywalny sposób. Jeśli po poprawce pojawiają się nowe typy błędów, to sygnał, że reguła zmieniła więcej, niż miała, i trzeba ją sprawdzić na próbce produktów. Na koniec dopisz każdą nową regułę do dokumentacji generatora, razem z przyczyną, dla której powstała.

Jak Vinson pomaga naprawić błędy w feedzie produktowym

Programiści Vinson zaczynają od przeglądu diagnostyki w Google Merchant Center, Menedżerze sprzedaży Meta i panelach porównywarek, grupują błędy według przyczyn i ustalają, które da się naprawić regułą, a które wymagają zmian w danych lub na stronie. Potem dodajemy walidację feedu do generatora, skrypty naprawcze, ochronę przed publikacją niepełnego pliku oraz codzienne raporty i alerty. Jako Google Partner i Meta Business Partner łączymy pracę nad danymi z obsługą kampanii. Szczegóły znajdziesz na stronie Wsparcie programistyczne dla e-commerce.

Najczęściej zadawane pytania

Jak sprawdzić błędy w feedzie produktowym?

Po wysyłce błędy widać w diagnostyce Google Merchant Center, Menedżera sprzedaży Meta i paneli porównywarek. Przed wysyłką plik można sprawdzić walidatorem XML lub CSV oraz testami w generatorze: wymagane pola, formaty cen, GTIN i unikalność id. Najlepiej łączyć oba sposoby.

Co to jest walidacja feedu?

Walidacja feedu to zestaw automatycznych testów, które sprawdzają plik produktowy przed publikacją. Obejmuje pojedyncze produkty, cały plik i porównanie z poprzednim przebiegiem. Jej celem jest zatrzymanie błędnego pliku, zanim trafi do platformy reklamowej.

Dlaczego poprawki w Merchant Center znikają?

Jeśli feed jest pobierany według harmonogramu, każde pobranie nadpisuje dane z pliku. Poprawka wprowadzona ręcznie w produkcie znika przy następnej aktualizacji. Trwałe zmiany trzeba wprowadzać w danych sklepu albo w regułach generatora feedu.

Czy błędy w feedzie można naprawiać automatycznie?

Tak, większość błędów technicznych: format ceny, HTML w opisach, długość tytułów, mapowanie dostępności czy nieprawidłowe GTIN. Automatyzacja nie zastąpi jednak uzupełnienia brakujących danych, nowych zdjęć ani zmian wynikających z zasad reklamowych. Te przypadki trafiają do raportu dla zespołu.

Jak często sprawdzać feed produktowy?

Walidacja powinna działać przy każdym generowaniu pliku, a raport ze statusami produktów w platformach najlepiej przeglądać codziennie. Alerty warto ustawić na nagły spadek liczby produktów i wzrost odsetka odrzuceń. Dzięki temu problem wychodzi w ciągu godzin, a nie po spadku sprzedaży.

Błędy w feedzie produktowym kosztują wyświetlenia i sprzedaż, a większość z nich da się wykryć i naprawić automatycznie, zanim zobaczy je Google, Meta czy Ceneo. Jeśli chcesz dodać walidację do swojego feedu albo pozbyć się powtarzających się odrzuceń, sprawdź wsparcie programistyczne Vinson.