Почему разметка Schema-org не генерируется: симптомы и причины
Если генератор не выдает JSON-LD или предупреждение появляется прямо после отправки формы, проверьте частые сценарии:
- Пустое главное поле сущности. Без названия или основного значения выбранного типа (Product, Article, FAQPage) генерация не запустится.
- Склеенные пункты списков. Для FAQPage и BreadcrumbList каждый пункт вводится отдельной строкой: несколько значений в одной строке ломают структуру.
- Неверный формат даты. Поле даты статьи принимает строго
ГГГГ-ММ-ДД; другие форматы приводят к ошибке валидации.
Ниже - как заполнить каждое поле, какие форматы поддерживаются и как проверить готовый код перед вставкой на сайт.
Быстрый ответ: как сгенерировать разметку без ошибок
Чтобы быстро получить корректный код микроразметки для сайта, выберите тип сущности в Генераторе шаблонов, заполните поля формы и нажмите кнопку «Сгенерировать JSON-LD». Инструмент Zyntec сформирует готовый блок кода внутри тега script, который можно скопировать одной кнопкой и вставить в секцию head целевой страницы.
Подготовка данных под разные сценарии
Перед началом работы выберите тип разметки и подготовьте параметры:
- Product (товар): обязательным является поле «Название». Дополнительно можно заполнить описание, URL изображения, бренд, SKU/артикул, цену, валюту ISO (по умолчанию установлена RUB) и выбрать статус наличия («В наличии», «Нет в наличии» или «Предзаказ»).
- Article (статья): требуется указать заголовок (обязательное поле), а также можно добавить описание, URL изображения, автора и дату публикации в формате YYYY-MM-DD.
- Organization (организация): обязательным является название компании. Дополнительные поля включают URL сайта, URL логотипа, описание и контактный телефон.
- FAQPage (вопросы-ответы): необходимо ввести вопросы и ответы. Каждый вопрос и каждый ответ вносятся строго по одному на строку (оба поля обязательны).
- BreadcrumbList (хлебные крошки): требует ввода навигационной цепочки в формате «Имя|URL», по одной записи на каждую строку.
Пошаговое решение
- Выберите тип разметки. В выпадающем списке укажите нужный вариант: Product, Article, Organization, FAQPage или BreadcrumbList.
- Заполните форму. Внесите обязательные значения и дополнительные сведения о позиции или странице.
- Запустите генератор. Нажмите кнопку «Сгенерировать JSON-LD».
- Скопируйте результат. Нажмите кнопку копирования рядом с блоком готового кода.
- Внедрите на сайт. Вставьте полученный тег script с JSON-LD в блок head нужной страницы.
Воспроизводимый пример для карточки товара
Чтобы разметить карточку товара с ценой и наличием, внесите следующие параметры: - Тип: Product; - Название: Беспроводные наушники; - Описание: Наушники с активным шумоподавлением; - Бренд: SoundPro; - SKU/Артикул: SP-100; - Цена: 4990; - Валюта ISO: RUB; - Наличие: В наличии.
После нажатия кнопки «Сгенерировать JSON-LD» сервис выдает готовый фрагмент:
<script type="application/ld+json">
{
"@type": "Product",
"name": "Беспроводные наушники",
"description": "Наушники с активным шумоподавлением",
"brand": {
"@type": "Brand",
"name": "SoundPro"
},
"sku": "SP-100",
"offers": {
"@type": "Offer",
"price": "4990",
"priceCurrency": "RUB",
"availability": "InStock"
}
}
</script>
Ограничения инструмента
- Обязательные поля: генерация разметки Schema-org не запустится, если главное поле сущности оставлено пустым.
- Форматирование строк: для списков FAQPage и цепочек BreadcrumbList важно соблюдать построчный перенос без объединения нескольких пунктов в одну строку.
- Формат даты: для статей поддерживается строго формат YYYY-MM-DD.
- Проверка ссылок: инструмент формирует JSON-LD на основе переданного текста, поэтому корректность введенных URL сайта и изображений следует проверить до копирования кода.
Возможные ошибки и их решение
- Ошибка «Заполните поле «Название»». Появляется, если не заполнено ключевое обязательное поле выбранного типа (название товара, организации или заголовок статьи). Чтобы устранить предупреждение, введите наименование объекта и повторите генерацию.
- Некорректное сопоставление вопросов и ответов в FAQPage. Возникает, если число строк в поле вопросов отличается от числа строк в ответах. Убедитесь, что каждому вопросу на отдельной строке соответствует свой ответ на аналогичной строке.
- Сбой в хлебных крошках BreadcrumbList. Проверьте, чтобы разделителем между текстом ссылки и адресом выступал символ «|» без лишних пробелов вокруг него.