JSON-LD

JSON-LD является форматом представления связанных данных на основе JSON. На веб-страницах его часто используют для размещения структурированных сведений об организации, статье, продукте и других объектах. Для GEO он помогает явно описать факты и связи, однако сам формат не определяет правдивость этих сведений и не гарантирует их использование платформой.

Основные элементы

Контекст задаёт значение используемых терминов, тип описывает класс объекта, а идентификатор позволяет ссылаться на него из других частей данных. При работе со Schema.org эти элементы связывают запись с соответствующим словарём. Не следует воспринимать ключи как произвольные SEO-поля.

ЭлементНазначениеПример смысла
@contextОпределяет словарь и интерпретацию терминовИспользуется словарь Schema.org
@typeУказывает тип объектаОрганизация или статья
@idЗадаёт идентификатор объектаПостоянный адрес идентификации
СвойстваОписывают характеристики и связиНазвание, автор, сайт

Эта таблица объясняет роли элементов, а не заменяет спецификацию. При сложной модели данных нужно проверить типы значений, связи и требования конкретного потребителя.

Как размещается на сайте

Для структурированных данных веб-страницы обычно используется блок script с типом application/ld+json. Он не является видимой статьёй для посетителя, поэтому должен описывать реально представленные сведения. Содержимое блока нужно поддерживать вместе с основной страницей.

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

Идентичность объектов

При нескольких блоках полезно согласовать идентификаторы. Автор статьи должен ссылаться на того же человека, которого описывает его профиль. Организация в карточке услуги должна соответствовать организации в общих данных сайта, если речь действительно идёт об одном объекте.

При этом не следует присваивать один идентификатор компании, бренду и каждому филиалу. Такие объекты могут быть связаны отношениями, но имеют разные свойства. Общая проблема смешения сущностей рассматривается в статье № 93 «Entity Disambiguation».

Где возникают расхождения

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

Поэтому проверку проводят на итоговом документе. Нужно увидеть все блоки, их связи и фактические значения после работы шаблонов и сценариев. На динамическом сайте важен также результат обработки JavaScript, описанный в статье № 89 «JavaScript Rendering».

Три уровня проверки

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

Для GEO полезно формулировать результат внедрения точно: данные стали согласованными и читаемыми в выбранном формате. Нельзя приравнивать это к попаданию в граф знаний или гарантированному цитированию.

JSON-LD является способом записи, а Schema.org словарём описания. Их различие раскрывается в статье № 86 «Schema.org». Свойство sameAs рассматривается в статье № 88 «sameAs». Такая последовательность помогает строить разметку на понятной модели объектов и проверяемых сведениях, а не на наборе обещаний о продвижении.

Источники

W3C. JSON-LD 1.1

Вопросы и ответы

Как размещается на сайте?

Для структурированных данных веб-страницы обычно используется блок script с типом application/ld+json. Он не является видимой статьёй для посетителя, поэтому должен описывать реально представленные сведения.

Где возникают расхождения?

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

Дата обращения к источникам: 22 октября 2026 года.