Kontroler Danych Strukturalnych Screpy sprawdza JSON-LD z publicznej strony lub wklejonego kodu. Wykrywa błędy parsowania, wyświetla zadeklarowane encje i zgłasza problemy z wybranymi właściwościami pięciu obsługiwanych typów schematu. Raport pomaga ustalić, co poprawić, a co wymaga szerszej weryfikacji. Poprawna składnia, obsługiwane kontrole i kwalifikacja do wyniku rozszerzonego Google to osobne kwestie; zielony status nie odpowiada na wszystkie trzy.
Wybierz URL strony lub wklej JSON-LD
Wybierz URL strony, aby sprawdzić opublikowaną stronę, na przykład stronę produktu lub kontaktu firmy. Podaj jej publiczny adres HTTP lub HTTPS zamiast domyślnie wpisywać stronę główną: różne szablony mogą zawierać różne znaczniki. Tryb URL odczytuje HTML zwrócony przez stronę. Strona prywatna lub chroniona hasłem nie dostarcza takich samych publicznych danych, a błąd pobierania nie dowodzi, że dane strukturalne są niepoprawne.
Wybierz Wklej kod, aby przejrzeć szkic, wyodrębniony skrypt lub posiadany HTML. Format JSON-LD służy do samego JSON, bez otaczającego elementu <script>. Wybierz HTML, gdy dane zawierają bloki <script type="application/ld+json">. Adres osobnego pliku JSON nie jest stroną HTML; wklej jego zawartość w trybie JSON-LD. Limit wklejanych danych wynosi 256 KiB liczonych jako bajty UTF-8, więc dopuszczalna liczba znaków zależy od tekstu.
Kontrola URL nie wykonuje JavaScript. Znaczniki dodawane po załadowaniu strony mogą nie występować w pobranym źródle. Google może przetwarzać dynamicznie dodany JSON-LD, dlatego brak bloku w raporcie nie dowodzi, że Google go nie widzi. Jeśli to rozróżnienie ma znaczenie, sprawdź odpowiednie wyrenderowane znaczniki lub użyj testu Google. Wklejenie kodu sprawdza dostarczone dane; nie potwierdza, co serwuje opublikowana strona.
Odczytaj raport danych strukturalnych
Zacznij od zakresu pokrycia, a następnie przejrzyj obserwacje i tabelę encji. Bloki JSON-LD to liczba skryptów wykrytych w HTML; wklejony JSON-LD jest traktowany jako jeden blok. Encje to zachowane obiekty z zadeklarowanym typem, których JSON został poprawnie sparsowany; jeden skrypt może zawierać kilka encji. Błędy składni zliczają przetworzone bloki, których nie udało się sparsować. To różne wielkości: strona z trzema blokami nie musi mieć trzech encji. W raporcie częściowym liczba wykrytych bloków nie dowodzi, że każdy został sprawdzony.
Każdy wiersz rozdziela Składnię i Zakres. Zielona poprawna składnia oznacza, że parser JSON zaakceptował blok. Zielony status obsługiwanych kontroli oznacza, że encja kwalifikowała się do wybranych kontroli właściwości tego narzędzia. Przeczytaj również obserwacje: żaden z tych statusów nie potwierdza poprawności wszystkich właściwości. Czerwony oznacza błędy parsowania lub obserwacje o poziomie błędu, żółty wskazuje ostrzeżenia i częściowe pokrycie, a szary — nieobsługiwane lub niedostępne dane. Czytaj opis statusu razem z kolorem.
Kolumna Ścieżka ułatwia znalezienie zagnieżdżonych obiektów. Na przykład $.author wskazuje obiekt autora w korzeniu, a $.@graph[1] drugi obiekt w tablicy @graph. Ścieżki odnoszą się do konkretnego bloku JSON-LD, więc ta sama ścieżka może pojawić się w kilku skryptach. Pobrany JSON zawiera numery bloków, które pozwalają je rozróżnić.
Kolumna Nazwa odczytuje name, a nie właściwość wyświetlanej nazwy każdego typu. Article z poprawnym headline może więc mieć pustą komórkę Nazwa. Sprawdź właściwą właściwość i obserwację, zanim uznasz pustą komórkę za błąd treści.
Popraw składnię JSON przed ostrzeżeniami o właściwościach
Niepoprawny blok nie dostarcza wiarygodnych obserwacji dotyczących encji. Najpierw napraw JSON, a następnie ponów kontrolę, zanim zinterpretujesz ostrzeżenia o brakujących właściwościach. Typowe przyczyny to pojedyncze cudzysłowy wokół nazw lub tekstu, dodatkowy przecinek po ostatniej właściwości, brak zamykającego nawiasu oraz niepoprawnie zapisany cudzysłów wewnątrz tekstu. JSON używa podwójnych cudzysłowów i przecinków między elementami; RFC 8259 definiuje jego gramatykę.
Ta fikcyjna Organization jest minimalnym przykładem składni dla Wklej kod → JSON-LD:
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Example Studio",
"url": "https://example.com/"
}
Przykład zawiera dwie właściwości, których narzędzie szuka dla Organization. Nie jest kompletnym szablonem żadnej funkcji wyszukiwarki Google. Zastąp fikcyjne wartości prawdziwymi danymi strony i przed wdrożeniem zapoznaj się z wymaganiami odpowiedniej funkcji.
Sama poprawność JSON nie potwierdza użytecznych danych strukturalnych. Osobny ciąg znaków lub liczba może być poprawnym JSON, ale nie opisuje oczekiwanej encji; narzędzie zgłasza, że korzeń musi być obiektem lub tablicą. Podobnie sparsowany obiekt bez zadeklarowanego @type może nie dać żadnych wierszy encji. Sprawdź rzeczywistą strukturę, zanim dodasz właściwości wyłącznie po to, by usunąć komunikaty.
Które właściwości schematu są sprawdzane?
Kontroler Danych Strukturalnych wykonuje wybrane kontrole pięciu dokładnych typów, gdy rozpoznaje ich kontekst. Tabela pomaga zrozumieć obserwację; nie jest pełnym wykazem właściwości Schema.org ani wymaganych pól Google.
| Zadeklarowany typ | Co sprawdza narzędzie | Jak wykorzystać obserwację |
|---|---|---|
Organization |
Obecność name i url |
Sprawdź, czy opisują rzeczywistą organizację i jej właściwą witrynę. |
LocalBusiness |
Obecność name i address |
Zweryfikuj rzeczywistą tożsamość firmy i adres; składniki adresu nie są w pełni sprawdzane. |
Article |
Obecność headline, author, datePublished i image |
Porównaj wartości z artykułem, a formaty sprawdź osobno. |
Product |
Obecność name; czy podano którąkolwiek z właściwości offers, review lub aggregateRating |
Używaj tylko prawdziwych, adekwatnych danych produktu. Nie wymyślaj oferty ani opinii, aby usunąć ostrzeżenie. |
BreadcrumbList |
Niepusta tablica itemListElement; dodatnia całkowita position i niepusty tekst name każdego sprawdzanego elementu |
Popraw wskazany element, a następnie osobno sprawdź pełną ścieżkę nawigacji i docelowe adresy URL. |
Większość kontroli sprawdza obecność wartości. Wartość może istnieć, mimo że jej URL, data, obraz, struktura obiektu lub treść są błędne. Pusty obiekt może spełnić kontrolę obecności, a wartości zawierające same spacje nie są odrzucane przez każdą kontrolę. Status obsługi nie potwierdza więc kompletności adresu, autora ani oferty.
Kontrole nawigacji okruszkowej dodatkowo sprawdzają wybrane wartości elementów, ale nie potwierdzają kolejnych ani unikalnych pozycji, poprawności adresów item czy pełnej semantyki ListItem. Raport zachowuje najwyżej 100 obserwacji dotyczących właściwości na encję. Długa ścieżka lub encja z wieloma powtarzającymi się błędami może wymagać dalszej oceny.
Poprawiaj obserwacje w kontekście strony. Jeżeli autorem artykułu jest osoba, zachowaj prawdziwą strukturę autora, nawet gdy zagnieżdżona Person wykracza poza zakres narzędzia. Zmienianie zgodnych z prawdą znaczników tylko dla zielonych statusów może ukryć pierwotny problem zamiast go rozwiązać.
Dlaczego poprawne znaczniki są nieobsługiwane lub sprawdzone częściowo?
Nieobsługiwany status oznacza, że narzędzie nie wykonało wybranych kontroli właściwości tej encji. Nie oznacza, że Schema.org zabrania używania typu. Obsługiwany Article może na przykład zawierać zagnieżdżonego autora Person. Article otrzyma swoje kontrole, ale Person zostanie pokazana jako nieobsługiwana, przez co pokrycie będzie częściowe. Także Restaurant wykracza poza pięć dokładnych obsługiwanych typów, choć jest bardziej szczegółowym typem firmy. Zachowaj typ prawidłowo opisujący obiekt i użyj szerszego walidatora do pozostałych kontroli.
Kontekst może prowadzić do tego samego rozróżnienia. Narzędzie rozpoznaje prosty kontekst http://schema.org lub https://schema.org, z końcowym ukośnikiem lub bez niego, również odziedziczony po obiekcie nadrzędnym. Nie rozwiązuje kontekstów w postaci obiektów ani tablic. Takie formy mogą być prawidłowe według specyfikacji kontekstu JSON-LD W3C. Jeżeli encja deklaruje kilka typów, wszystkie muszą należeć do obsługiwanego zestawu, aby uruchomiły się kontrole właściwości.
Pokrycie jest też ograniczone. Narzędzie uwzględnia pierwsze 50 bloków JSON-LD i zachowuje do 500 wierszy wyników, w tym wiersze niepoprawnych bloków. Przerywa przechodzenie po strukturze powyżej 32 poziomów zagnieżdżenia lub 10 000 odwiedzonych wartości na blok. Późniejsze encje mogą więc pozostać niesprawdzone. Wykryte w HTML Microdata lub RDFa również powodują częściowy raport, ponieważ te formaty nie są tutaj walidowane.
Duże wklejane dane podziel na kompletne bloki JSON-LD i sprawdzaj osobno. Nie przecinaj obiektu w połowie, tworząc nowy błąd składni. Zachowaj oryginalne źródło i zaznacz, które fragmenty obejmuje każdy raport. Osobne kontrole nie łączą się automatycznie w pełny audyt strony.
Sprawdź stronę po poprawieniu znaczników
Najpierw porównaj znaczniki z tym, co użytkownik może przeczytać na stronie. Zweryfikuj tożsamości, daty, adresy, dane produktów i ewentualne opinie względem rzeczywistej treści. Wytyczne Google dotyczące danych strukturalnych wymagają trafnych, prawdziwych informacji i spełnienia odpowiednich wymagań funkcji; parser nie potwierdza tych faktów. Nie dodawaj fikcyjnych szczegółów, aby usunąć ostrzeżenie o właściwości.
Dobierz następną kontrolę do nierozstrzygniętej kwestii. Schema.org Markup Validator służy do szerszej oceny znaczników Schema.org, w tym Microdata i RDFa. Ma własne ograniczenia: nie pobiera ani nie interpretuje innych adresów kontekstu. Użyj Testu wyników rozszerzonych Google, aby sprawdzić obsługiwane funkcje wyszukiwarki Google oraz zgłaszane błędy i ostrzeżenia. Pomyślny test nie gwarantuje wyświetlenia wyniku rozszerzonego.
Jeżeli przygotowujesz znaczniki firmy, Generator Schema Firmy Lokalnej może utworzyć JSON-LD z jej prawdziwych danych. Przejrzyj wynik przed publikacją. Szczegółowe typy firm i zagnieżdżone obiekty PostalAddress mogą nadal pozostawać nieobsługiwane w tym kontrolerze; generowanie i wybrane kontrole to osobne zadania.
Po wdrożeniu poprawki ponów odpowiednią kontrolę opublikowanej strony, nie tylko szkicu. Potwierdź, że serwowane znaczniki zawierają zamierzoną zmianę, i porównaj pozostałe obserwacje. Użyj Pobierz JSON, aby zachować numery bloków, ścieżki encji, obserwacje i pokrycie dla tej kontroli. Zachowaj dane wejściowe i zakres razem z eksportem, aby kolejny recenzent mógł zrozumieć dowody. Zapisany raport dokumentuje kontrolę; nie monitoruje stale przyszłych zmian szablonu ani treści.