Najpierw ustal, jaką ścieżkę widzi użytkownik
Okruszki nawigacyjne pokazują miejsce bieżącej strony w strukturze serwisu. W sklepie mogą prowadzić od strony głównej przez kategorię „Oświetlenie” i podkategorię „Lampy biurkowe” do karty produktu. W poradniku podobna ścieżka może łączyć stronę główną, dział tematyczny i artykuł. BreadcrumbList służy do opisania takiej ścieżki w danych uporządkowanych; samo oznaczenie nie tworzy jednak nawigacji widocznej dla odwiedzających.
Zanim dodasz kod, sprawdź okruszki na stronie. Czy ich kolejność jest logiczna? Czy nazwy odpowiadają miejscom, do których prowadzą linki? Czy ostatni element wskazuje bieżącą stronę? Okruszki powinny odzwierciedlać strukturę serwisu, a nie historię kliknięć konkretnej osoby. Jeśli użytkownik trafił na produkt z wyszukiwarki wewnętrznej, ścieżka „Wyniki wyszukiwania → Produkt” zwykle nie będzie dobrym opisem jego stałego miejsca w witrynie.
Najprostsza zasada brzmi: oznaczaj tę ścieżkę, którą rzeczywiście prezentujesz na danej stronie. Jeśli szablon wyświetla „Strona główna → Poradniki → Montaż lampy”, dane uporządkowane nie powinny po cichu dodawać kategorii „Oświetlenie” ani pomijać „Poradników”. Rozbieżność utrudnia kontrolę wdrożenia i może wprowadzać w błąd co do hierarchii witryny.
Jak zbudować BreadcrumbList w JSON-LD
BreadcrumbList składa się z elementów ListItem ułożonych w kolejności ścieżki. Każdy z nich ma position, czyli numer miejsca na liście, oraz name, czyli nazwę okruszka. W polu item można podać adres strony reprezentowanej przez dany element. Pozycje zaczynają się od 1 i rosną kolejno, bez luk i powtórzeń.
Dla ścieżki „Strona główna → Poradniki → Montaż lampy” pierwszy ListItem opisuje stronę główną, drugi dział poradników, a trzeci bieżący artykuł. Jego name powinno odpowiadać nazwie widocznej w okruszkach; nie musi być identyczne z pełnym tytułem dokumentu, jeśli interfejs celowo używa krótszej etykiety. Adresy w item powinny prowadzić do właściwych stron, a nie do przypadkowych wariantów URL lub stron przekierowujących.
JSON-LD bywa wygodny, ponieważ można go wygenerować w szablonie strony bez dodawania atrybutów do każdego widocznego linku. Nie zwalnia to jednak z utrzymywania obu wersji z tych samych danych. Jeśli nazwa kategorii zmienia się w systemie zarządzania treścią, poprawka powinna trafić zarówno do nawigacji, jak i do BreadcrumbList. Przy wdrożeniu szablonowym warto ustalić jedno źródło nazw, adresów i kolejności elementów.
Kiedy hierarchia wymaga dodatkowej decyzji
Nie każda witryna ma jedną oczywistą ścieżkę do strony. Produkt może należeć do kilku kategorii, a artykuł może być widoczny w kilku działach. W takiej sytuacji wybierz ścieżkę, która ma sens jako stała nawigacja dla użytkownika i jest zgodna z okruszkami pokazanymi na stronie. Nie dobieraj kategorii wyłącznie po to, by umieścić w oznaczeniu dodatkowe słowa kluczowe.
Jeżeli serwis rzeczywiście pokazuje różne poprawne ścieżki zależnie od kontekstu, zadbaj o spójną regułę ich prezentacji i oznaczania. Szczególnej uwagi wymagają strony dostępne pod kilkoma adresami oraz kategorie z filtrami. Sprawdź, czy adresy podawane w okruszkach prowadzą do zamierzonych stron i czy szablon nie miesza ścieżki dla bieżącego widoku ze ścieżką innego wariantu URL.
Ostatni okruszek bywa tekstem bez klikalnego linku. To normalne rozwiązanie w interfejsie: użytkownik już znajduje się na tej stronie. Przy przygotowaniu danych uporządkowanych upewnij się przede wszystkim, że nazwa i pozycja ostatniego elementu opisują właśnie bieżącą stronę. Nie dodawaj fikcyjnego poziomu hierarchii tylko dlatego, że jakiś szablon zawsze generuje tę samą liczbę elementów.
Typowe błędy przy oznaczaniu okruszków
Częsty błąd to wygenerowanie BreadcrumbList niezależnie od widocznej nawigacji. Przykładowo użytkownik widzi „Strona główna → Blog → Wpis”, a kod opisuje „Strona główna → Oferta → Wpis”. Innym problemem jest zamiana kolejności: pierwszy element kodu wskazuje wpis, choć w interfejsie ścieżka zaczyna się od strony głównej. Oba przypadki można wykryć przez proste porównanie elementów jeden do jednego.
Uważaj również na puste nazwy, powielone wartości position i linki prowadzące do nieistniejących stron. Przy witrynach wielojęzycznych sprawdź, czy polskie okruszki nie otrzymały adresów wersji w innym języku. W sklepie warto przetestować więcej niż jedną kartę produktu: poprawne oznaczenie na przykładzie z jednej kategorii nie dowodzi, że szablon dobrze obsługuje produkty przypisane do kilku działów.
Poprawny kod nie gwarantuje określonego wyglądu wyniku wyszukiwania. Celem wdrożenia jest rzetelne opisanie nawigacji, nie obietnica dodatkowej ekspozycji. Dlatego naprawę warto zaczynać od faktycznej struktury i widocznych okruszków, a dopiero potem od składni danych uporządkowanych.
Krótka lista kontroli po wdrożeniu
Otwórz kilka reprezentatywnych adresów: stronę kategorii, artykuł, produkt oraz stronę z bardziej złożoną ścieżką. Dla każdej porównaj kolejność i nazwy widocznych okruszków z elementami BreadcrumbList. Następnie sprawdź, czy position rośnie od 1, czy adresy item prowadzą do właściwych miejsc i czy ostatni element opisuje bieżącą stronę.
Na koniec zweryfikuj wygenerowany kod narzędziem do testowania danych uporządkowanych i obejrzyj stronę po załadowaniu, zwłaszcza jeśli nawigację tworzy JavaScript. Test składni nie zastąpi kontroli treści: narzędzie może zaakceptować listę, która opisuje inną ścieżkę niż widoczna dla człowieka. Po zmianach w architekturze serwisu wróć do tych samych przykładów, aby upewnić się, że okruszki i ich oznaczenie nadal pozostają zgodne.
