Jak sprawdzić dane strukturalne JSON-LD na stronie internetowej

Sprawdź JSON-LD na dowolnej stronie internetowej pod kątem błędów i brakujących pól, zobacz każdy opisany element schema.org i wyświetl JSON każdego bloku.

3 min czytania


Walidator JSON-LD po sprawdzeniu artykułu w Wikipedii o gumowej kaczuszce: jeden blok bez problemów, jeden element typu Article i kod JSON bloku
Walidator JSON-LD po sprawdzeniu artykułu w Wikipedii o gumowej kaczuszce: jeden blok bez problemów, jeden element typu Article i kod JSON bloku

Aby sprawdzić JSON-LD na stronie internetowej, otwórz Walidator JSON-LD, wklej adres strony i kliknij „Pobierz i sprawdź JSON-LD”. Wynik zawiera wszystkie problemy, wszystkie elementy opisane na stronie oraz kod JSON każdego bloku. Jeśli strona nie zawiera problemów, podsumowanie jest zielone.

Jak sprawdzić stronę

  1. Otwórz stronę w przeglądarce i skopiuj adres z paska adresu.
  2. Wklej go w pole URL. Jeśli adres nie zawiera https://, zostanie ono dodane automatycznie.
  3. Kliknij „Pobierz i sprawdź JSON-LD”.
  4. Przeczytaj podsumowanie nad tabelami. Zawiera ono liczbę bloków, błędów i ostrzeżeń.
  5. Wybierz blok w sekcji Źródło, aby zobaczyć jego kod JSON z numerami wierszy.

Jak odczytać wynik

  • Tabela problemów zawiera wszystkie błędy i ostrzeżenia. Pojawia się tylko wtedy, gdy występuje problem.
  • Blok to numer bloku skryptu, liczony od góry strony.
  • Lokalizacja wskazuje miejsce wystąpienia problemu, na przykład Product.image.
  • Tabela elementów zawiera każdy element wraz z jego typem, na przykład Article lub Product, i nazwą.
  • Kliknij nagłówek kolumny, aby posortować tabelę. Przyciski pod każdą tabelą umożliwiają wyeksportowanie jej do CSV lub JSON.

Które problemy naprawić w pierwszej kolejności

Błędy znajdują się na początku listy i są oznaczone na czerwono. Ostrzeżenia są oznaczone na żółto. Błąd oznacza, że coś jest nieprawidłowe lub brakuje wymaganego pola. Ostrzeżenia oznaczone jako „(opcjonalne)” dotyczą pól, które możesz dodać, jeśli masz potrzebne dane.

Te komunikaty można łatwo naprawić.

Komunikat Rozwiązanie
Nieprawidłowy JSON Sprawdź, czy nie brakuje przecinka lub cudzysłowu albo czy po ostatniej wartości nie ma zbędnego przecinka.
Brak @context, dodaj "@context": "https://schema.org" Dodaj tę linię do bloku.
Brak @type Dodaj typ, na przykład "@type": "Product".
„@Type” nie jest słowem kluczowym JSON-LD Zapisuj słowa kluczowe małymi literami: @type.
Typ „Organisation” nie jest prawidłowym typem schema.org Użyj dokładnej nazwy z schema.org, w tym przypadku Organization.
Brak wymaganego atrybutu „image” Dodaj pole wymienione w komunikacie.

Gdy sprawdzanie niczego nie znajduje lub kończy się niepowodzeniem

„Na tej stronie nie znaleziono bloków skryptów JSON-LD” oznacza, że kod HTML strony nie zawiera JSON-LD. Sprawdzanie odczytuje stronę w takiej postaci, w jakiej wysyła ją serwer. Nie wykrywa JSON-LD dodanego później przez skrypt w przeglądarce.

„Nie udało się pobrać strony” oznacza, że witryna nie wysłała strony. Dzieje się tak również wtedy, gdy adres przekierowuje do innego adresu, ponieważ przekierowania nie są obsługiwane. Skopiuj końcowy adres z paska adresu i spróbuj ponownie.

Sprawdzane są tylko pierwsze 3 MB strony. Jeśli strona jest większa, pojawi się odpowiedni komunikat.

Napraw błędy, zaktualizuj stronę i ponownie ją sprawdź.

Chcesz wypróbować samodzielnie?


Walidator JSON-LD

Wprowadź URL, a serwer pobierze stronę, wyodrębni każdy blok danych strukturalnych JSON-LD i sprawdzi go pod kątem błędów składni JSON, brakujących właściwości @context i @type, nieznanych typów i właściwości schema.org oraz pól wymaganych przez Google do wyświetlania wyników z elementami rozszerzonymi.

Otwórz narzędzie

Udostępnij