JSON-LD: формат структурированных данных

JSON-LD — формат записи структурированных данных. Данные лежат в отдельном блоке <script type="application/ld+json"> в HTML и не смешиваются с вёрсткой. Это рекомендуемый способ вставить разметку Schema.org.

Пример

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Пример",
  "url": "https://example.ru"
}
</script>

@context указывает словарь, @type — тип сущности, остальные поля — свойства этого типа.

Почему он удобнее микроразметки

Микроданные требуют проставлять атрибуты прямо в тегах вёрстки, и при каждом изменении шаблона их легко сломать. JSON-LD — отдельный блок: данные собираются из одного источника (контента) и выдаются шаблоном, а не переписываются руками на каждой странице. Это делает разметку согласованной с текстом страницы.

Где размещать

В <head> или <body>, неважно: поисковики читают оба места. Главное, чтобы данные были в первичном HTML, который отдаёт сервер. Если блок добавляется скриптом уже в браузере, Яндекс может его не увидеть (рендеринг — одна из причин).

Как проверить

1. Откройте исходный код страницы и найдите ld+json.
2. Проверьте валидатором Google «Проверка расширенных результатов» и валидатором Яндекса.
3. Убедитесь, что JSON корректен: лишняя запятая делает весь блок невалидным.

Типичные ошибки

• Данные в JSON-LD не совпадают с текстом страницы: цена в разметке одна, на странице другая.
• Блок подгружается скриптом уже в браузере.
• Лишняя запятая или незакрытая скобка.
• Один и тот же тип добавлен несколько раз с разными значениями.
• Используется свойство, которого нет у этого типа.

Как это сделано у нас

Разметка собирается шаблоном из данных сайта, а не пишется на каждой странице вручную: на всех страницах стоят Organization и WebSite, на внутренних — BreadcrumbList, у услуг — Service с ценой «от», у статей — Article с автором, у вопросов и ответов — FAQPage. Так разметка не расходится с текстом страницы: оба берутся из одного источника.