socialproof Zgłoś case study

Narzędzia

Testowanie danych strukturalnych opinii: Rich Results Test i Schema Markup Validator

Zanim gwiazdki opinii pojawią się w wynikach Google, znaczniki trzeba sprawdzić dwoma narzędziami, które odpowiadają na różne pytania. Wyjaśniamy, czym test wyników z elementami rozszerzonymi różni się od Schema Markup Validatora, jak czytać ich raporty, jak poprawić najczęstsze błędy w Review i AggregateRating oraz co kontrolować po wdrożeniu.

Autor: Redakcja Social ProofOpublikowano: Aktualizacja: 8 min czytania

W skrócie

  • Rich Results Test sprawdza, czy strona kwalifikuje się do wyników rozszerzonych Google, a Schema Markup Validator – czy znaczniki są poprawne według słownika Schema.org; przy danych o opiniach warto używać obu.
  • Schema Markup Validator zastąpił w maju 2021 r. wycofywane przez Google narzędzie Structured Data Testing Tool i jest rozwijany pod szyldem Schema.org.
  • Rich Results Test domyślnie pobiera stronę jako smartfon, renderuje JavaScript i pozwala udostępnić wynik linkiem ważnym około 90 dni.
  • Bezbłędny test nie gwarantuje gwiazdek: Google nie wyświetla ich m.in. dla opinii o firmie publikowanych na jej własnej stronie ani dla ocen zebranych w innych serwisach.
  • Po wdrożeniu kontrolę przejmuje Google Search Console: raporty stanu wyników z elementami rozszerzonymi, test aktywnego adresu URL i raport skuteczności.
Spis treści
  1. Rich Results Test czy Schema Markup Validator: dwa narzędzia, dwa pytania
  2. Jak przetestować kartę produktu w Rich Results Test
  3. Schema Markup Validator: kiedy jest potrzebny
  4. Najczęstsze błędy w danych strukturalnych opinii i jak je poprawić
  5. Po teście: kontrola w Google Search Console
  6. Test przed wdrożeniem, po wdrożeniu i po każdej zmianie
  7. Procedura testowania w 10 minut – checklista
  8. Najczęstsze pytania

Testowanie danych strukturalnych opinii wymaga dwóch narzędzi: Rich Results Test od Google sprawdza, czy karta produktu kwalifikuje się do wyników rozszerzonych z gwiazdkami, a Schema Markup Validator – czy znaczniki Review i AggregateRating są poprawne według słownika Schema.org. Po wdrożeniu wynik trzeba jeszcze potwierdzić w Google Search Console, bo pozytywny test nie gwarantuje wyświetlenia gwiazdek.

Rich Results Test czy Schema Markup Validator: dwa narzędzia, dwa pytania

Dwa narzędzia istnieją z powodów historycznych. Google udostępnił Structured Data Testing Tool w 2015 r., a dwa lata później – Rich Results Test. W lipcu 2020 r., wraz z wyjściem nowego testu z fazy beta, zapowiedział wycofanie starszego narzędzia. Po krytyce ze strony branży postanowił przekazać je społeczności Schema.org i w maju 2021 r. zastąpił je Schema Markup Validator, rozwijany pod szyldem Schema.org.

Od tego czasu podział ról jest jasny. Rich Results Test patrzy na stronę oczami Google i ocenia tylko te typy, które wyszukiwarka potrafi wyświetlić w formie rozszerzonej. Schema Markup Validator patrzy na znaczniki oczami słownika: czy typy i właściwości istnieją, czy składnia jest poprawna i czy połączenia między obiektami mają sens.

Kryterium Rich Results Test Schema Markup Validator
Kto go rozwija Google Schema.org
Na jakie pytanie odpowiada czy strona może dostać wynik rozszerzony czy opis jest poprawny według Schema.org
Zakres typów tylko typy obsługiwane przez Google wszystkie typy i właściwości słownika
Obsługiwane formaty JSON-LD, RDFa, Microdata JSON-LD, RDFa, Microdata
Strony z JavaScriptem renderuje stronę jak robot Google, jako smartfon lub komputer odczytuje też znaczniki dodane skryptem
Wytyczne Google (np. opinie o sobie) sprawdza wymagane pola, ale nie ocenia wszystkich zasad nie sprawdza
Typowe zastosowanie kontrola przed publikacją i po zmianie szablonu szukanie błędów składni i analiza całego grafu danych

