Piotr Dejneka
Dokumentacja wtyczki

Feed Google Merchant Center

  • Dotyczy wersji 0.5.0
  • Zaktualizowano 6.10.2026
  • 6 min czytania
Na tej stronie
    W skrócie

    Po włączeniu feedu Docket udostępnia plik XML z produktami pod adresem z tajnym tokenem. Ceny w pliku są zawsze cenami dla klienta detalicznego. Adres wklejasz w Merchant Center jako źródło danych. Plik ma nagłówek noindex i nie trafia do wyszukiwarek.

    Włączenie

    Feed jest jedynym modułem wyłączonym po instalacji. Plik zawiera cennik i stany magazynowe, więc włączasz go świadomie.

    1. Wejdź w WooCommerceUstawieniaDocket i przewiń do sekcji „Feed produktowy Google”.
    2. Zaznacz „Włącz feed”.
    3. Opcjonalnie wpisz „Marka”.
    4. Kliknij „Zapisz zmiany”. W polu „Adres feedu” pojawi się adres pliku.
    Ilustracja: sekcja feedu po włączeniu i zapisie.

    Adres z tokenem

    Adres ma postać https://twojsklep.pl/feed/google/<token>/produkty.xml. Token to 32 losowe znaki. Powstaje przy pierwszym użyciu i nie zmienia się sam. Pole „Adres feedu” jest tylko do odczytu. Kliknięcie zaznacza cały adres, gotowy do skopiowania.

    Zapytanie z błędnym tokenem dostaje odpowiedź 404. Odpowiedź z plikiem ma nagłówek X-Robots-Tag: noindex, nofollow, więc nawet gdyby adres wyciekł, plik nie trafi do wyszukiwarki.

    Adres zwraca 404 mimo poprawnego tokenu

    Feed korzysta z reguły adresów WordPressa. Docket odświeża reguły przy aktywacji oraz przy włączeniu i wyłączeniu feedu. Jeśli inna wtyczka je nadpisała, wejdź w UstawieniaBezpośrednie odnośniki i kliknij „Zapisz zmiany” bez zmieniania czegokolwiek.

    Nowy token

    Jeśli adres trafił w niepowołane ręce, zaznacz „Nowy token” i zapisz ustawienia. Docket wygeneruje nowy adres, a stary przestanie działać od razu. Nowy adres musisz podmienić w Merchant Center. Pole „Nowy token” to jednorazowa akcja: po zapisie samo się odznacza.

    Marka

    Markę produktu Docket bierze z taksonomii marek WooCommerce. Gdy produkt nie ma przypisanej marki, używa wartości z pola „Marka”. Puste pole oznacza nazwę witryny. Jeśli sprzedajesz produkty wielu producentów, przypisz im marki w WooCommerce, zamiast polegać na jednej wartości z ustawień.

    Jakie dane trafiają do pliku

    Plik jest w formacie RSS 2.0 z przestrzenią nazw Google. Każdy produkt to jedna pozycja z polami:

    PoleŹródło
    g:idSKU, a gdy go brak, identyfikator produktu
    g:titlenazwa produktu; dla wariantu nazwa produktu i cechy wariantu
    g:descriptionkrótki opis, potem krótki opis produktu nadrzędnego, potem pełny opis, bez znaczników HTML i shortcode’ów; w ostateczności nazwa
    g:linkadres produktu
    g:image_linkobrazek produktu w pełnym rozmiarze; wariant bez obrazka dostaje obrazek produktu nadrzędnego
    g:availabilityin_stock, out_of_stock albo backorder dla zamówień oczekujących
    g:conditionzawsze new
    g:price, g:sale_pricecena regularna i promocyjna z walutą sklepu
    g:brandmarka, opisana wyżej
    g:gtinpole „GTIN, UPC, EAN lub ISBN” z WooCommerce
    g:mpnSKU
    g:identifier_existsno, gdy produkt nie ma GTIN
    g:product_typepierwsza kategoria produktu
    g:item_group_idtylko warianty: SKU albo identyfikator produktu nadrzędnego
    g:shipping_weightwaga w jednostce ustawionej w sklepie

    Puste pola nie trafiają do pliku. Warianty idą jako osobne pozycje ze wspólnym g:item_group_id. Znaki niedozwolone w XML Docket usuwa, żeby jeden opis nie zepsuł całego pliku.

    Cena

    Do pliku trafia cena, którą zobaczy niezalogowany klient wchodzący z reklamy. Docket generuje plik w kontekście gościa, niezależnie od tego, kto go pobiera. Cena jest brutto albo netto, zależnie od tego, jak sklep wyświetla ceny w ustawieniach podatków WooCommerce.

    • Cena regularna trafia do g:price.
    • Cena promocyjna trafia do g:sale_price, tylko gdy promocja trwa i cena jest niższa od regularnej.
    • Produkt bez ceny nie trafia do pliku.

    Vetted. Gdy działa wtyczka Vetted z cenami B2B, Docket na czas generowania pliku wyłącza jej podmianę cen. W pliku jest cena detaliczna, a nie hurtowa.

    Własna logika. Filtr docket_feed_price pozwala zmienić obie ceny przed zapisem. Przykład jest w artykule dla deweloperów.

    Które produkty trafiają do pliku

    Do pliku trafiają produkty opublikowane, widoczne w katalogu sklepu i możliwe do kupienia przez gościa. Nie trafiają:

    • szkice, produkty prywatne i oczekujące na publikację;
    • produkty ukryte w katalogu w ustawieniach widoczności produktu;
    • produkty bez ceny;
    • produkty z ceną ukrytą przed gośćmi w Vetted, bo gość nie może ich kupić.

    Pojedyncze produkty albo całe grupy wykluczysz filtrem docket_feed_include_product.

    GTIN i EAN

    Docket czyta kod z pola „GTIN, UPC, EAN lub ISBN” w edycji produktu. To pole jest w WooCommerce od wersji 9.2. Z kodu zostają same cyfry. Wariant ma własny GTIN i nie dziedziczy kodu produktu nadrzędnego, bo ten nie opisuje konkretnego wariantu.

    Bez GTIN Docket deklaruje g:identifier_exists o wartości no. Google rozpozna wtedy produkt po marce i numerze katalogowym: markę Docket podaje zawsze, a SKU, jeśli produkt je ma, trafia do g:mpn. Jeśli trzymasz kody EAN w innym polu, podaj je filtrem docket_feed_gtin.

    Podłączenie w Merchant Center

    Interfejs Google się zmienia, więc podaję ogólne kroki.

    1. Włącz feed w Docket i skopiuj adres z pola „Adres feedu”.
    2. Otwórz adres w przeglądarce i sprawdź, czy widzisz plik XML z produktami.
    3. W Merchant Center dodaj nowe źródło danych produktowych pobierane z pliku pod adresem URL.
    4. Wklej adres feedu i ustaw harmonogram pobierania, na przykład raz dziennie.
    5. Ustaw kraj sprzedaży i język zgodne ze sklepem.
    6. Po pierwszym pobraniu sprawdź diagnostykę produktów i popraw zgłoszone braki w WooCommerce.
    Po zmianie tokenu podmień adres

    Merchant Center pobiera plik spod zapisanego adresu. Po wygenerowaniu nowego tokenu stary adres zwraca 404, a produkty przestaną się aktualizować, dopóki nie wkleisz nowego.

    Czy ta strona pomogła?

    Ostatnia zmiana: 6.10.2026, wersja 0.5.0Zgłoś błąd w tej stronie