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

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

Предпочтительный формат Google — JSON-LD: один блок <script type="application/ld+json"> в head или body, содержащий один или несколько объектов schema.org. Он отделён от видимого HTML, поэтому для его добавления или обновления не требуется переписывать шаблон.

Каждому объекту JSON-LD нужны @context (почти всегда "https://schema.org") и @type (класс schema.org: Article, Recipe, Product, FAQPage). @context сообщает анализаторам, из какого словаря взяты имена свойств.

Для Article укажите headline, image (URL или массив), datePublished, dateModified, author (объект Person или Organization) и publisher (Organization с логотипом). Это минимальный набор полей, необходимый для того, чтобы Google рассмотрел страницу для карусели главных новостей.

Страницы товаров объявляют @type Product с полями name, image, description, brand, sku и вложенным объектом offers, содержащим price, priceCurrency и availability. В сочетании с aggregateRating эти данные позволяют Google отображать рейтинги со звёздами и фрагменты с ценой прямо в результатах поиска.

BreadcrumbList описывает иерархию навигации. Каждый itemListElement — это ListItem с полями position, name и item (URL). Если эти данные присутствуют, Google заменяет строку с URL в фрагменте размеченной навигационной цепочкой, что помогает получить больше переходов.

Ранее схемы FAQPage и HowTo открывали доступ к блокам расширенных результатов в SERP. Позже Google ограничил расширенные результаты FAQ несколькими категориями сайтов (gov, edu), однако эта разметка по-прежнему полезна для голосовых помощников и других потребителей данных — используйте её на настоящих страницах FAQ.

Google наказывает за разметку, которая не соответствует тому, что видят пользователи. Не указывайте рейтинг 5 звёзд, которого нет на странице; не показывайте цену $9.99, которую пользователь не видит. Структурированные данные должны точно описывать отображаемое содержимое.

Тест расширенных результатов Google (search.google.com/test/rich-results) анализирует любой URL или вставленный код, перечисляет обнаруженные типы схем и предупреждает об отсутствующих обязательных свойствах. Запускайте его перед развертыванием любых изменений в структурированных данных.

На одной странице можно объявить несколько блоков JSON-LD (например, Article + BreadcrumbList + Organization) или объединить их в одном массиве @graph. Обе формы допустимы; выберите ту, которую проще использовать в шаблонах вашего конвейера сборки.

JSON-LD находится в отдельном от видимого содержимого теге script. Чтобы обновить его, заново сформируйте блок JSON — никогда не внедряйте структурированные данные только с помощью JavaScript на стороне клиента, поскольку Googlebot не всегда надёжно выполняет JS до индексации.

Какие два свойства верхнего уровня должен содержать каждый объект JSON-LD, чтобы структурированные данные были действительными?

JSON-LD объявляет структурированные данные в одном блоке скрипта application/ld+json, где @context и @type определяют каждый объект. Распространённые схемы (Article, Product, BreadcrumbList) открывают доступ к расширенным результатам поиска, если разметка точно соответствует видимой странице. Проверьте её с помощью теста расширенных результатов до развертывания.