W praktyce przy opiniach najpierw uruchamiasz Rich Results Test. Po walidator sięgasz wtedy, gdy test Google nie wykrywa niczego, choć w kodzie widać blok JSON-LD, albo gdy chcesz zobaczyć wszystkie obiekty opisane na stronie, także te, których Google nie wykorzystuje.

Jak przetestować kartę produktu w Rich Results Test

Sam test trwa kilkanaście sekund, ale wartościowy wynik daje dopiero sprawdzenie kilku typowych stron i uważna lektura raportu.

  1. Wybierz trzy karty produktów: z wieloma opiniami, z jedną opinią i bez opinii. Każda z nich ujawnia inny rodzaj błędu.
  2. Wklej adres i zostaw domyślny tryb smartfona. Google indeksuje strony przede wszystkim w wersji mobilnej. Tryb komputera przydaje się, gdy szablon mobilny różni się od wersji desktopowej.
  3. Przeczytaj podsumowanie. Narzędzie pokazuje, czy strona została pobrana, ile elementów jest prawidłowych, ile ma ostrzeżenia, a ile błędy. W sklepie najczęściej zobaczysz fragmenty produktów, a przy pełnych danych oferty także informacje o produktach sprzedawcy. Oceny są sprawdzane w ramach tych elementów albo jako osobne fragmenty opinii – zależnie od budowy znaczników.
  4. Rozwiń wykryty element i porównaj wartości z tym, co widzi klient: średnią, liczbę opinii, nazwę produktu. Kliknięcie w opis elementu przenosi do miejsca w wyrenderowanym kodzie.
  5. Zajrzyj do przetestowanej strony. Podgląd wyrenderowanego HTML i lista niewczytanych zasobów pokazują, czy skrypt modułu opinii zdążył się wykonać. Niewczytane obrazy lub skrypty mogą sprawić, że kolejne testy tej samej strony dadzą różne wyniki.
  6. Udostępnij wynik programiście przyciskiem udostępniania. Link działa około 90 dni i może go otworzyć każdy, kto go otrzyma, więc nie testuj w ten sposób stron z danymi, których nie chcesz ujawniać.

Narzędzie pobiera stronę jako robot Google, więc nie przetestuje adresu zablokowanego w pliku robots.txt ani strony wymagającej logowania. Wersję testową sklepu sprawdzisz, wklejając kod w trybie „Kod” albo udostępniając ją tymczasowo przez tunel. Uwaga na komentarze w JSON-LD: test je pomija, ale standard ich nie przewiduje, więc na żywej stronie mogą powodować błędy.

Schema Markup Validator: kiedy jest potrzebny

Walidator Schema.org wyodrębnia ze strony znaczniki w trzech formatach, pokazuje podsumowanie całego grafu danych i wskazuje błędy składni. Ostrzega też, gdy typy i właściwości są łączone w nietypowy sposób. Nie pobiera natomiast zewnętrznych kontekstów JSON-LD innych niż słownik Schema.org i nie wie nic o wymaganiach konkretnych wyszukiwarek.

Najczęściej przydaje się w trzech sytuacjach:

  • Rich Results Test nie wykrywa żadnego elementu, choć blok danych jest w kodzie. Walidator zwykle wskazuje wtedy błąd składni, np. brakujący przecinek lub nawias, przez który parser nie rozpoznał typu.
  • Na stronie jest kilka obiektów – Product, Organization, BreadcrumbList, WebSite – i trzeba sprawdzić, czy nie powstały dwa osobne produkty albo ocena „wisząca” poza produktem.
  • Oznaczasz typy spoza listy Google, bo dane czytają też inne wyszukiwarki i systemy korzystające ze Schema.org.

Pamiętaj o granicy tego narzędzia. Ocena łączna przypisana do typu Organization na stronie głównej przejdzie walidację bez zastrzeżeń, a mimo to gwiazdek nie będzie. Od września 2019 r. Google nie wyświetla ich dla opinii o firmie lub organizacji publikowanych przez nią samą, również za pośrednictwem widżetu zewnętrznego dostawcy. Wszystkie wymagania dotyczące gwiazdek omawiamy w poradniku o tym, jak dodać gwiazdki opinii do wyników Google.

Najczęstsze błędy w danych strukturalnych opinii i jak je poprawić

Według dokumentacji Google ocena łączna wymaga średniej (ratingValue), liczby ocen lub opinii (ratingCount albo reviewCount) i nazwy ocenianego elementu, a pojedyncza opinia – autora, oceny i wskazania, czego dotyczy. Większość błędów wynika z tego, że moduł opinii, motyw sklepu i ręcznie dodany kod opisują ten sam produkt na różne sposoby.

