Як користуватися
- Введіть кожне запитання та відповідь так, як вони наведені на сторінці.
- Додавайте пари, переміщуйте їх угору чи вниз або видаляйте непотрібні. Незавершені пари не буде додано, їх буде позначено.
- Скопіюйте скрипт і вставте його в HTML сторінки — у head або body.
- Перевірте сторінку валідатором структурованих даних, щоб переконатися, що розмітка зчитується правильно.
Як це працює
Генератор створює об’єкт FAQPage за schema.org: для кожної пари додає Question із прийнятою відповіддю типу Answer. JSON формує справжній серіалізатор JSON, тому лапки, зворотні скісні риски й переноси рядків у тексті екрануються належним чином. Крім того, кожен символ «<», «>» і «&» записується як escape-послідовність \u. Це не дає тексту на кшталт «</script>» або «<!--» у відповіді передчасно закрити елемент script і порушити роботу сторінки, а парсери JSON усе одно зчитують початкові символи.
Про розширені результати: у серпні 2023 року Google обмежив показ розширених результатів FAQ авторитетними сайтами відомих державних установ і медичних організацій. На більшості інших сайтів розмітка FAQPage більше не показує розгорнуті запитання в Google Search. Вона й надалі є валідними структурованими даними, що описують сторінку, і її можуть використовувати інші сервіси, які працюють із даними schema.org.
Важливі правила: запитання й відповіді в розмітці мають бути видимими на сторінці; на кожне запитання має бути одна відповідь, написана сайтом (для сторінок, де користувачі надсилають відповіді, слід використовувати тип QAPage); розмітку не можна використовувати для реклами. Відповіді можуть містити простий HTML, зокрема посилання й списки, що дозволено рекомендаціями Google для тексту відповідей.
Приклади
Сторінка підтримки товару
Три запитання про доставку, повернення й гарантію перетворюються на FAQPage із трьома елементами Question. Додайте скрипт один раз на сторінку підтримки, де наведено ці запитання.
Відповідь із фрагментом коду
Відповідь із текстом «</script>» в JSON перетворюється на \u003c/script\u003e, тож тег script на сторінці залишається неушкодженим, а видимий текст не змінюється.
Поширені запитання
Чи дасть розмітка FAQ розширені результати для моєї сторінки в Google?
Імовірно, ні, якщо це не авторитетний сайт відомої державної установи чи медичної організації. У 2023 році Google обмежив показ розширених результатів FAQ такими сайтами. Розмітка й далі валідна, і її можуть зчитувати інші сервіси.
Куди додати скрипт JSON-LD?
У будь-якому місці HTML — у head або body. Вона нічого не відображає. Додавайте її лише на сторінку, де справді наведено ці запитання й відповіді.
Чи можна додавати посилання у відповіді?
Так. Рекомендації Google для FAQ дозволяють використовувати в тексті відповіді обмежений набір HTML-тегів, наприклад посилання, списки й абзаци. Введіть HTML у відповіді — для скрипту його буде безпечно екрановано.
Чому у вихідних даних є послідовності \u003c?
Це escape-послідовність JSON для символу «<». Такий запис не дає тексту у ваших відповідях закрити тег script. Будь-який засіб для зчитування JSON-LD перетворить її назад на «<».
Конфіденційність
Розмітка генерується у вашому браузері. Запитання й відповіді нікуди не надсилаються та не зберігаються.