Generator danych strukturalnych (schema JSON-LD)

Jak korzystać z generatora danych strukturalnych

1. Wybierz Typ schematu: strona FAQ, artykuł, organizacja, firma lokalna lub produkt.
2. Wypełnij formularz. Jeśli chcesz zobaczyć, jak wygląda kompletny wpis, zacznij od Wczytaj przykład.
3. Dodaj tyle powtarzalnych elementów, ile potrzebujesz: pytań, autorów, linków do profili, godzin otwarcia czy zdjęć produktu. Każdy wiersz ma własny przycisk Usuń.
4. Obserwuj listę Kontrola: pokazuje, których wymaganych lub zalecanych właściwości brakuje i które wartości wyglądają na błędne, np. względny adres URL albo ocena wyższa niż 5.
5. Kopiuj lub Pobierz wygenerowany blok <script type="application/ld+json"> i wklej go w HTML strony, którą opisuje – w <head> lub w <body>.
6. Sprawdź opublikowaną stronę albo wklejony kod w teście wyników z elementami rozszerzonymi Google (link znajduje się pod kodem).

Czym są dane strukturalne

Dane strukturalne opisują treść strony słownikiem zrozumiałym dla maszyn – schema.org. Wyszukiwarki wykorzystują je, aby zrozumieć, czym jest strona (artykuł, sklep, produkt z ceną), a w przypadku niektórych typów – aby wyświetlać wyniki rozszerzone, takie jak gwiazdki ocen, ceny, godziny otwarcia czy panel wiedzy o twojej organizacji.

JSON-LD to format zalecany przez Google. Znaczniki znajdują się w osobnym bloku skryptu, niezależnie od widocznego HTML, więc łatwo je dodać, zaktualizować albo generować z szablonu. Kod musi opisywać treść, która rzeczywiście jest widoczna na stronie: oznaczanie opinii, cen czy pytań, których odwiedzający nie widzą, narusza wytyczne Google.

Pięć typów w tym narzędziu

• FAQPage: lista pytań z odpowiedziami dla strony, która jest prawdziwym FAQ napisanym przez właściciela witryny (a nie forum). Od sierpnia 2023 roku Google pokazuje wyniki rozszerzone FAQ tylko dla niewielkiej liczby wiarygodnych witryn rządowych i medycznych. Znaczniki są nadal prawidłowe i mogą pomóc innym wyszukiwarkom i narzędziom zrozumieć stronę.
• Article (lub BlogPosting, NewsArticle): nagłówek, obraz, daty i autorzy. Google nie ma ściśle wymaganych właściwości dla artykułów, ale zaleca nagłówek, obraz, autora i daty.
• Organization: nazwa, witryna, logo, dane kontaktowe i linki sameAs do oficjalnych profili. Pomaga wyszukiwarkom powiązać twoją witrynę z marką.
• LocalBusiness: adres, telefon, współrzędne, przedział cenowy i godziny otwarcia, z bardziej szczegółowym typem, np. Restaurant czy Dentist, jeśli taki pasuje. Umieść go na stronie głównej lub na stronie każdej lokalizacji.
• Product: nazwa, zdjęcia, marka, SKU lub GTIN, oferta z ceną, walutą (np. PLN) i dostępnością oraz zbiorcza ocena. Aby pokazać wynik rozszerzony produktu, Google potrzebuje co najmniej oferty, opinii lub oceny.

Szczegóły, o które dba narzędzie

• Puste pola i puste wiersze są pomijane, więc nigdy nie opublikujesz "name": "".
• Ceny przyjmują przecinek lub kropkę (89,50 staje się "89.50"), a dostępność i stan używają pełnych adresów URL schema.org, czego oczekuje Google.
• Godziny otwarcia korzystają z OpeningHoursSpecification, a opcje takie jak „Od poniedziałku do piątku” są rozwijane w listę dni.
• JSON powstaje za pomocą JSON.stringify, a znaki <, > i & są escapowane jako <, > i &, więc tekst zawierający </script> nie może wyjść poza blok skryptu.