Objaw w raporcie Typowa przyczyna Jak poprawić
Brak pola „itemReviewed” (Missing field "itemReviewed") samodzielny blok AggregateRating lub Review bez wskazania produktu zagnieźdź ocenę w obiekcie Product albo dodaj itemReviewed z nazwą
Brak pola „ratingValue” lub „reviewCount” moduł tworzy pusty blok oceny dla produktu bez opinii pomijaj aggregateRating, gdy opinii nie ma
komunikat o konieczności podania offers, review lub aggregateRating (Either "offers", "review", or "aggregateRating" should be specified) drugi, niepełny blok Product wygenerowany przez motyw usuń duplikat lub połącz dane w jeden obiekt
Nieprawidłowa wartość oceny liczba zapisana z przecinkiem, np. „4,6”, lub jako tekst z gwiazdką w kodzie zapisuj liczbę z kropką: 4.6
Ocena poza skalą sklep używa skali 1–10, a w kodzie brak bestRating dodaj bestRating i worstRating
Wartości różne od widocznych na stronie pamięć podręczna, inna baza danych, opinie z innego serwisu jedno źródło danych dla widżetu i znaczników
Brak elementów po zmianie motywu nowy szablon nie wczytuje bloku JSON-LD test kilku kart po każdej aktualizacji

Osobną kategorią są ostrzeżenia, czyli problemy niekrytyczne. Dotyczą zalecanych właściwości, takich jak marka, identyfikator produktu czy data publikacji opinii. Nie blokują wyniku rozszerzonego, ale uzupełnienie ich prawdziwymi danymi zwiększa szansę, że Google wykorzysta pełny opis produktu.

Jest też błąd, którego żaden test nie pokaże: oznaczenie w znacznikach ocen pobranych z innego serwisu. Wytyczne Google wprost zabraniają agregowania opinii z innych witryn, więc widżet z recenzjami z Map Google czy porównywarki może zostać na stronie, ale bez danych strukturalnych. Szczegóły znajdziesz w porównaniu dostawców widżetów opinii Google.

Po teście: kontrola w Google Search Console

Rich Results Test sprawdza pojedynczy adres w danej chwili. O tym, co dzieje się z setkami kart produktów w indeksie, mówi dopiero Google Search Console.

Sprawdzanie adresu URL. Test aktywnego adresu pokazuje, czy strona może zostać zindeksowana (nie blokuje jej robots.txt ani tag noindex) i jakie ulepszenia wykrył Google. Po poprawkach możesz z tego miejsca poprosić o ponowne zindeksowanie kilku kluczowych adresów.

Raporty stanu wyników z elementami rozszerzonymi. Dokumentacja Google zaleca, by po pierwszym wdrożeniu obserwować wzrost liczby prawidłowych elementów i brak wzrostu nieprawidłowych, a po każdej zmianie szablonu – nagłe skoki błędów. Gdy poprawisz błąd w szablonie, uruchom sprawdzanie poprawki w raporcie, zamiast zgłaszać ręcznie tysiące adresów.

Raport skuteczności. Filtr wyglądu w wyszukiwarce pozwala porównać klikalność stron prezentowanych z fragmentami rozszerzonymi. Ocena efektu wymaga porównania tych samych stron w podobnych okresach. Jak opinie wpływają na widoczność szerzej, opisujemy w poradniku o opiniach klientów a SEO.

Test przed wdrożeniem, po wdrożeniu i po każdej zmianie

Dane strukturalne psują się najczęściej nie przy pierwszym wdrożeniu, tylko przy aktualizacjach: nowej wersji wtyczki, zmianie motywu, migracji platformy. Dlatego testowanie warto wpisać w kalendarz prac nad sklepem.

Moment Narzędzie Co sprawdzić
Wybór modułu lub systemu opinii Rich Results Test na stronie demonstracyjnej dostawcy czy moduł generuje znaczniki, w jakim formacie i czy nie dubluje motywu
Przed publikacją szablonu Rich Results Test i walidator w trybie kodu wymagane pola, brak błędów składni
Dzień wdrożenia Rich Results Test dla 3–5 adresów, sprawdzanie adresu URL wyrenderowany HTML, możliwość indeksowania
2–4 tygodnie po wdrożeniu raporty stanu w Search Console rosnąca liczba prawidłowych elementów
Aktualizacja wtyczki, zmiana motywu, migracja Rich Results Test i raport stanu czy znaczniki nie zniknęły lub nie zdublowały się

