Generator feedu produktowego

Generator feedu produktowego

Feed produktowy to plik XML, który sklepy przekazują do Google Merchant Center i katalogów social commerce, takich jak katalog Meta (Facebook, Instagram). Bez niego produkty nie pojawią się w zakładce Shopping. Generator zamienia listę produktów wklejoną z arkusza na feed w formacie RSS 2.0 z przestrzenią nazw g: i od razu sprawdza każdy wiersz.

Wymagane pola

Każdy produkt wpisujesz w osobnej linii, z polami w stałej kolejności: id; tytuł; opis; cena; waluta; dostępność; link; obraz; marka; gtin; stan. Pierwsze siedem jest obowiązkowe, bez nich wiersz zostanie pominięty. Google wymaga też zdjęcia, więc w praktyce potrzebujesz ośmiu.

Dodatkowe pola

• g:gtin — kod EAN/GTIN zwiększa dopasowanie; generator sprawdza długość (8, 12, 13 lub 14 cyfr) i cyfrę kontrolną,
• g:brand — marka produktu,
• g:condition — new, refurbished, used; puste pole oznacza new, a cały znacznik wyłączysz przełącznikiem „Dodaj stan produktu”.

Generator nie dodaje g:google_product_category ani atrybutów wariantów i wysyłki. Jeśli ich potrzebujesz, dopisz je w regułach źródła danych w Merchant Center albo bezpośrednio w pliku.

Jak wdrożyć

Pobierz plik feed.xml (albo skopiuj XML), opublikuj go pod stałym adresem URL, np. https://twojsklep.pl/feed.xml, i dodaj go w Merchant Center jako źródło danych. W Menedżerze sprzedaży Meta robisz to samo: źródło danych z adresem pliku i harmonogramem pobierania. Google pobiera plik regularnie — aktualizuj ceny i stany na bieżąco.

Jak działa generator feedu produktowego

Generator zamienia listę produktów na plik XML w strukturze, którą przyjmuje Google Merchant Center. Każdy produkt staje się osobnym elementem <item>, a jego cechy trafiają do znaczników z przedrostkiem g: — g:id, g:title, g:description, g:link, g:image_link, g:price, g:availability. Nad listą pozycji znajduje się nagłówek kanału z tytułem, adresem sklepu i opisem wpisanymi nad listą produktów, a w znaczniku <rss> zadeklarowana jest przestrzeń nazw dla tego przedrostka. Sam plik jest zwykłym tekstem w UTF-8, więc można go otworzyć w edytorze, wgrać na serwer i udostępnić pod stałym adresem URL.

Pola oddzielasz średnikiem albo tabulatorem. Kolumny skopiowane z Excela lub Arkuszy Google wklejają się z tabulatorami, a wiersz nagłówka zaczynający się od „id” zostaje pominięty. Pola g:image_link, g:brand, g:gtin i g:condition pojawiają się w pliku tylko wtedy, gdy są dostępne w danych. Dzięki temu feed nie zawiera pustych znaczników, które nie wnoszą żadnej informacji, a tylko zwiększają ryzyko błędu przy walidacji.

Trzecia warstwa to normalizacja zapisu. Znaki specjalne w nazwach i opisach — ampersand, nawiasy ostre, cudzysłowy — generator sam zamienia na encje, bo inaczej parser XML przerwałby czytanie pliku; usuwa też niewidoczne znaki sterujące. Cenę możesz wpisać z przecinkiem i spacją tysięcy (1 299,00), a w pliku trafi jako 1299.00 PLN. Polskie wpisy dostępności i stanu („dostępny”, „niedostępny”, „przedsprzedaż”, „na zamówienie”, „nowy”, „używany”, „odnowiony”) są zamieniane na wartości Google. Puste pole waluty oznacza PLN.

Kontrola wierszy: co jest pomijane, a co dostaje uwagę

Pod feedem narzędzie pokazuje tabelę z wynikiem dla każdego wiersza: OK, Uwaga albo Błąd. Wiersz z błędem nie trafia do pliku. Wiersz z uwagą trafia, ale Google może taki produkt odrzucić, więc popraw go przed wgraniem.

Jednorazowo wygenerujesz do 500 produktów (lista do ok. 300 tys. znaków). Większy katalog podziel na kilka plików i dodaj każdy jako osobne źródło danych.

