JSON-LD

JSON-LD znajduje się w tagu script z typem application/ld+json, zazwyczaj w sekcji head lub body strony. Ponieważ leży oddzielnie od renderowanego kodu, nie przeplatuje atrybutów w kodzie HTML tak jak microdata i RDFa. Dlatego Google go zaleca i dlatego jest najłatwiejszym formatem do dodania, sprawdzenia i usunięcia bez naruszania układu strony. Każdy blok to samodzielny obiekt z @context wskazującym na słownik schema.org i @type określającym typ encji, dzięki czemu maszyna może odczytać stronę jako dane zamiast zgadywać znaczenie z treści.

Jeden blok może opisywać produkt, artykuł, organizację, ścieżkę nawigacyjną (breadcrumb) lub zagregowane oceny opinii; kilka bloków może współistnieć na jednej stronie. Format to zwykły JSON, więc szablon może go generować bez trudności, a walidator może go odczytać. Menedżer tagów może go wstrzyknąć po załadowaniu strony, gdy nie ma bezpośredniego dostępu do szablonu. Encje można też powiązać przez @id: blok Product może wskazywać na Organization sprzedawcy bez powtarzania pełnych danych marki.

Przykład: sklep Shopify sprzedający kosmetyki naturalne. Szablon produktu generuje blok AggregateRating z ratingValue 4,6 dla reviewCount 187, blok Offer z ceną 89,00 i priceCurrency PLN oraz availability InStock, a na każdej stronie oddzielny blok Organization opisujący producenta i jego logo. Gdy sprzedawca organizuje wyprzedaż, motyw musi zaktualizować cenę w JSON w tym samym momencie, w którym zmienia cenę na stronie, inaczej oba wpisy rozbiegają się. Gdy produkt się wyprzeda, availability musi zmienić się na OutOfStock w znacznikach, bo inaczej Google może dalej wyświetlać cenę i dostępność, które już nie obowiązują.

JSON-LD ma znaczenie również dla silników odpowiedzi AI. ChatGPT, Perplexity i Google AI Overviews opierają się na czytelnych, parsowalnych sygnałach przy ocenie, czego dotyczy strona i czy warto ją cytować. Dobrze sformułowany blok usuwa niejednoznaczność co do nazwy produktu, ceny, oceny i sprzedawcy. Nie jest to gwarancja cytowania, a systemy te nadal czytają widoczny tekst, ale dane strukturalne obniżają koszt zrozumienia strony i utrudniają błędną interpretację kluczowych faktów.

JSON-LD musi odpowiadać temu, co widzi odwiedzający. Google traktuje dane strukturalne zgłaszające oceny, ceny lub treści, których nie ma na stronie, jako naruszenie wytycznych i może wstrzymać rich snippety lub nałożyć ręczną karę. Synchronizuj JSON z widoczną treścią, waliduj go po zmianach w szablonie i traktuj go jako wierne odzwierciedlenie strony, a nie miejsce na dodatkowe twierdzenia.