Przy wyborze narzędzia zapytaj dostawcę, czy znaczniki trafiają do kodu serwera, czy są wstrzykiwane skryptem, i czy można je wyłączyć, gdy motyw ma własne. Odpowiedzi różnią się między platformami – omawiamy je w przeglądach aplikacji opinii dla Shopify, wtyczek opinii dla WooCommerce oraz modułów opinii w Shoper, IdoSell i PrestaShop. Zmianę platformy planuj z listą kontrolną z poradnika o przenoszeniu opinii przy migracji sklepu, bo właśnie wtedy gwiazdki znikają najczęściej.

Gwiazdki z danych strukturalnych strony to nie jedyne gwiazdki w Google. Oceny przy reklamach i w Zakupach Google pochodzą z innych źródeł i nie da się ich sprawdzić żadnym z opisanych testów – wyjaśniamy to w tekście o ocenach sprzedawcy w Google Ads. Jeśli dopiero wybierasz system opinii, zacznij od porównania narzędzi do zbierania opinii.

Procedura testowania w 10 minut – checklista

  1. Wybierz trzy karty produktów: z wieloma opiniami, z jedną i bez opinii.
  2. Przetestuj każdą w Rich Results Test w trybie smartfona.
  3. Porównaj średnią, liczbę opinii i nazwę produktu w raporcie z tym, co widać na stronie.
  4. Sprawdź wyrenderowany HTML i listę niewczytanych zasobów.
  5. Jeśli test nic nie wykrywa, wklej kod do Schema Markup Validator i poszukaj błędu składni.
  6. Usuń zduplikowane obiekty Product i puste bloki oceny.
  7. Upewnij się, że nie oznaczasz opinii o własnej firmie ani ocen z innych serwisów.
  8. Po wdrożeniu obserwuj raporty stanu w Search Console i uruchom sprawdzanie poprawki.
  9. Powtarzaj test po każdej aktualizacji wtyczki, motywu lub platformy.

Najczęstsze pytania

Czym różni się Rich Results Test od Schema Markup Validator?

Rich Results Test pokazuje, czy strona może uzyskać wyniki rozszerzone w Google, i analizuje tylko typy obsługiwane przez wyszukiwarkę. Schema Markup Validator sprawdza wszystkie typy i właściwości Schema.org oraz składnię JSON-LD, RDFa i Microdata, ale nie ocenia wymagań Google. Pierwszy odpowiada na pytanie o szansę na gwiazdki, drugi – o poprawność samego opisu.

Dlaczego Rich Results Test nie wykrywa danych strukturalnych, które są w kodzie?

Najczęstsze przyczyny to blokada strony w pliku robots.txt, wymóg logowania, skrypt widżetu, który nie załadował się podczas renderowania, oraz błąd składni JSON, przez który narzędzie nie rozpoznaje typu. Możliwe też, że oznaczony typ nie jest obsługiwany przez Google. Sprawdź sekcję o pobieraniu strony, listę niewczytanych zasobów i wyrenderowany kod HTML.

Czy ostrzeżenia w Rich Results Test trzeba poprawiać?

Ostrzeżenia, nazywane problemami niekrytycznymi, nie wykluczają strony z wyników rozszerzonych, ale oznaczają brak zalecanych właściwości. Warto je uzupełnić, jeśli masz prawdziwe dane, np. markę, identyfikator produktu czy datę opinii. Nie dopisuj natomiast wartości wymyślonych tylko po to, żeby zniknął komunikat – niezgodność znaczników z treścią strony jest groźniejsza niż ostrzeżenie.

Ile trzeba czekać na gwiazdki po poprawieniu błędów?

Zmiany pojawiają się dopiero po ponownym przetworzeniu strony przez Google, zwykle po kilku dniach lub tygodniach. Dla kilku kluczowych adresów możesz poprosić o ponowne zindeksowanie w Search Console, a dla całego szablonu uruchomić sprawdzanie poprawki w raporcie stanu. Raporty aktualizują się z opóźnieniem, więc oceniaj trend, a nie pojedynczy dzień.

Czy da się przetestować dane strukturalne strony, która nie jest opublikowana?

Tak. Oba narzędzia przyjmują wklejony kod zamiast adresu, więc szablon karty produktu sprawdzisz przed wdrożeniem. Rich Results Test w trybie adresu wymaga strony dostępnej publicznie; wersję testową za zaporą można udostępnić tymczasowo przez tunel. Pamiętaj, że link do wyniku testu może otworzyć każdy, kto go dostanie.