JSON-LD или Microdata: какой формат микроразметки выбрать

Словарь Schema.org описывает, какие типы объектов и свойства существуют: товар, организация, статья, цена, автор. Но записать эти данные в код страницы можно разными способами. Самые распространённые форматы — JSON-LD, Microdata и RDFa. Поисковики понимают все три, но у каждого свои особенности для разработки и поддержки.

JSON-LD

Данные записываются отдельным блоком в теге script с типом application/ld+json. Это структура JSON, которая не связана с видимой вёрсткой: её можно разместить в head или в конце body. Google официально рекомендует JSON-LD как предпочтительный формат, если сайт позволяет его использовать.

Плюсы:

• Разметка отделена от дизайна: редизайн не ломает структурированные данные
• Её легко генерировать из данных CMS или базы
• Удобно проверять и читать: всё в одном месте
• Можно добавить или изменить без правки шаблонов вёрстки

Минус: данные дублируют то, что уже есть на странице, и их нужно держать синхронными с видимым содержимым.

Microdata

Разметка встраивается прямо в HTML-теги с помощью атрибутов itemscope, itemtype и itemprop. Например, у блока карточки указывается тип Product, у заголовка — свойство name, у цены — price. Данные берутся из того же текста, что видит посетитель.

Плюсы:

• Нет дублирования: разметка и содержимое совпадают по определению
• Подходит, когда нет возможности добавить отдельный скрипт

Минусы:

• Разметка размазана по шаблону, её сложнее проверять
• Любое изменение вёрстки может нарушить структуру
• Сложные вложенные объекты превращаются в громоздкий код

RDFa

Похожий на Microdata подход с атрибутами vocab, typeof и property. Встречается реже, исторически используется в некоторых CMS. Для новых проектов обычно не выбирается.

Как к форматам относится Яндекс

Яндекс поддерживает Schema.org во всех трёх форматах, а также собственные форматы для отдельных сервисов. Его валидатор микроразметки в Вебмастере проверяет и JSON-LD, и атрибутную разметку. Поэтому для сайтов с аудиторией и в Google, и в Яндексе формат JSON-LD подходит без ограничений.

Где хранить JSON-LD в CMS

В WordPress разметку обычно выводит SEO-плагин, и её можно дополнять через его настройки или фильтры темы. В Битриксе — компонентами или шаблонами сайта. На фреймворках вроде Next.js — отдельным компонентом, который получает данные страницы и выводит скрипт на сервере. В любом случае избегайте ручной вставки одинакового кода в каждую страницу: такая разметка быстро устаревает.

Можно ли смешивать

Технически допускается: одна сущность в JSON-LD, другая в Microdata. Но описывать один и тот же объект двумя форматами одновременно не стоит — поисковик увидит два товара или две организации, и в отчётах появятся дубли. Частая ситуация: тема CMS выводит Microdata, а SEO-плагин добавляет JSON-LD. Выберите одно и отключите второе.

Как выбрать для своего сайта

• Новый сайт или редизайн — JSON-LD, генерируемый из данных
• Старый шаблон с работающей Microdata — можно оставить, пока нет проблем
• Конструктор без возможности вставить скрипт — Microdata в доступных блоках
• Интернет-магазин с частыми изменениями цен — JSON-LD из той же базы, что и видимая цена

Типичные ошибки при внедрении JSON-LD

• Синтаксическая ошибка в JSON: лишняя запятая, незакрытая скобка
• Разметка вставлена скриптом после загрузки, и её видят не все роботы
• Данные в разметке не совпадают с видимыми: старая цена, другое название
• Одинаковый блок разметки на всех страницах сайта

Проверка

Независимо от формата проверяйте разметку в инструменте проверки расширенных результатов Google, валидаторе Schema.org и валидаторе Яндекс Вебмастера. Смотрите не только на отсутствие ошибок, но и на то, распознаны ли нужные объекты и свойства.