Что такое JSON-LD
Разберем, json ld что это и как работает. JavaScript Object Notation for Linked Data (JSON-LD) — метод передачи связанных данных. Этот синтаксис используется для указания объектов и дальнейшего раскрытия их свойств.
JSON-LD — это формат описания информации с помощью объектов LD-словаря. Чтобы поисковик корректно распознал контекст, код необходимо внедрить в script-тег.
Для заметного присутствия в выдаче Яндекса и Google внедряйте структурированные данные. Так ресурс получает расширенный сниппет, привлекающий внимание пользователей и повышающий кликабельность.
Сравните простой сниппет:
И сниппет сайта, использующего структурированные данные:
Во втором случае блок включает полезные для бизнеса детали: категорию товара, рейтинг, цену.
- Краткий чек‑лист внедрения JSON‑LD
- Что такое структурированные данные
- Почему для Schema.org нужно использовать именно JSON-LD
- Правила размещения структурированных данных в формате JSON-LD
- Генераторы JSON-LD
- Как проверить JSON-LD синтаксис на ошибки
- Коротко о главном
Краткий чек‑лист внедрения JSON‑LD
Прежде чем изучать структуру, дам компактный план действий. Эти пять шагов закрывают 90% задач при оптимизации и создании разметки.
- Выберите нужный вид схемы под цель страницы: Article, Product, Organization, FAQPage, BreadcrumbList.
- Сгенерируйте код через плагин, AI-инструмент или скопируйте шаблон ниже.
- Вставьте блок в
<head>или<body>документа как<script type="application/ld+json">. - Проверьте результат через «Проверку расширенных результатов» (Rich Results Test) и Schema Markup Validator.
- Отслеживайте статус в Google Search Console: раздел Enhancements покажет ошибки, а Pages — покрытие при индексации.
Минимальный пример для статьи (скопируйте и адаптируйте)
Ниже — рабочий шаблон типа Article с заполненными критичными полями: @id, mainEntityOfPage, author и publisher. Именно эти данные влияют на интерпретацию сущности и шанс попасть в расширенный сниппет.
{
"@context": "https://schema.org",
"@type": "Article",
"@id": "https://site.ru/blog/json-ld#article",
"url": "https://site.ru/blog/json-ld",
"mainEntityOfPage": "https://site.ru/blog/json-ld",
"headline": "Микроразметка JSON-LD: что это и как использовать",
"image": ["https://site.ru/upload/article-cover.jpg"],
"datePublished": "2026-03-10",
"dateModified": "2026-03-10",
"author": {
"@type": "Person",
"name": "Имя Автора",
"sameAs": ["https://www.linkedin.com/in/author/"]
},
"publisher": {
"@type": "Organization",
"name": "Название издания",
"url": "https://site.ru/",
"@id": "https://site.ru/#organization",
"logo": {
"@type": "ImageObject",
"url": "https://site.ru/upload/logo.png"
}
}
}Обратите внимание: запятая после последнего свойства в объекте вызывает фатальную ошибку — система её не допускает. Это частая причина проблем при продвижении.
Что такое структурированные данные
Структурированные данные — это дополнительная текстовая разметка для роботов. Благодаря этим параметрам алгоритм точно определяет тематику материала и ранжирует URL точнее.
Внедрение микроразметки json необходимо для роста CTR и улучшения пользовательского опыта.
Существует несколько форматов: json ld микроразметка, Microdata и RDFa.
Google рекомендует использовать именно schema json ld. Данный код добавляется скриптом непосредственно в HTML-документ.
Механизм работы следующий: задействуется <script type="application/ld+json">, который встраивается внутрь head-элемента либо body.
Главное преимущество такого контейнера — независимость от визуальной верстки. Видимый текст находится отдельно, json разметка — отдельно. Это снижает риск поломки дизайна.
Дополнительный плюс — возможность разметить сразу несколько объектов на одном URL. Например, для кулинарного блога можно указать:
- Состав.
- Время приготовления.
- Ингредиенты.
В итоге пользователь найдет рецепт по конкретному запросу, а не только по названию блюда.
Для формирования rich-сниппета требуется не только словарь, но и грамотный синтаксис.
Как выглядит синтаксис JSON-LD
Рассмотрим базовую структуру:
 1.png)
 1.png)
 1.png)
 1.png)
 1.png)
