Json ld
JSON-LD — формат записи связанных данных в JSON. Веб-страницы используют его со словарём Schema.org, чтобы явно обозначить опубликованные сущности и их свойства. Разметку нужно согласовывать с видимым содержимым страницы.
JSON-LD полезен разработчику сайта, когда нужно описать товар, статью или другой объект без изменения видимой структуры HTML. Он может помочь поисковой системе понять данные, но сам по себе не обещает иной вид сниппета или рост трафика.
Что такое JSON-LD и зачем он нужен
В блоке JSON-LD тип объекта записывают в @type, а свойства — отдельными полями. Поисковая система сопоставляет эти данные с содержимым страницы и собственными правилами обработки.
Некоторые страницы с корректной разметкой могут получить расширенный результат с дополнительными сведениями. Наличие JSON-LD лишь создаёт техническую предпосылку для поддерживаемого типа результата; фактический показ не гарантирован.
JSON-LD vs другие способы разметки
Есть три основных способа добавить структурированные данные на сайт: JSON-LD, Microdata и RDFa. Все три работают со схемами Schema.org, но существенно отличаются синтаксисом и удобством реализации. Google явно предпочитает именно JSON-LD — это документировано и основано на многолетнем применении данного формата в разметке. Чем быстрее вы выберете правильный способ разметки, тем меньше проблем с распознаванием контента будет в вашем поиске.
JSON-LD отделён от HTML
- JSON-LD размещается в отдельном блоке script внутри head или body, полностью отделён от основного HTML-кода страницы, что исключает любой риск ошибок смешивания разметки с контентом и синтаксисом.
Microdata с RDFa усложняют разметку
- Microdata встраивается прямо в HTML-атрибуты элементов разметки, RDFa требует использования дополнительных параметров и namespace, оба формата существенно усложняют исходный код и повышают вероятность ошибок при разметке.
Google выбрал JSON-LD стандартом
- Официальная документация Google явно указывает, что JSON-LD — приоритетный формат для большинства типов структурированных данных, используется во всех платформах и рекомендуется разработчикам как основной способ внедрения разметки.
Основные типы схем для разных сайтов
Выбирайте тип по основному содержимому страницы. Product описывает товар, Article — статью, Event — событие, BreadcrumbList — навигационную цепочку. У каждого типа есть собственные свойства и ограничения применения.
Для статьи важны точные заголовок, автор и даты, если они опубликованы на странице. BreadcrumbList описывает путь навигации. Не добавляйте сущности и свойства, которых пользователь не найдёт в видимом содержимом.
Инструкция: как внедрить JSON-LD
Внедрение начинается с выбора типа и подготовки реальных значений. Затем добавьте блок JSON-LD, проверьте его синтаксис и требования поисковой системы, опубликуйте страницу и повторите тест на доступном URL.
Добавьте в HTML блок <script type="application/ld+json"> с данными, которые совпадают с видимым содержимым страницы. Для Product это могут быть сведения о товаре и предложении, для Organization — опубликованные данные организации. Затем проверьте код через Schema Markup Validator и применимые требования Rich Results Test.
Типичные ошибки и способы их избежать
Частые ошибки JSON-LD — пропущенные кавычки, лишние запятые и неверная структура вложенных объектов. Даже синтаксически правильный код может содержать свойства не того типа или данные, расходящиеся с текстом страницы.
Если на странице несколько сущностей, каждому объекту задают подходящий тип и понятные связи между ними. Структура одного или нескольких блоков script допустима, если итоговые данные однозначны и не противоречат друг другу.
Валидация и проверка разметки JSON-LD
Google Rich Results Test: главный инструмент проверки JSON-LD
Rich Results Test проверяет поддерживаемые Google виды расширенных результатов. Для общей проверки структуры Schema.org используйте также Schema Markup Validator. Успешный тест не является обещанием показа в поиске.
Отслеживание в Google Search Console
После публикации следите за сообщениями поисковой консоли о доступных типах структурированных данных. Исправляйте ошибки по конкретным страницам и повторно проверяйте опубликованный URL.
Сроки появления результатов и роста трафика
После исправления разметки дождитесь повторного обхода страницы и проверяйте отчёты консоли. Срок появления новых данных и вид поискового результата заранее не определяются, а изменение позиций не следует приписывать одной лишь разметке.