Elbuz tworzy z katalogu feed dla Google Merchant Center — plik XML z tagami zrozumiałymi dla Google — i aktualizuje go pod stałym adresem. Przypisanie swoich pól do tagów Google ustawiasz raz.
Kiedy to się przyda:
- Produkty mają się wyświetlać w Zakupach Google — Merchant Center pobiera plik spod adresu według własnego harmonogramu.
- Google odrzuca dostępność — Twoje statusy same zamieniają się na
in_stock,out_of_stock,preorder. - Potrzebny jest katalog na Facebooku, Instagramie czy TikToku — osobny format na tym samym silniku.
- Katalog nagle „schudł” — reguła stop nie wpuści takiego feedu do Google.
Od czego zacząć: utwórz szablon „Google Merchant (XML)” w oknie „Eksport danych”.
Co potrafi feed Google Merchant
- Gotowe tagi Google —
g:id,g:price,g:availabilityi inne wypełniane makrami Twoich pól. - Zdjęcia i cechy blokami — zdjęcie główne, do dziesięciu dodatkowych i
g:product_detaildla każdej cechy. - Słownik dostępności Google — Twoje statusy same stają się
in_stock,out_of_stocklubpreorder. - Ścieżka kategorii przez „>” — tak, jak wymaga Google dla grup w Google Ads.
- Meta i TikTok — osobne formaty na tym samym silniku.
- Ochrona przed załamaniem — reguła stop zatrzyma feed, w którym zniknęła dostępność.
Jak utworzyć szablon
W oknie „Eksport danych” kliknij przycisk dodawania i wybierz format „Google Merchant (XML)”. Szablon edytuje się ołówkiem w wierszu listy.
1
Przełączniki Zdjęcia, Atrybuty, Opcje2
Blok szablonu XML- Przełączniki Zdjęcia, Atrybuty i Opcje decydują, jakie dane trafią do feedu, niezależnie od tego, czy makro jest w szablonie.
- Szablon XML zawiera treść jednego produktu: tagi marketplace’u (g:title, g:price) wypełnione makrami pól katalogu.
Szablon ma dwie zakładki: „Wybór danych do eksportu” — zawartość pliku, i „Ograniczenie eksportu (filtr)” — warunki zawężające zestaw produktów (gdzie ustawia się wybór). Bloki pierwszej zakładki:
| Blok | Co w nim jest |
|---|---|
| „Co eksportować” | przełączniki „Zdjęcia”, „Atrybuty”, „Opcje” |
| „Szablon XML” | cały plik: nagłówek feedu i treść jednego produktu z makrami Twoich pól |
| „Zdjęcia i plik” | początek linków do zdjęć i nazwa pliku |
| „Ograniczenia eksportu” | sklep, magazyn i język katalogu, pole „Tylko dostępne w tym sklepie”, „Czas przedsprzedaży, dni” (data dostępności) |
Adres strony w g:link i w nagłówku feedu program wstawia sam: z adresu sklepu głównego w słowniku sklepów, w przeciwnym razie z pola „Adres strony WWW” Twojej firmy, a w ostateczności ze strony jedynego tunelu CMS. Jeśli adresu nie znaleziono, w szablonie stoi https://site.com, a formularz szablonu ostrzega o tym adresie zastępczym: zamień go na swój adres w „Szablonie XML” i zapisz.
Domyślna nazwa pliku to export_google_feed.xml. Merchant Center pobiera feed spod stałego adresu, więc nie umieszczaj w nazwie makr daty {DATE}, {DATETIME}, {TIME}.
Co trafia do feedu: tagi Google
Pole „Szablon XML” zawiera cały dokument: deklarację , nagłówek feedu z nazwą i adresem sklepu oraz jeden produkt wewnątrz tagu item. Węzeł produktu program powiela sam; to, który tag powtarzać, ustawiono w ustawieniach zaawansowanych (dla Google to item).
Makr pól nie wpisuje się ręcznie: Ctrl+Space lub znak { otwierają listę pól katalogu. Minimalny zestaw tagów, bez którego Merchant Center nie przyjmie feedu:
| Tag | Co się wstawia |
|---|---|
g:id | wewnętrzne SKU — musi być unikalne i nie zmieniać się między eksportami |
g:title | nazwa produktu |
g:description | opis; zwykle opakowuje się go w CDATA, żeby tagi wewnątrz nie psuły XML |
g:link | link do karty produktu w Twoim sklepie: adres strony plus makro adresu produktu |
g:image_link | zdjęcie główne; makro listy zdjęć wstawia tu pierwsze zdjęcie, a pozostałe — do g:additional_image_link |
g:availability | dostępność, słownikiem Google |
g:availability_date | data dostępności — tylko dla produktów w preorder lub backorder, makro {xml_availability_date} (skąd data) |
g:price | cena z kodem waluty |
g:brand | producent |
g:condition | stan produktu — makro {xml_condition}: „Nowy” → new, „Przeceniony” i „Używany” → used, „Odnowiony” → refurbished (stan produktu) |
W szablonach, w których w g:condition stało na sztywno new, program sam zamienił je na {xml_condition}; nowe szablony powstają już z makrem. Dlatego przeceniony produkt nie trafia już do Google jako nowy: stan ustawia się w karcie produktu, w polu „Stan produktu”.
Trzy makra zbierają całe bloki:
- Lista zdjęć. Pierwsze zdjęcie staje się
g:image_link, pozostałe —g:additional_image_link. Merchant przyjmuje jedno główne i dziesięć dodatkowych, więc od jedenastego zdjęcia nic nie trafia do pliku. - Lista cech. Każda para „nazwa — wartość” staje się blokiem
g:product_detailz zagnieżdżonymig:attribute_nameig:attribute_value. - Opis. Wycinane są z niego znaczniki, których Google nie przyjmuje, a sam opis jest przycinany do pięciu tysięcy znaków. Dla Facebooka znaczniki są wycinane w całości: tam potrzebny jest zwykły tekst.
Tagi wpływające na wyświetlanie i statystykę:
g:sale_price— cena promocyjna. Google pokazuje przekreśloną cenę zwykłą obok promocyjnej.g:gtinig:mpn— kod kreskowy i kod producenta. Google prosi o co najmniej jeden z nich, bez nich część kategorii wyświetla się gorzej.g:product_type— Twoja kategoria pełną ścieżką.g:google_product_category— kategoria ze słownika Google; bierze się ją z dopasowania do marketplace’ów.
W ścieżce kategorii (g:product_type) poziomy są wstawiane przez „>”, a nie przez ukośnik jak w bazie. To wymóg Google: kampanie Google Ads grupują się według tego pola, a inny separator rozsypuje grupy.
W tagach można umieszczać obliczenia: np. brać cenę sugerowaną, gdy jest, a zwykłą, gdy jej nie ma. Składnia — w sekcji cena w eksporcie.
Jak przekazać dostępność słownikiem Google
Google ma własny słownik dostępności i Elbuz wstawia go zamiast Twojego statusu:
| Twój status | Co trafi do feedu |
|---|---|
| oznaczony jako „dostępny” | in_stock |
| oznaczony jako „brak” | out_of_stock |
| „na zamówienie” lub inny | preorder |
Dla TikToka te same wartości zapisywane są wielką literą i ze spacją — „In stock”. Robi to program, w szablonie nic nie trzeba zmieniać.
Przypisanie ustawia się w oknie „Ustawienia aktualizacji według dostępności produktu” — przycisk w bloku „Powiązane ustawienia” na pierwszej zakładce. Jest tam wiersz dla każdego statusu z Twojego słownika statusów dostępności. Nowy szablon dostaje wszystkie wiersze włączone i bez własnego tekstu.
- Wiersz wyłączony — wartość wynika z aktywności produktu: aktywny —
in_stock, nieaktywny —out_of_stock. Dlatego produkt „na zamówienie” może trafić jakoin_stock. - W wierszu wypełniono „Nazwa na stronie (w pliku)” — do feedu trafi właśnie ten tekst, a nie słownik Google.
Data dostępności dla przedsprzedaży. Dla produktu w statusie preorder (lub backorder, jeśli wpisano taki tekst w status dostępności) Google Merchant wymaga tagu g:availability_date, w przeciwnym razie odrzuca produkt. Program wstawia go sam:
- bierze „Data dostępności” z karty produktu, jeśli jest w przyszłości i nie dalej niż za rok;
- w przeciwnym razie — dziś plus „Czas przedsprzedaży, dni” z bloku „Ograniczenia eksportu” szablonu (od 1 do 365, domyślnie 14).
W szablonach bez tego tagu program dopisuje go sam zaraz po g:availability. Produkty „dostępne” i „brak” tagu nie potrzebują, więc program go nie dopisuje. Jeśli jednak sam wpiszesz tag do „Szablonu XML”, datę wstawia do niego makro {xml_availability_date}: dla produktów spoza przedsprzedaży jest ono puste i tag wyjdzie pusty. W feedzie TikToka daty dostępności nie ma.
Google przyjmuje tylko trzy wartości ze słownika. Każdy inny tekst w „Nazwa na stronie (w pliku)” odrzuci — wyczyść to pole dla feedu Google.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Zdjęcia, cechy i opcje: o czym decydują przełączniki
O zakresie danych decydują przełączniki „Zdjęcia” i „Atrybuty”. W odróżnieniu od XML tutaj silniejszy jest przełącznik, a nie makro: wyłączone „Zdjęcia” — blok zdjęć jest pusty, nawet jeśli makro stoi w szablonie.
W nowych szablonach Google, Meta i TikTok „Zdjęcia” są włączone od razu: bez g:image_link Google odrzuca produkt. Szablonów utworzonych wcześniej program nie zmienia — jeśli przełącznik jest w nich wyłączony, włącz go.
Przełącznik „Opcje” w feedach Google, Meta i TikTok na nic nie wpływa: produkty-opcje trafiają do pliku jako osobne pozycje obok produktu głównego. Tylko produkty główne — to warunek wyboru na zakładce „Ograniczenie eksportu (filtr)” (scenariusz). Ile opcji jest w wyborze, pokazuje wiersz „Produkty-opcje” w podsumowaniu przed uruchomieniem.
Pole „Link do zdjęcia produktu” ustawia początek adresu, do którego dopisywana jest nazwa pliku zdjęcia. Bez niego w feedzie znajdą się adresy względne, a Google przyjmuje tylko pełne.
Produkty bez zdjęć i bez ceny Merchant Center odrzuci pojedynczo, a przy dużym odsetku odrzuceń może zawiesić cały feed. Odsiej je warunkiem wyboru. Podsumowanie przed uruchomieniem pokazuje, ile jest takich produktów, a dla Google także przełącznik „Bez kodu kreskowego” — produkty z pustymi , , UPC i kodem producenta.
Jak nie zepsuć g:id między przebiegami
Każdy przebieg tworzy plik od nowa, z pełnym zestawem produktów. Opcji „Eksportować tylko nowe dane” w formularzu Google nie ma, a silnik jej nie stosuje, nawet jeśli została z dawnych ustawień.
Eksport nie zmienia Twojego katalogu, z jednym wyjątkiem. Jeśli w ustawieniach włączono „Unikalny wewnętrzny kod (SKU)”, przed każdym eksportem, który przeszedł reguły stop, program nadaje losowe SKU produktom z pustym SKU i rozróżnia sufiksem jednakowe. SKU to zwykle właśnie g:id, a Google rozpoznaje produkt po tym polu: pozycja ze zmienionym g:id jest dla niego nowym produktem. Wypełnij SKU przed pierwszym feedem.
Własną wartość możesz utrwalić w polu „Szablon XML”: tekstem zamiast makra (np. new w g:condition, jeśli wszystkie produkty są nowe) lub formułą. Aby usunąć produkt z feedu, odznacz w karcie „Eksportuj do pliku (do sklepu)” lub odetnij go warunkiem wyboru.
Wymiana jest jednokierunkowa: statusów moderacji ani zmian wprowadzonych w Merchant Center Elbuz z powrotem nie pobiera.
Facebook, Instagram i TikTok
Te serwisy czytają ten sam format, więc w programie są osobnymi formatami na tym samym silniku: „Facebook / Instagram (Meta)” i „Tiktok”. Tworzy się je tak samo, przyciskiem dodawania. Szablon treści produktu i zestaw tagów każdy ma własny, logika jest ta sama: tagi serwisu plus Twoje makra.
Na tym samym silniku działają Kelkoo, Pinterest i Microsoft Merchant Center (Bing): opis trafia u nich bez HTML, a w Pintereście i Microsofcie dostępność pisze się ze spacją — in stock. Co dopisać w ich szablonach — w artykule o porównywarkach cen w UE.
We wszystkich tych formatach możesz dodać do feedu etykiety reklamowe custom_label_0…4 — marżę, dostępność, ABC według sprzedaży, nowość i segment cenowy — jednym polem wyboru w bloku „Etykiety reklamowe (custom_label)”. Więcej: Etykiety reklamowe custom_label.
Harmonogram i link do pliku
Podsumowanie przed uruchomieniem, reguły stop, uruchamianie ręczne i według harmonogramu, i dziennik są wspólne dla wszystkich formatów: podsumowanie, reguły stop, uruchamianie, gdzie trafia plik, dziennik przebiegu. Dla feedu Google ważne jest to.
- Adres pliku jest stały — folder szablonu plus nazwa pliku. Końcówka
?uuid=w linku karty to znacznik przeciw pamięci podręcznej; w Merchant Center podaj adres do znaku zapytania. - Pusty feed nie jest publikowany. Jeśli żaden produkt nie spełnił warunków, dziennik kończy się „Eksport danych NIE został zakończony: plik nie został utworzony”, a pod adresem zostaje poprzedni plik.
Co leży pod adresem, gdy przebieg nie dobiegł końca
Nowy plik trafia do chmury w ostatnim kroku i dopiero potem z folderu usuwane jest wszystko inne. Po zatrzymaniu, przerwaniu, błędzie w formule czy nieudanej wysyłce link i data w karcie się nie zmieniają, a Google czyta poprzedni plik. Powtórzenie jest bezpieczne: przebieg zaczyna od czystego pliku.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Wyłączenie i usunięcie szablonu
Przełącznik „Aktywność” w nagłówku karty działa od razu, bez zapisywania formularza. Wyłączony szablon jest pomijany przez harmonogram (po cichu, bez wiersza w dzienniku) i przez „Eksportuj wszystkie szablony”, ale ręcznie da się go uruchomić.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Plik z ostatniego przebiegu zostaje w chmurze, a Merchant Center dalej go czyta — z tymi samymi cenami i stanami. Usunięcie kasuje ustawienia szablonu (XML, FTP, harmonogram, filtr, dostępność), ale nie plik. Aby produkty zniknęły z Google, odłącz źródło danych w Merchant Center.
Jeśli feed poszedł już błędny
Katalogu nie trzeba cofać — eksport go nie zmienia (poza SKU w trybie „Unikalny wewnętrzny kod (SKU)”). Poprzedniego pliku nie ma: w folderze szablonu zostaje tylko nowy.
- Popraw ceny, kategorie, statusy dostępności lub szablon XML.
- Kliknij „Sprawdź” w nagłówku karty: próbny przebieg na jednym produkcie pokaże gotowy XML, nierozpoznane makra, błędy w formułach i znacznikach. Pliku w chmurze, linku ani FTP nie rusza.
- Uruchom zwykły eksport. Adres się nie zmieni, Merchant Center pobierze nowy plik według swojego harmonogramu.
Aby błąd nie powtórzył się automatycznie, przełącz odpowiednią regułę stop w „Zatrzymaj eksport” (scenariusz).
Kiedy produkt znika z feedu
Produkt znika, jeśli przestał spełniać jeden z warunków wyboru: flaga eksportu, kategoria, filtr, sklep lub magazyn — pełna lista w sekcji dlaczego produkt nie trafił do pliku. Znacznika „usunięto” w feedzie nie ma i out_of_stock w miejsce produktu też nie jest zapisywane. Aby Google zobaczył „brak w magazynie”, produkt musi zostać w feedzie ze statusem „brak” (scenariusz).
Scenariusze
Nie wpuścić do Google załamania dostępności
Zadanie: jeśli w katalogu bazowym nagle „zniknęła” dostępność lub połowa produktów, taki feed nie może trafić do Merchant Center.
Co zrobić: na liście szablonów zaznacz wiersz szablonu, w menu „Dodatkowe operacje” wybierz „Reguły stop eksportu” i dla wybranej reguły ustaw tryb „Zatrzymaj eksport”. To samo okno otwiera link „Ustaw progi” w podsumowaniu przed uruchomieniem. Domyślne progi to 30 % dla dostępności i 50 % dla łącznej liczby produktów.
Efekt: zarówno ręczny przebieg, jak i przebieg według harmonogramu przerwą się przed utworzeniem pliku, w dzienniku — „Eksport zatrzymany przez regułę stop”, w chmurze zostanie poprzedni plik. Taki przebieg nie rusza SKU. W pierwszym w ogóle przebiegu szablonu reguły załamania milczą — nie ma jeszcze z czym porównać.
1
Szablon, którego dotyczą progi2
Kolumna Tryb3
Kolumna Próg- Reguły ustawia się dla wybranego szablonu, którego nazwa jest widoczna tutaj.
- W kolumnie Tryb regułę przełącza się między „Wyłączone”, „Ostrzegać” i „Zatrzymaj eksport”; ten ostatni zatrzymuje przebieg.
- Kolumna Próg ustawia granicę zmiany względem poprzedniego przebiegu, po której przekroczeniu reguła zadziała.
Wstrzymać aktualizację feedu
Zadanie: na czas inwentaryzacji lub przeceny feed nie może aktualizować się według harmonogramu.
Co zrobić: w nagłówku karty szablonu przełącz „Aktywność” na „Wyłączony”.
Efekt: harmonogram i „Eksportuj wszystkie szablony” pomijają szablon, przycisk „Eksportuj” działa. Produkty nie znikną z Google: Merchant Center czyta plik z ostatniego przebiegu z tamtymi cenami i stanami (wyłączenie i usunięcie).
W feedzie tylko produkty główne, bez wariantów
Zadanie: Google ma widzieć jedną pozycję na produkt, a nie produkt główny i osobno każdą jego opcję.
Co zrobić: na zakładce „Ograniczenie eksportu (filtr)” dodaj warunek, który odsiewa produkty-opcje.
Efekt: do pliku trafią tylko produkty spełniające warunek. Wyłączenie przełącznika „Opcje” nie wystarczy — w feedach Google, Meta i TikTok on nie działa.
Produkt się skończył, ale ma zostać w Google jako niedostępny
Zadanie: pozycja jest chwilowo niedostępna i w Google ma być pokazywana jako niedostępna, a nie znikać.
Co zrobić: zostaw produkt w wyborze szablonu i nadaj mu status dostępności oznaczony w słowniku jako „brak”.
Efekt: produkt trafia do feedu z wartością out_of_stock. Nowy szablon powstaje z warunkiem wyboru tylko aktywnych produktów, więc nieaktywny produkt nie trafi do feedu, dopóki tego warunku nie zmienisz.
Zmieniono szablon XML i chcesz zobaczyć wynik przed właściwym przebiegiem
Zadanie: po zmianie tagów lub formuł upewnić się, że feed powstanie bez błędów, nie ruszając pliku, który już czyta Google.
Co zrobić: kliknij „Sprawdź” w nagłówku karty szablonu; w razie potrzeby podaj konkretnego produktu.
Efekt: próbny przebieg tworzy XML tym samym silnikiem i pokazuje nierozpoznane makra oraz błędy. Plik w chmurze, link, FTP i liczby dla reguł stop zostają bez zmian.
Co zrobić, gdy Google nie przyjmuje feedu
Pusty wybór, wybrany sklep, konflikt harmonogramu i FTP — w ogólnej tabeli problemów.
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Merchant Center nie przyjmuje wartości dostępności | W ustawieniach dostępności szablonu dla statusu wypełniono „Nazwa na stronie (w pliku)” i ten tekst trafił zamiast słownika | Wyczyść pole w ustawieniach dostępności szablonu (więcej) |
| Google zgłasza błędy linków | W feedzie są adresy względne lub adres zastępczy https://site.com zamiast Twojej strony |
Wypełnij „Link do zdjęcia produktu” i sprawdź pełny adres strony w tagu g:link; https://site.com zamień na swój adres (skąd się bierze) |
| W feedzie nie ma zdjęć | Wyłączono przełącznik „Zdjęcia” | Włącz go — samo makro w szablonie nie działa |
| Kampanie Google Ads rozsypały się po grupach | Zmieniła się ścieżka kategorii w g:product_type |
Nie zmieniaj nazw kategorii bez potrzeby: grupy opierają się na tej ścieżce |
| Część produktów odrzucono | Brak kodu kreskowego i kodu producenta | Wypełnij co najmniej jedno z dwóch pól; przełącznik „Bez kodu kreskowego” w podsumowaniu pokaże, ile jest takich produktów |
| Merchant Center pobiera stary plik | W nazwie pliku jest {DATE}, więc adres codziennie jest nowy |
Usuń makro daty z nazwy pliku |
| „Eksport danych NIE został zakończony: plik nie został utworzony” | Błąd w formule szablonu lub żaden produkt nie spełnił warunków | Kliknij „Sprawdź”: próbny przebieg wskaże formułę i pole. Brak błędów — sprawdź warunki wyboru |
| W feedzie produkt jest dwa razy: on sam i jego wariant | Produkty-opcje trafiają do feedu niezależnie od przełącznika „Opcje” | Odsiej opcje warunkiem wyboru (scenariusz) |
| Google uznaje znane produkty za nowe | Zmienił się g:id — najczęściej tryb „Unikalny wewnętrzny kod (SKU)” nadał SKU |
Dbaj, by SKU były wypełnione i stabilne (o g:id) |
Najczęstsze pytania
Jak podłączyć gotowy feed do Merchant Center?
W Merchant Center dodaj źródło danych z adresem pliku i harmonogramem aktualizacji. Konta Merchant Center Elbuz nie zakłada. Nazwa pliku — bez makra daty, inaczej adres będzie się zmieniał.
Skąd bierze się kategoria Google w feedzie?
g:product_type — Twoja ścieżka kategorii, poziomy przez „>”. Kategorię ze słownika Google bierze się z okna dopasowania do marketplace’ów i wstawia do g:google_product_category.
Jak pokazać cenę promocyjną?
Zwykłą cenę wstawia się do g:price, promocyjną — do g:sale_price. Jeśli promocji nie ma, drugi tag zostaje pusty i Google pokazuje jedną cenę.
Czy potrzebny jest osobny szablon dla Facebooka i Instagrama?
Tak, to osobny format na liście — „Facebook / Instagram (Meta)”. Silnik jest ten sam co w Google Merchant, ale zestaw tagów własny.
Czy feed przekazuje dostawę i podatki?
Nie. Zasady dostawy i podatków ustawia się w samym Merchant Center.
Co stanie się z plikiem, jeśli przebieg przerwie się w połowie?
Google będzie dalej pobierał poprzedni plik: niedokończony nie trafia do chmury. Powtórzenie przebiegu jest bezpieczne (więcej).
Co daje wyłączenie szablonu — czy produkty znikną z Google?
Nie. Wyłączenie zatrzymuje aktualizację, a nie wyświetlanie: Merchant Center czyta plik z ostatniego przebiegu. Usunięcie szablonu też nie kasuje tego pliku.
Czy można cofnąć błędny feed?
Nie, poprzednich wersji pliku nie ma. Katalog nie ucierpiał: popraw dane, sprawdź szablon przyciskiem „Sprawdź” i wyeksportuj ponownie — adres pozostanie ten sam.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Eksport danych
- Uprawnienia
- okno „Eksport danych”; karta — „Szczegółowa konfiguracja szablonu eksportu”
- Przygotuj
- konto Merchant Center, pełny adres strony, zdjęcia i ceny produktów
Powiązane tematy
- Jeśli produkt jest w katalogu, a nie trafił do feedu — Eksport produktów: dlaczego produkt nie trafił do pliku.
- Jeśli
g:google_product_categoryjest puste — Dopasowanie do marketplace’ów. - Jeśli trafia niewłaściwa dostępność — Statusy dostępności.
- Jeśli serwis potrzebuje zwykłego feedu XML — Eksport do XML.
- Jeśli Google odrzuca produkty bez zdjęć — Zdjęcia produktów.
- Jeśli chcesz podzielić produkty na grupy dla stawek w Google Ads — Etykiety reklamowe custom_label.
