Dobór typu Schema.org, dodanie zgodnych właściwości i walidacja danych strukturalnych pomagają wykryć błędy przed publikacją oraz po wprowadzeniu zmian. Dane strukturalne Schema.org opisują zawartość strony za pomocą określonego typu i jego właściwości. Walidacja przed publikacją pozwala sprawdzić, czy wybrany typ i przypisane do niego właściwości tworzą spójny opis. Dane strukturalne mogą wspierać kwalifikację do elementów rozszerzonych w wynikach wyszukiwania, ale same nie zmieniają zasad indeksowania ani rankingu strony.
Spis treści
Wybierz typ Schema.org zgodny z treścią strony
Schema.org to słownik typów i właściwości używanych do opisywania informacji na stronie. Typ określa, czym jest opisywany obiekt, a właściwości przekazują jego cechy lub dane. Lista dostępnych schematów znajduje się w dokumentacji Schema.org: Schemas.
Wybierz typ na podstawie rzeczywistej treści, a nie na podstawie oczekiwanego efektu w wynikach wyszukiwania. Dla przykładu Product służy do opisu produktu i jest osobnym typem Schema.org opisanym w dokumentacji Product.
- Określ główny obiekt opisany na stronie.
- Wybierz jeden typ, który najlepiej odpowiada temu obiektowi.
- Sprawdź definicję tego typu i używaj właściwości przewidzianych dla wybranego schematu.
- Nie dodawaj typu tylko dlatego, że może być kojarzony z innym rodzajem wyniku wyszukiwania.
Dodaj tylko informacje widoczne i zgodne z treścią
Każda właściwość powinna opisywać faktyczny element obiektu. Dane strukturalne nie powinny tworzyć alternatywnej wersji strony ani zawierać informacji, których użytkownik nie może powiązać z jej treścią.
Przed publikacją sprawdź każdą wartość w trzech krokach:
- czy właściwość należy do wybranego typu,
- czy wartość ma format oczekiwany dla tej właściwości,
- czy wartość jest zgodna z informacją przedstawioną na stronie.
Opis typu i właściwości sprawdzaj w dokumentacji Schema.org oraz w dokumentacji konkretnej właściwości: Property. Nie zastępuj właściwości podobnie brzmiącą nazwą z innego typu.
Zweryfikuj implementację przed publikacją
Walidację wykonaj na opublikowanym kodzie strony albo na wersji testowej, która odtwarza docelową implementację. Sprawdź jednocześnie strukturę danych, nazwy typów, nazwy właściwości i wartości.
- Otwórz stronę z wdrożonymi danymi strukturalnymi.
- Przejrzyj znalezione typy i właściwości.
- Porównaj je z definicją wybranego schematu w dokumentacji Schema.org.
- Usuń nieznane właściwości, literówki i wartości przypisane do niewłaściwego typu.
- Powtórz walidację po każdej zmianie szablonu lub danych.
Dokumentacja Schema.org opisuje sposób organizacji schematów i ich elementów w ramach słownika: Getting started. Wynik walidacji traktuj jako kontrolę zgodności implementacji ze schematem, a nie jako gwarancję określonego miejsca w wynikach wyszukiwania.
Rozwiąż najczęstsze błędy walidacji
Nieznany typ
Ten komunikat zwykle oznacza literówkę albo użycie nazwy, która nie jest typem w wybranym schemacie. Porównaj nazwę z dokumentacją Schema.org i sprawdź wielkość liter.
Nieznana właściwość
Sprawdź, czy właściwość należy do użytego typu. Jeśli nie, usuń ją albo wybierz typ odpowiadający rzeczywistemu obiektowi. Nie zastępuj błędnej właściwości przypadkową nazwą o podobnym znaczeniu.
Brak wartości
Uzupełnij wartość tylko wtedy, gdy wynika z treści strony i odpowiada definicji właściwości. Gdy strona nie zawiera danej informacji, bezpieczniej usunąć tę właściwość niż wstawiać pustą lub domyśloną wartość.
Nieprawidłowy format wartości
Porównaj format użytej wartości z opisem właściwości. Błąd może wynikać z wpisania tekstu w miejscu, w którym schemat oczekuje innego rodzaju danych, albo z przypisania wartości do niewłaściwego pola.
Monitoruj dane po publikacji
Po wdrożeniu ponownie sprawdź stronę, ponieważ zmiana szablonu, treści lub danych może zmienić wygenerowany opis. Zapisuj typy i właściwości wykryte podczas kolejnych kontroli oraz analizuj nowe ostrzeżenia.
- Najpierw popraw błędy, które wskazują na niezgodność typu, właściwości lub wartości.
- Następnie przejrzyj ostrzeżenia i usuń te, które wynikają z niepełnych lub niespójnych danych.
- Po poprawkach wykonaj walidację ponownie.
Ostrzeżenie nie jest podstawą do dodawania przypadkowych pól. Każda zmiana powinna nadal odpowiadać definicji wybranego typu i treści strony.
Kiedy potrzebny jest developer
Poproś developera o pomoc, gdy dane są generowane automatycznie przez szablon, zmiana wymaga edycji kodu wielu stron albo błąd powraca po zapisaniu treści. Wsparcie techniczne jest też wskazane, gdy trzeba poprawić mapowanie danych z bazy, wdrożyć zmianę na wielu podstronach lub bezpiecznie wycofać wadliwą wersję.
Przed zmianą kodu zachowaj kopię aktualnej wersji i przetestuj poprawkę na jednej stronie lub w środowisku testowym. Po wdrożeniu sprawdź ponownie kod strony oraz wynik walidacji.
Najważniejsza zasada wdrożenia
Najpierw dopasuj typ Schema.org do rzeczywistej treści, potem dodaj zgodne właściwości, zwaliduj implementację i monitoruj ją po publikacji. Dane strukturalne opisują stronę, ale nie zastępują jakości treści i nie stanowią bezpośredniej zmiany indeksowania ani rankingu.