Jak używać
- Wpisz każde pytanie i odpowiedź tak, jak pojawiają się na stronie.
- Dodawaj kolejne pary, zmieniaj ich kolejność lub usuwaj te, których nie potrzebujesz. Niekompletne pary zostaną pominięte i oznaczone.
- Skopiuj skrypt i wklej go do kodu HTML strony, w sekcji head lub body.
- Sprawdź stronę za pomocą walidatora danych uporządkowanych, aby upewnić się, że oznaczenie jest poprawnie odczytywane.
Jak to działa
Generator tworzy obiekt FAQPage schema.org z jednym elementem Question dla każdej pary, a każdy z nich zawiera acceptedAnswer typu Answer. JSON jest tworzony za pomocą właściwego serializatora JSON, więc cudzysłowy, ukośniki odwrotne i znaki nowej linii w tekście są poprawnie escapowane. Dodatkowo każdy znak „<”, „>” i „&” jest zapisywany jako sekwencja ucieczki \u. Dzięki temu tekst taki jak „</script>” lub „<!--” w odpowiedzi nie zamknie przedwcześnie elementu script ani nie uszkodzi strony, a parsery JSON nadal odczytają oryginalne znaki.
Informacje o wynikach z elementami rozszerzonymi: w sierpniu 2023 r. Google ograniczył wyświetlanie rozszerzonych wyników FAQ do uznanych i wiarygodnych witryn rządowych oraz serwisów poświęconych zdrowiu. W przypadku większości pozostałych witryn oznaczenie FAQPage nie powoduje już wyświetlania rozwijanych pytań w wyszukiwarce Google. Nadal jest to poprawne uporządkowane dane opisujące stronę, z których mogą korzystać inne usługi odczytujące dane schema.org.
Warto pamiętać o kilku zasadach: pytania i odpowiedzi zawarte w oznaczeniu muszą być również widoczne na stronie; każde pytanie powinno mieć jedną odpowiedź napisaną przez serwis (na stronach, na których użytkownicy przesyłają odpowiedzi, właściwym typem jest QAPage); oznaczenia nie należy używać do celów reklamowych. Odpowiedzi mogą zawierać prosty kod HTML, na przykład linki i listy, dozwolone przez wytyczne Google w treści odpowiedzi.
Przykłady
Strona pomocy dotycząca produktu
Trzy pytania o dostawę, zwroty i gwarancję tworzą FAQPage z trzema elementami Question. Wklej skrypt raz na stronie pomocy, na której znajdują się te pytania.
Odpowiedź zawierająca kod
Odpowiedź zawierająca „</script>” jest zapisywana w JSON jako \u003c/script\u003e, dzięki czemu znacznik script na stronie pozostaje nienaruszony, a widoczny tekst się nie zmienia.
Często zadawane pytania
Czy oznaczenie FAQ zapewni mojej stronie rozszerzone wyniki w Google?
Prawdopodobnie nie, chyba że jest to uznana i wiarygodna witryna rządowa lub serwis poświęcony zdrowiu. W 2023 r. Google ograniczył rozszerzone wyniki FAQ do takich witryn. Oznaczenie nadal jest poprawne i mogą je odczytywać inne usługi.
Gdzie umieścić skrypt JSON-LD?
W dowolnym miejscu w HTML, w sekcji head lub body. Nie wyświetla żadnych elementów. Dodaj je tylko do strony, na której faktycznie znajdują się te pytania i odpowiedzi.
Czy mogę umieszczać linki w odpowiedziach?
Tak. Wytyczne Google dotyczące FAQ dopuszczają ograniczony zestaw znaczników HTML w treści odpowiedzi, na przykład linki, listy i akapity. Wpisz HTML w odpowiedzi — zostanie bezpiecznie escapowany na potrzeby skryptu.
Dlaczego w wyniku pojawiają się sekwencje \u003c?
To zapis znaku „<” w postaci sekwencji ucieczki JSON. Dzięki takiemu zapisowi tekst w odpowiedziach nie zamknie znacznika script. Każdy czytnik JSON-LD zdekoduje go z powrotem do znaku „<”.
Prywatność
Oznaczenie jest generowane w przeglądarce. Pytania i odpowiedzi nie są nigdzie wysyłane ani zapisywane.