Podstawy danych strukturalnych JSON-LD

Dane strukturalne to przeznaczony do odczytu maszynowego JSON opisujący temat strony — artykuł, przepis, produkt lub wydarzenie. Wyszukiwarki używają go do wyświetlania wyników rozszerzonych (ocen w postaci gwiazdek, kart przepisów, ścieżek nawigacyjnych) zamiast zwykłych niebieskich linków.

Preferowanym przez Google formatem jest JSON-LD: pojedynczy blok <script type="application/ld+json"> w elemencie head lub body, zawierający jeden lub więcej obiektów schema.org. Jest on niezależny od widocznego HTML, dlatego jego dodanie lub aktualizacja nie wymaga zmiany szablonu.

Każdy obiekt JSON-LD potrzebuje @context (niemal zawsze "https://schema.org") oraz @type (klasy schema.org: Article, Recipe, Product, FAQPage). @context informuje parsery, z jakiego słownika pochodzą nazwy właściwości.

Dla Article należy podać headline, image (adres URL lub tablicę), datePublished, dateModified, author (obiekt Person lub Organization) oraz publisher (Organization z logo). Są to minimalne pola potrzebne, aby Google uwzględnił stronę w karuzeli najważniejszych artykułów.

Strony produktów deklarują @type Product wraz z name, image, description, brand, sku oraz podobiektem offers zawierającym price, priceCurrency i availability. W połączeniu z aggregateRating pozwala to Google wyświetlać oceny w postaci gwiazdek i fragmenty z ceną bezpośrednio w wyniku wyszukiwania.

BreadcrumbList opisuje hierarchię nawigacji. Każdy itemListElement jest elementem ListItem zawierającym position, name i item (adres URL). Gdy dane te są dostępne, Google zastępuje wiersz z adresem URL we fragmencie wyników oznaczoną ścieżką nawigacyjną, co zwiększa liczbę kliknięć.

Wcześniej schematy FAQPage i HowTo odblokowywały rozbudowane elementy wyników wyszukiwania w SERP. Od tego czasu Google ograniczyło rozbudowane wyniki FAQ do kilku kategorii witryn (rządowych i edukacyjnych), ale oznaczenia te nadal są wartościowe dla asystentów głosowych i innych odbiorców — należy zachować je na rzeczywistych stronach FAQ.

Google nakłada kary za oznaczenia, które nie odpowiadają temu, co widzą użytkownicy. Nie należy deklarować oceny 5 gwiazdek, jeśli nie jest ona widoczna na stronie, ani podawać ceny 9,99 USD, której użytkownik nie widzi. Dane strukturalne muszą dokładnie opisywać wyrenderowaną treść.

Narzędzie Rich Results Test firmy Google (search.google.com/test/rich-results) analizuje dowolny adres URL lub wklejony kod, wyświetla wykryte typy schematów i ostrzega o brakujących wymaganych właściwościach. Należy uruchomić je przed wdrożeniem jakiejkolwiek zmiany w danych strukturalnych.

Na tej samej stronie można zadeklarować kilka bloków JSON-LD (na przykład Article + BreadcrumbList + Organization) albo połączyć je w pojedynczej tablicy @graph. Obie formy są prawidłowe — należy wybrać tę, którą łatwiej uwzględnić w szablonach używanych w procesie budowania.

JSON-LD znajduje się w tagu script oddzielonym od widocznej treści. Aby go zaktualizować, należy wygenerować blok JSON ponownie — nigdy nie należy wstrzykiwać danych strukturalnych wyłącznie za pomocą JavaScriptu po stronie klienta, ponieważ Googlebot nie zawsze niezawodnie wykonuje JavaScript przed indeksowaniem.

Jakie dwie właściwości najwyższego poziomu musi zawierać każdy obiekt JSON-LD, aby stanowił prawidłowe dane strukturalne?

JSON-LD deklaruje dane strukturalne w pojedynczym bloku skryptu application/ld+json, a właściwości @context i @type identyfikują każdy obiekt. Typowe schematy (Article, Product, BreadcrumbList) odblokowują rozbudowane wyniki wyszukiwania, gdy oznaczenia dokładnie odzwierciedlają widoczną stronę. Przed wdrożeniem należy przeprowadzić walidację za pomocą Rich Results Test.