Json ld идентификатор id

Основа JSON-LD — это идентификатор @id. JSON-LD идентификатор @id часто используется неправильно, хотя синтаксис простой. Когда вы размечаете страницу через тег script type=«application/ld+json», каждый объект может иметь уникальный @id — это URL-адрес, который определяет объект однозначно.

Если автор одной статьи встречается и на других страницах, одинаковый @id позволяет ссылаться на одну сущность Person. Проверьте, что URL идентификатора стабилен и связи в графе описывают реальные отношения.

Что такое @id в JSON-LD

JSON-LD идентификатор @id — это не просто значение свойства контента. Это URI (адрес), который указывает на конкретную сущность в интернете. Когда вы добавляете script type=«application/ld+json» в разметку страницы, каждый объект JavaScript Object Notation может содержать @id.

Правило одно: JSON-LD идентификатор должен быть полным URL. Не пишите «person-1» — пишите «https://www.example.com/authors/john-doe». Не «article-123» — пишите адрес на сайта вашей компании. Это отличает JSON-LD от Microdata и RDFa.

Контекст context указывается в @context: «http://schema.org». Эта строка говорит Google: «Используй определения Schema.org». Каждое свойство (@type, name, url, description) получает значение из словаря Schema.org. И JSON-LD идентификатор @id работает в этом контексте context.

Синтаксис JSON-LD: примеры для типов данных

Вот Article с правильным JSON-LD идентификатором @id:

{
  "@context": "http://schema.org",
  "@type": "Article",
  "@id": "https://example.com/articles/json-guide",
  "headline": "Complete JSON-LD Guide",
  "author": {
    "@type": "Person",
    "@id": "https://example.com/authors/sarah",
    "name": "Sarah Wilson"
  },
  "datePublished": "2024-01-15",
  "description": "Learn JSON-LD markup properly"
}

Видите типа данных структуру? @id у Article — это URL статьи на сайта. @id у Person — URL профиля автора. Google считывает оба @id и создаёт связанные данные.

Для типа Person JSON-LD идентификатор выглядит так:

{
  "@context": "http://schema.org",
  "@type": "Person",
  "@id": "https://example.com/team/sarah",
  "name": "Sarah Wilson",
  "url": "https://example.com/team/sarah",
  "jobTitle": "Content Manager"
}

JSON-LD идентификатор @id совпадает с url. Это правильный синтаксис JSON-LD.

Для Organization JSON-LD идентификатор обычно указывает на главную страницу сайта:

{
  "@context": "http://schema.org",
  "@type": "Organization",
  "@id": "https://example.com",
  "name": "Example Corp",
  "url": "https://example.com",
  "description": "Leading provider of solutions"
}

Как @id связывает сущности в граф

Когда Google читает JSON-LD разметку с правильными @id, она собирает граф связанных данных (linked data graph). Article через @id «знает», где находится. Person через свой улучшен тоже имеет адрес. Organization имеет @id на сайта.

Контекст context делает это возможным. Контекст context определяет, что @type — это тип из Schema.org, что значение свойства «name» — это текст, что @id — это URI. Без контекста Google не поняла бы ваши структурированные данные.

Важно: каждый JSON-LD идентификатор @id должен быть уникальным. Если один автор (Person) появляется в пяти статьях Article, используйте один и тот же @id везде на сайта. Google увидит связь и укрепит граф.

При использовании script type=«application/ld+json» каждый object может содержать множество свойств через контекст context http://schema.org. Значение свойства @id однозначно определяет, о какой сущности идёт речь. Это критично для Rich Results.

Откройте Google Rich Results Test, вставьте URL страницы со скриптом. Если JSON-LD идентификатор @id указан правильно на сайта, вы увидите структурированные данные: заголовок Article, имя Person, Organization и их связи. Если @id неправильный, Google может не распознать разметку.

Вот почему JSON-LD идентификатор @id — не украшение. Это функциональный элемент синтаксиса JSON-LD, который помогает поисковым системам понимать контент на вашем сайте и показывать его в Rich Results.