Przykład: feed z trzema produktami krok po kroku

1. Wklej trzy wiersze:
   P002; Mysz bezprzewodowa; Ergonomiczna mysz; 99,50; PLN; dostępny; https://twojsklep.pl/mysz; https://twojsklep.pl/img/mysz.jpg; TechBrand; 5901234123464; nowy
P003; Etui na laptopa; Etui 14 cali z kieszenią; 79,00 zł; ; brak; twojsklep.pl/etui
P002; Podkładka pod mysz; Podkładka 30 × 25 cm
2. Pierwszy wiersz przechodzi bez uwag. Cena 99,50 trafia do pliku jako 99.50 PLN, „dostępny” jako in_stock, a „nowy” jako new.
3. GTIN 5901234123464 jest poprawny: dwanaście pierwszych cyfr mnożonych na przemian przez 3 i 1, licząc od prawej, daje sumę 86. Do pełnej dziesiątki brakuje 4, a 4 to ostatnia cyfra kodu.
4. Drugi wiersz trafia do feedu z uwagami. Cena „79,00 zł” zostaje odczytana jako 79.00, puste pole waluty daje PLN, a „brak” oznacza out_of_stock. Link bez https:// i brak zdjęcia to dwie uwagi: plik powstanie, ale Google nie zatwierdzi produktu, dopóki nie podasz pełnych adresów.
5. Trzeci wiersz ma 3 pola z wymaganych 7, więc zostanie pominięty. Z kompletem pól też by odpadł, bo id P002 zajął już pierwszy produkt.
6. Kafelki nad wynikiem pokażą: 2 produkty w feedzie, 1 pominięty wiersz, 1 produkt z uwagami i 1 dostępny z 2. Popraw drugi wiersz, uzupełnij trzeci i wygeneruj plik ponownie.
7. Opublikuj plik pod stałym adresem URL i dodaj go w Merchant Center. Kolejna zmiana ceny lub stanu magazynowego wymaga ponownego wygenerowania i wgrania pliku — feed nie aktualizuje się sam.

Praktyczne wskazówki przed publikacją feedu

• Nie zmieniaj identyfikatorów. g:id to klucz, po którym system rozpoznaje produkt. Zmiana wartości przy tej samej ofercie wygląda jak usunięcie starej pozycji i dodanie nowej.
• Pilnuj limitu 150 znaków w nazwie — najważniejsze słowa, czyli model i typ produktu, stawiaj na początku, bo dalsza część bywa obcinana w wynikach.
• Uważaj na średniki w opisach. Każdy średnik tworzy nowe pole i przesuwa cenę, link oraz kolejne kolumny. Jeśli opisy je zawierają, wklej dane prosto z arkusza, z tabulatorami.
• Zostawiaj produkt w feedzie, gdy chwilowo go brakuje — zamiast usuwać wiersz, wpisz „niedostępny” albo out_of_stock. Zachowasz historię oferty i identyfikator.
• Dodaj g:gtin i g:brand, jeśli je masz — kody EAN i marka poprawiają dopasowanie produktu w katalogu, a dla części kategorii są wymagane.

Czego narzędzie nie uwzględnia

• Nie integruje się z systemem sklepu — generuje gotowy plik, nie pobiera danych na bieżąco. Aktualizację cen i stanów trzeba wprowadzić w danych wejściowych i wygenerować feed ponownie.
• Nie przelicza walut — kod waluty jest przepisywany przy cenie tak, jak podałeś. Jeśli sklep sprzedaje w innej walucie, dane trzeba przygotować samodzielnie przed generowaniem.
• Nie sprawdza, czy link i zdjęcie naprawdę działają. Kontroluje tylko, czy adres zaczyna się od http:// lub https:// i jest poprawny składniowo, a taki adres wciąż może zwracać błąd 404.
• Nie obsługuje wariantów (rozmiar, kolor, wspólna grupa produktów) ani kosztów wysyłki: każdy wiersz to osobny produkt.
• Nie gwarantuje zgodności z polityką Merchant Center — tytuły, opisy, zdjęcia i strona produktu muszą spełniać zasady Google. Sam poprawny XML nie wystarczy, żeby produkt został zatwierdzony.