Формат json ld schema org улучшает индексирование: корректно заданные свойства помогают ботам анализировать контент.
Информацию проще представить как набор ключей со значениями. Они связывают объекты:
- @context. Указание словаря.
- @type. Обозначение вида сущности (например, TVSeries, CreativeWork, MusicRecording, Book, Recipe).
Многие правила перешли из классического JavaScript:
- Null.
- Бинарные True / False.
- Определение JSON-объекта.
- Число.
- Массив.
Ключи и значения синтаксиса
Разберем основные ключи подробнее.
- @context. Главный тег, соединяющий элементы с IRI (интернационализированным идентификатором ресурса).
- @list. Ключ для массивов (например, var1):
- @graph. Соединяет граф в самостоятельный объект. Граф — абстрактная схема отношений (узлы и ребра).
- mainEntityOfPage. URL страницы, к которой относится сущность. Помогает связать объект с конкретным документом.
- sameAs. Ссылки на официальные профили (https://...). Усиливает авторитет компании или автора.
- @id. Уникальный идентификатор сущности.
- @vocab. Расширяет тип данных:
- @value. Указывает значение. Для MonetaryAmount это число, для PropertyValue — Text, Number, Boolean.
- @base. Базовая ссылка.
- @language. Обозначение языка (например, ru):
- @index. Контейнер произвольного типа:
- @type. Обозначает тип значения.
- @set. Data-контейнер:
- @container. Тип контейнера:
Подробнее о словарях мы писали в статье «Schema.org: полное руководство».
Обязательные и рекомендованные свойства JSON-LD
Контент попадет в расширенный сниппет, только если заполнены все обязательные свойства.
Рекомендуемые поля (description, image, logo) заполнять не обязательно, но полезно. Чем их больше, тем выше шанс на успех.
Любая микроразметка состоит из словаря (языка) и синтаксиса (правил внедрения). Полный список свойств доступен на schema.org.
Прописывать данные можно через Microdata или RDFa, но оптимальный выбор — JSON-LD.
Почему для Schema.org нужно использовать именно JSON-LD
Этот стандарт рекомендует Google. Внедрять его удобно: код просто оборачивается тегом script, не ломая верстку.
| Формат | Способ внедрения | Поддержка / обслуживание | Риск поломки HTML | Рекомендации |
|---|---|---|---|---|
| JSON-LD | <script type="application/ld+json"> в <head> / <body> |
Просто редактировать, отдельно от верстки | Низкий | Предпочтительный вариант |
| Microdata | Атрибуты внутри HTML | Правки в шаблонах, сложнее поддерживать | Средний | Уместно, если уже внедрено |
| RDFa | Атрибуты внутри HTML | Сложнее поддерживать | Средний | Нишевые сценарии |
Ключевые преимущества:
- Не нужно менять CSS-стили.
- Удобная работа с вложенностью.
- Визуальная понятность даже без глубоких знаний программирования.
- Легкая автоматизация (генерация), хотя сам формат не поддерживает переменные.
- Быстрая отладка.
Формат отлично подходит, чтобы разметить: имя сайта, соцсети, адрес, отрасль, телефон, email, отзывы, часы работы. Также можно описать конкретный товар, мероприятие или видео.
Главный недостаток — ручной набор занимает время и ведет к опечаткам. Синтаксис строго чувствителен к регистру.
Правила размещения структурированных данных в формате JSON-LD
Чтобы получать расширенные сниппеты, данные должны строго соответствовать видимому контенту.
Например, результаты поиска могут выглядеть так:
Запрещено размечать скрытую или нерелевантную информацию. Если на странице нет отзывов, не добавляйте их в код.
Для создания скрипта используйте автоматические генераторы.
Генераторы JSON-LD
Один из базовых инструментов — Schema Generator For SEO. Указываем сущность, заполняем поля и копируем результат. Доступны 5 сущностей, которых хватит для старта.
Выбираем тип данных:
 1.png)
Размечаем обязательные свойства:
Альтернатива — Schema Markup Generator. Здесь доступно больше схем: Article, BreadcrumbList, FAQPage и другие.
Принцип работы аналогичен. Выбираем требуемый тип и приступаем к разметке:
Доступны и рекомендованные свойства:
Для масштабных проектов подойдет Schema App. Платформа поддерживает весь словарь schema.org. Начальный тариф стартует от 30$ за месяц.
Перед внедрением обязательно проверьте размеченный код.
Как проверить JSON-LD синтаксис на ошибки
Готовый код требует валидации. Ручная проверка неэффективна, используйте специализированные сервисы.
Для оценки шансов на rich-сниппеты применяйте «Проверку расширенных результатов», а для анализа словаря — Schema Markup Validator.
Если раскрыть отчет подробно, можно увидеть конкретный источник проблемы:
В Рунете популярен валидатор Яндекса — «Парсер микроразметки». Он мгновенно находит ошибки в синтаксисе:
Инструмент обработает страницу и покажет результат:
Частые ошибки и что проверить дополнительно
Автоматика ловит не всё. Контролируйте следующие моменты:
- Синтаксис JSON: отсутствующие или лишние запятые, неверные кавычки.
- Несоответствие контенту: не размечайте данные, которых нет в видимой части.
- Обязательные поля: убедитесь, что заполнены все required‑свойства.
- Изображения: проверьте доступность по URL, подходящий размер и формат файла.
- Даты и валюта: используйте ISO 8601 для дат (например, 2026-03-10) и ISO 4217 для валют (например, RUB, USD).
- Идентификаторы: задавайте стабильные значения @id без конфликтов между скриптами.
После внедрения мониторьте Google Search Console. Исправления всегда валидируйте повторно.
Ошибки в коде могут навредить SEO. Если сомневаетесь, делегируйте задачу техническим специалистам.
Коротко о главном
Работа с application/ld+json требует аккуратности, но это обязательный шаг для попадания в ТОП. Базовое знание синтаксиса — хорошая помощь специалисту, снижающая расходы на платную рекламу.
Формат незаменим, когда:
- Важно сохранить чистоту HTML-верстки.
- Нужно выполнить технические требования поисковиков.
- Требуется скрыть служебные данные от посетителей.
- Необходимо минимизировать объем кода (до 10–20 Кб).
.png)
.png)
.png)
Комментарии (8)
Оставить комментарий