Wprowadzenie do Schema.org i danych strukturalnych
Dane strukturalne to ujednolicony format prezentowania informacji o zawartości strony internetowej. Poprzez wdrożenie ustrukturyzowanego kodu, twórcy stron mogą precyzyjnie opisać elementy witryny w sposób zrozumiały dla robotów wyszukiwarek. Standard ten jest rozwijany w ramach inicjatywy Schema.org, która definiuje uniwersalne typy danych oraz powiązane z nimi właściwości.
Głównym celem stosowania danych strukturalnych jest ułatwienie wyszukiwarkom interpretacji kontekstu i znaczenia publikowanych treści. Zamiast polegać wyłącznie na algorytmicznej analizie tekstu, roboty indeksujące otrzymują jednoznaczne deklaracje dotyczące tego, czym jest dany obiekt – na przykład czy dany ciąg znaków to nazwa produktu, cena, czy krok w instrukcji.
Rola formatu JSON-LD w opisie treści
Format JSON-LD (JavaScript Object Notation for Linked Data) jest zalecanym przez wyszukiwarki sposobem wdrażania danych strukturalnych. W przeciwieństwie do starszych metod, takich jak mikrodane czy RDFa, które wymagają modyfikacji kodu HTML bezpośrednio w strukturze znaczników strony, JSON-LD jest wdrażany jako wydzielony blok skryptu.
Skrypt ten umieszcza się zazwyczaj w sekcji <head> lub na końcu sekcji <body> dokumentu HTML. Taka separacja sprawia, że kod jest łatwiejszy w utrzymaniu, edycji oraz generowaniu przez zewnętrzne narzędzia. Generator danych strukturalnych (Schema Markup) automatyzuje ten proces, tworząc gotowy, poprawny składniowo skrypt JSON-LD na podstawie danych wprowadzonych do formularza.
Tworzenie struktury FAQPage
Typ danych FAQPage służy do opisywania stron zawierających sekcje często zadawanych pytań i odpowiedzi. Każde pytanie i odpowiedź muszą być powiązane w logiczne pary. Narzędzie nakłada określone reguły walidacji, aby wygenerowany kod był zgodny ze specyfikacją:
- Wymagane jest dodanie przynajmniej jednej kompletnej pary zawierającej pytanie i odpowiedź. W przypadku braku takich danych edytor wyświetli komunikat: "Dodaj co najmniej jedno kompletne pytanie wraz z odpowiedzią.".
- Każdy element na liście musi posiadać oba uzupełnione pola. Jeśli pole pytania pozostanie puste, pojawi się błąd: "Element
{index}wymaga podania pytania.". W przypadku braku odpowiedzi wyświetlany jest komunikat: "Element{index}wymaga podania odpowiedzi.".
Konfiguracja schematu Product z ofertą
Schemat typu Product pozwala na szczegółowe opisanie asortymentu sklepu internetowego wraz z warunkami handlowymi (ofertą). Narzędzie obsługuje następujące pola wejściowe dla tego typu danych:
| Nazwa pola w interfejsie | Charakterystyka i walidacja |
|---|---|
| Nazwa produktu | Pole wymagane. Brak wpisu generuje błąd: "Dodaj nazwę produktu.". |
| Opis (opcjonalnie) | Opcjonalny tekst opisujący właściwości produktu. |
| URL obrazu (opcjonalnie) | Pełny adres URL. Musi zaczynać się od http:// lub https://. Nieprawidłowy format wywołuje błąd: "Adres URL obrazu musi być pełnym adresem rozpoczynającym się od http:// lub https://.". |
| Marka (opcjonalnie) | Nazwa producenta lub marki produktu. |
| SKU (opcjonalnie) | Unikalny identyfikator magazynowy produktu. |
| Cena | Pole wymagane. Musi to być liczba nieujemna zapisana cyframi, gdzie opcjonalnym separatorem dziesiętnym jest kropka. Błędy walidacji to odpowiednio: "Dodaj cenę oferty." oraz "Cena musi być liczbą nieujemną, zapisaną cyframi, opcjonalnie z kropką jako separatorem dziesiętnym.". |
| Kod waluty | Pole wymagane. Należy wprowadzić trzyznaki standardu ISO 4217 (np. PLN, USD, EUR). Błąd walidacji: "Użyj trzyliterowego kodu waluty, np. PLN, USD lub EUR.". |
| Dostępność | Status dostępności produktu wybierany z listy. |
| URL produktu (opcjonalnie) | Pełny adres URL do strony produktu. Wymaga przedrostka protokołu. Błąd walidacji: "Adres URL produktu musi być pełnym adresem rozpoczynającym się od http:// lub https://.". |
Strukturyzacja instrukcji za pomocą typu HowTo
Typ HowTo opisuje instrukcje krok po kroku, które prowadzą użytkownika do osiągnięcia określonego celu. Struktura ta pozwala na zdefiniowanie wymaganych materiałów, narzędzi oraz poszczególnych etapów procesu:
- Tytuł instrukcji: Pole wymagane. Brak wpisu skutkuje błędem: "Dodaj tytuł instrukcji (how-to).".
- Łączny czas w minutach (opcjonalnie): Czas trwania procesu wyrażony jako liczba całkowita z przedziału od 1 do 100 000. Wprowadzenie wartości spoza tego zakresu generuje błąd: "Łączny czas musi być liczbą całkowitą z przedziału od 1 do 100 000 minut.".
- Materiały (opcjonalnie) i Narzędzia (opcjonalnie): Listy, w których każdą pozycję należy wpisać w osobnym wierszu.
- Kroki instrukcji: Wymagane jest dodanie przynajmniej jednego kroku. Brak kroków wywołuje błąd: "Dodaj co najmniej jeden kompletny krok.". Każdy krok może posiadać opcjonalny "Tytuł kroku (opcjonalnie)" oraz wymagane "Instrukcje kroku". Brak treści instrukcji dla danego kroku skutkuje komunikatem: "Element
{index}wymaga podania instrukcji kroku.".
Zasady działania generatora i przetwarzanie danych
Generator danych strukturalnych (Schema Markup) działa w oparciu o natychmiastową walidację wprowadzanych danych. Pola wymagane są weryfikowane bezpośrednio podczas pisania. Kompletny skrypt JSON-LD zostanie wygenerowany i wyświetlony w sekcji wyjściowej wyłącznie wtedy, gdy wszystkie wymagane pola przejdą pomyślnie walidację. Puste pola opcjonalne są automatycznie pomijane i nie są dołączane do wynikowego kodu.
Narzędzie posiada wbudowane limity techniczne zabezpieczające przed przeciążeniem edytora. Przekroczenie dopuszczalnej liczby znaków w danym polu wywoła błąd: "Pole {field} jest zbyt długie dla tego edytora. Maksymalna długość to {max} znaków.". Z kolei dodanie zbyt wielu pozycji skutkuje komunikatem: "Ten edytor obsługuje maksymalnie {max} elementów jednocześnie.".
Prywatność użytkowników jest w pełni zachowana podczas korzystania z narzędzia. Wszystkie wprowadzane dane, teksty oraz parametry są przetwarzane lokalnie w przeglądarce internetowej użytkownika. Żadne informacje nie są przesyłane do serwerów zewnętrznych ani do serwisu BroBroGo.
FAQ – Najczęściej zadawane pytania
Jakie typy schematów mogę utworzyć?
Dostępne formularze obsługują typy FAQPage, Product (z ofertą) oraz HowTo (z uporządkowanymi krokami, materiałami i narzędziami). Puste pola opcjonalne są automatycznie pomijane w wygenerowanym kodzie.
Gdzie należy umieścić wygenerowany kod JSON-LD?
Wklej kompletny skrypt w sekcji <head> lub <body> strony, której widoczną zawartość opisuje. Pamiętaj, aby dane strukturalne były w pełni zgodne z treściami, które użytkownicy mogą rzeczywiście zobaczyć na stronie.
Czy prawidłowy kod gwarantuje wyświetlenie wyników rozszerzonych (rich results)?
Nie. Prawidłowe wdrożenie danych strukturalnych schema.org pomaga robotom lepiej zrozumieć treść strony, ale nie gwarantuje wyświetlenia elementów rozszerzonych w wynikach wyszukiwania. Google nie wyświetla już wyników rozszerzonych dla FAQ ani HowTo.