Walidator schema: sprawdź dane strukturalne na jednej stronie lub w całej witrynie
Dane strukturalne mówią wyszukiwarkom, o czym jest strona, w formie, którą mogą odczytać bez zgadywania: to jest produkt, to jego cena, to autor. Walidator schema czyta te znaczniki i mówi, czy dają się sparsować, czy poprawnie używają słownika i czy są na tyle kompletne, by kwalifikować się do funkcji wyszukiwania. Jedną stronę łatwo przetestować. Witryna z tysiącami stron z szablonów wymaga tego samego testu wszędzie.
Co sprawdza walidator schema
Walidacja odbywa się na czterech poziomach, a każdy wyłapuje inny rodzaj problemu:
- Składnia. Czy JSON-LD daje się sparsować? Czy każda właściwość mikrodanych jest wewnątrz elementu? Brakujący przecinek lub nieescapowany cudzysłów może uczynić cały blok nieczytelnym.
- Słownik. Czy typy i właściwości to prawdziwe terminy Schema.org, użyte w typach, do których należą? Właściwość z literówką to poprawny JSON, ale nic nie znaczy.
- Wymagania funkcji. Google dokumentuje wymagane i zalecane właściwości dla każdego obsługiwanego wyniku z elementami rozszerzonymi. Znaczniki mogą być poprawnym Schema.org, a mimo to nie mieć właściwości potrzebnej Google do fragmentu produktu lub wpisu wydarzenia.
- Zgodność ze stroną. Wytyczne Google dotyczące danych strukturalnych wymagają, by znaczniki opisywały treść widoczną dla odwiedzających. Cena w znacznikach, której nie ma na stronie, albo nagłówek inny niż widoczny to problem jakościowy, którego nie wykryje żaden test składni.
Większość narzędzi dla jednej strony obejmuje pierwsze trzy. Czwarty wymaga zestawienia znaczników z wyrenderowaną stroną.
Walidator Schema.org i Test wyników z elementami rozszerzonymi od Google
Dwa darmowe narzędzia testują po jednej stronie i odpowiadają na różne pytania. Wprowadzenie Google do danych strukturalnych zaleca podczas budowania Test wyników z elementami rozszerzonymi.
| Schema Markup Validator | Test wyników z elementami rozszerzonymi | |
|---|---|---|
| Twórca | Schema.org | |
| Stron na test | 1 | 1 |
| URL lub wklejony kod | ✓ | ✓ |
| JSON-LD, mikrodane, RDFa | ✓ | ✓ |
| Cały słownik Schema.org | ✓ | – |
| Kwalifikowanie do wyników rozszerzonych Google | – | ✓ |
| Brakujące wymagane właściwości | – | ✓ |
| Podgląd wyniku | – | ✓ |
Schema Markup Validator zastąpił stare Narzędzie do testowania danych strukturalnych Google. Używaj go, aby wiedzieć, czy znaczniki są poprawnym Schema.org, także w przypadku typów, które zasilają panele wiedzy lub odpowiedzi AI, ale nie mają wyniku rozszerzonego. Używaj Testu wyników z elementami rozszerzonymi, gdy celem jest konkretna funkcja Google. Żadne nie testuje całej witryny za jednym razem. SEO ProCheck pokazuje z oboma narzędziami, jak debugować niedziałające wyniki rozszerzone.
JSON-LD, mikrodane i RDFa
Google czyta wszystkie trzy formaty i pisze, że poprawne są równie dobre, ale zaleca JSON-LD, bo siedzi w jednym bloku script, oddzielnie od HTML, i najłatwiej utrzymać go poprawnym w szablonach. Minimalny blok Product wygląda tak:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Trail Running Shoe",
"image": "https://www.example.com/shoe.jpg",
"offers": {
"@type": "Offer",
"price": "89.00",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
}
}
</script>
Mikrodane i RDFa umieszczają te same fakty w atrybutach widocznego HTML. Dzięki temu znaczniki są blisko treści, ale zmiana szablonu HTML może je po cichu zepsuć. Cokolwiek wybierzesz, używaj jednego formatu na element; opisanie tego samego produktu dwa razy w dwóch formatach prosi się o rozbieżności.
Częste błędy w danych strukturalnych
- Zepsuty JSON. Przecinek na końcu, typograficzny cudzysłów wklejony z dokumentu albo surowy znak nowego wiersza w ciągu.
- Brak @context lub @type. Bez nich parser nie wie, co opisuje blok.
- Brak wymaganych właściwości. Zobacz tabelę poniżej.
- Znaczniki niezgodne ze stroną. Cena zmieniona na stronie, ale nie w znacznikach.
- Nieaktualne wartości. Oferta, której priceValidUntil minęło, albo dateModified wcześniejsze niż datePublished.
Wymagane właściwości kilku popularnych funkcji według galerii wyszukiwania Google:
| Typ | Wymagane przez Google |
|---|---|
| Fragment produktu | name oraz offers, review lub aggregateRating |
| Event | name, startDate, location |
| Recipe | name, image |
| BreadcrumbList | itemListElement: name, position, item |
| Article | 0 (wszystkie zalecane) |
Niektóre znaczniki są poprawne, ale nie dają już tego, co kiedyś:
| Znaczniki | Zmiana | Od |
|---|---|---|
| data-vocabulary.org | Nieobsługiwane | 2021 |
| HowTo | Brak wyniku rozszerzonego | Wrzesień 2023 |
| FAQPage | Tylko witryny rządowe i medyczne | Sierpień 2023 |
| FAQPage | Brak wyniku rozszerzonego | Maj 2026 |
Dlaczego jedna strona nie wystarczy
Dane strukturalne prawie zawsze są generowane przez szablony. Gdy się psują, psują się na każdej stronie obsługiwanej przez szablon albo na tej części, w której jedno pole jest puste. Testowanie przypadkowo otwartej strony produktu nie pokaże ci, że 300 produktów nie ma ceny, bo ich pole ceny to zakres, ani że artykuły jednego autora nie mają znaczników autora.
Trzy rzeczy wychodzą na jaw tylko w skali całej witryny:
- Pokrycie. Które grupy stron mają znaczniki i którym stronom w grupie brakuje tego, co mają ich sąsiednie strony.
- Przypadki brzegowe. Puste pola, nietypowe znaki i wartości, które mają tylko niektóre rekordy.
- Dryf. Znaczniki, które były poprawne przy starcie i przestały być poprawne po wydaniu. Dokumentacja Google właśnie z tego powodu zaleca obserwowanie raportów wyników rozszerzonych po wdrożeniu.
Jak zweryfikować schema w całej witrynie
- Przecrawluj witrynę i wyodrębnij dane strukturalne z każdej strony HTML. Jeśli część znaczników wstrzykuje JavaScript, renderuj też strony, jak opisuje poradnik crawler SEO do JavaScriptu.
- Najpierw popraw błędy składni. W bloku, którego nie da się sparsować, nie da się sprawdzić niczego innego.
- Pogrupuj strony według szablonu i wypisz typy, które ma każda grupa. Szukaj stron, którym brakuje typu obecnego w większości ich grupy.
- Sprawdź wymagane właściwości dla funkcji, na których ci zależy, a potem zalecane.
- Porównaj znaczniki z widocznym tekstem: nazwy, nagłówki i ceny powinny pojawiać się na stronie.
- Sprawdź wyrywkowo w Teście wyników z elementami rozszerzonymi jedną stronę z każdego szablonu, aby potwierdzić, co widzi Google.
- Obserwuj Search Console po każdym wydaniu: raporty wyników rozszerzonych i Sprawdzenie adresu URL pokazują, co Google znalazło podczas własnego crawla.
Dane strukturalne to jeden z kroków checklisty audytu SEO technicznego, a czyste znaczniki pomagają też systemom AI czytać stronę, jak wyjaśnia poradnik crawler SEO z AI.
Weryfikuj dane strukturalne z Neova
Kategoria Dane strukturalne w Neova oznacza znaczniki schema na każdej stronie jako poprawne, z ostrzeżeniami lub z błędami, dodaje kolumnę Typy Schema i wydaje werdykt dla każdego typu w panelu URL. Czyta JSON-LD, mikrodane i RDFa z każdej strony HTML w crawlu. Niektóre testy:
- Dane strukturalne mają błędy składni, dla JSON-LD, którego nie da się sparsować lub któremu brakuje @context albo @type
- Danym strukturalnym brakuje wymaganych właściwości lub różnią się od widocznego tekstu, dla funkcji dokumentowanych przez Google
- W danych strukturalnych brakuje zalecanych właściwości, co oznacza też znaczniki data-vocabulary.org
- Cena produktu (Product) w danych strukturalnych nie jest widoczna na stronie HTML oraz Data priceValidUntil w ofercie już minęła
- Sprzeczne daty w danych strukturalnych, lastmod mapy strony lub Last-Modified
- Brak typu danych strukturalnych typowego dla grupy stron oraz Stronie HTML brakuje znaczników wyniku rozszerzonego, które ma jej grupa stron
- Znaczniki Organization lub Person nie mają właściwości identyfikujących
- Strona HTML nie ma danych strukturalnych, który czyta też wyrenderowany HTML, gdy crawl go renderował
- Wynik rozszerzony jest nieprawidłowy, ze Sprawdzenia adresu URL w Google Search Console
Ponieważ Neova wyznacza grupy stron z HTML, problem z szablonem pokazuje się jako jedna grupa z tą samą uwagą, a nie tysiące osobnych wierszy. Na otwarte pytania o typy i formaty odpowiada FAQ SEO ProCheck o schema. Zobacz Funkcje albo pobierz Neova; plan Free crawluje 1000 adresów URL ze wszystkimi testami.
Pytania
Czym jest walidator schema?
To narzędzie, które czyta dane strukturalne na stronie, w JSON-LD, mikrodanych lub RDFa, i sprawdza, czy dają się sparsować, czy poprawnie używają typów i właściwości Schema.org oraz, w niektórych narzędziach, czy mają to, czego wymaga funkcja wyszukiwania.
Czym różni się Schema Markup Validator od Testu wyników z elementami rozszerzonymi?
Schema Markup Validator pod validator.schema.org sprawdza znaczniki względem całego słownika Schema.org. Test wyników z elementami rozszerzonymi od Google sprawdza, do których wyników rozszerzonych Google kwalifikuje się strona i których wymaganych lub zalecanych właściwości brakuje.
Czy poprawne dane strukturalne gwarantują wynik rozszerzony?
Nie. Google pisze, że poprawne znaczniki sprawiają, że strona się kwalifikuje, ale nie ma gwarancji. O tym, czy pokazać wynik rozszerzony, decyduje na podstawie zapytania, strony i swoich wytycznych jakości.
Czy mogę zweryfikować schema w całej witrynie?
Nie narzędziami dla jednej strony. Crawler, który wyodrębnia i sprawdza dane strukturalne na każdej stronie, pokazuje problemy z szablonami, brakujące znaczniki i strony odbiegające od swojej grupy, a potem wyrywkowo sprawdzasz jedną stronę z każdego szablonu w Teście wyników z elementami rozszerzonymi.
Jakiego formatu danych strukturalnych używać?
Google czyta JSON-LD, mikrodane i RDFa i zaleca JSON-LD, bo siedzi w jednym bloku oddzielnie od HTML i najłatwiej go utrzymać.