Формат микроразметки JSON-LD: что это такое

Опубликовано Сен 8, 2025

Алексей Штарев

CEO PromoPult

Сейчас читают

Встречайте Диджитал-Хэллоуин 2025

Подписка на VK Музыку: как оформить, оплатить и отключить

Для лучшего понимания поисковыми роботами структуры и сущности контента на сайте используется микроразметка. Результат ее внедрения — улучшение внешнего вида сниппетов в результатах поиска и как следствие повышение их кликабельности.

Сравните, какая ссылка информативнее и привлекательнее для пользователя:

В статье рассказываем о формате разметки JSON-LD — в чем его преимущества и какие инструменты помогут его внедрить, даже если вы не разбираетесь в программировании.

Содержание

Почему стоит использовать JSON-LD

Внедряют микроразметку с помощью разных видов синтаксиса (то есть способов размечать данные в коде HTML-страницы):

микроформатов (hCard, hCalendar и др.);
микроданных (microdata);
RDFa;
JSON-LD.

Недостаток первых трех способов в громоздкости синтаксиса и необходимости добавлять HTML-код внутрь тега <body>. Для упрощения работы используется формат передачи данных JSON-LD.

JSON-LD («JavaScript Object Notation for Linked Data») — дословно «объектная нотация JavaScript для связанных данных». Формат разработан в 2010 году консорциумом W3C для упрощения передачи связанных данных, в частности, дает возможность размечать страницы с помощью словаря Schema.org. Работает на базе текстового формата JSON.

О том, чем отличается словарь семантической разметки (например, Schema.org) от ее синтаксиса (например, JSON-LD), а также как настроить микроразметку Schema.org без помощи программиста, мы писали здесь.

JSON-LD отличается рядом преимуществ по сравнению с HTML-разметкой:

содержит меньше кода, чем microdata или RDFa, проще воспринимается;
рекомендован Google в качестве основного способа микроразметки;
для популярных CMS есть плагины, которые позволяют быстро внедрить микроразметку;
разметка внедряется посредством JavaScript и видна только поисковым роботам.

Яндекс и Google прекрасно воспринимают этот формат. Страницы с JSON-LD также проходят валидацию в обоих поисковиках.

Синтаксис JSON-LD

Google рекомендует внедрять код JSON-LD в тег <head>. Хотя работать он будет и в теге <body>.

Базовая конструкция разметки JSON-LD (неизменяемая):

<script type="application/ld+json"> { //между фигурными скобками указываются элементы разметки } </script>

Эта конструкция сообщает браузеру, что будет обращение к JavaScript, содержащему JSON-LD.

Синтаксис JSON-LD и JSON идентичен. Разница лишь в том, что в JSON-LD есть так называемые зарезервированные ключи, которые позволяют задать контекст описания или связать объекты. Так, ключ @context указывает на словарь объектов, а @type — на тип сущности. Всего таких ключей 23 — все они описаны на официальном сайте W3.org.

Как видите, наличие атрибутов в микроразметке — не гарантия, что все они появятся в сниппете. Тем не менее они точно будут учтены поисковой системой при определении релевантности страницы поисковому запросу и могут положительно влиять на ранжирование.

Перед внедрением микроразметки советуем ознакомиться с рекомендациями по использованию структурированных данных от Google.

в Promopult: все инструменты для улучшения качества сайта и продвижения в поисковиках. Полный комплекс работ — с нами вы не упустите ни одной мелочи. Чек-листы, подсказки, прозрачная отчетность и рекомендации профессионалов. Протестировать можно 2 недели бесплатно.
Реклама. ООО «Клик.ру», ИНН:7743771327, ERID: 2VtzqufjHvb

Полезные инструменты для работы с JSON-LD

Перед тем как внедрять микроразметку на основе JSON-LD, желательно разобраться с синтаксисом, чтобы понимать общую логику. Но вручную прописывать код трудоемко.

Для ускорения работы используйте один из генераторов:

webcode.tools — комплексный генератор кодов, содержит 13 типов сущностей для JSON-LD, в каждой сущности самые актуальные атрибуты.

okocrm.com — удобный генератор, включает 14 популярных типов сущностей: статья, рецепт, хлебные крошки, персона, ресторан, организация, совокупный рейтинг, вопрос-ответ, видео и другие.

searchbloom.com — простой генератор, содержит 12 типов сущностей для JSON-LD с популярными атрибутами для каждой.

После того как вы сгенерировали скрипт, не спешите размещать его на сайте. Сначала пройдите валидацию:

в Google — c помощью инструмента проверки расширенных результатов;
в Яндексе — с помощью Валидатора микроразметки.

Обратите внимание, что Google не гарантирует показ расширенного сниппета в результатах поиска даже в том случае, когда инструмент проверки не нашел ошибок на страницах с микроразметкой.

Если вы внедрили микроразметку, успешно прошли проверку, но расширенного сниппета в выдаче все равно нет, возможно, дело в следующем:

структурированные данные на вашей странице не соответствуют контенту и вводят пользователя в заблуждение;
контент на размеченной странице не актуален для конкретного пользователя в данный момент (с учетом его локации, истории поиска и других факторов);
контент скрыт от пользователя.

Больше причин, по которым расширенный сниппет не отображается в Google, мы разобрали тут.

Если ваш сайт работает на одной из популярных CMS, для создания JSON-LD разметки можно использовать плагины.

Для WordPress: Schema App Structured Data, Schema & Structured Data for WP & AMP, WP SEO Structured Data Schema.
Для Joomla!: TF Structured Data, TF Structured Data, Google Structured Data.
Для Drupal: JSON LD Schema API, Schema.org Metatag.

В дальнейшем можно отслеживать проблемы на страницах с микроразметкой в специальных отчетах Google Search Console в разделе «Улучшения»:

В этом разделе будут отображаться отчеты о страницах с типами расширенных результатов, которые Google обнаружил на вашем сайте. Важный момент — этот тип должен поддерживаться Google. Возможные типы: строки навигации, мероприятие, вакансии, рецепт и другие. Полный список поддерживаемых типов расширенных результатов — здесь.

Заключение

JSON-LD — это только один из способов микроразметки. Поисковики понимают и другие форматы, поэтому, если на вашем сайте уже внедрена микроразметка и в поиске отображаются расширенные сниппеты, не стоит проводить лишнюю работу и переходить на JSON-LD.

JSON-LD выгодно использовать, когда у вас вообще нет микроразметки, при этом основная аудитория переходит на сайт из Google. Также возможен вариант одновременного внедрения JSON-LD и разметки на базе HTML.

Алексей Штарев

CEO PromoPult

Источник: blog.promopult.ru