Как разметить свой контент в формате JSON-LD

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

Разница в разметке страницы между JSON-LD и микроданными в том, что JSON-LD вам не нужно включать в HTML-код страницы. Данные, относящиеся к этому формату, встраиваются в тег <script> внутри элемента head или body HTML-страницы. Разметка указывается отдельно от текста, видимого пользователям. Это упрощает описание вложенных элементов, таких как например Country в составе PostalAddress или MusicVenue в составе Event.

Google-поиск может считывать структурированные данные в формате JSON-LD, добавляемые на страницу динамически, например с помощью кода JavaScript или встроенных виджетов в системе управления контентом.

Пример кода, размеченного микроданными:

<div itemscope itemtype="https://schema.org/SportsTeam">
  <span itemprop="name">Манчестер Юнайтед</span>
  <div itemprop="member" itemscope itemtype="https://schema.org/OrganizationRole">
    <div itemprop="member" itemscope itemtype="https://schema.org/Person">
      <span itemprop="name">Райан Гиггз</span>
    </div>
    <span itemprop="startDate">1990</span>
    <span itemprop="endDate">2014</span>
    <span itemprop="roleName">Полузащитник</span>
  </div>
</div>

Пример разметки с использованием JSON-LD:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "SportsTeam",
  "name": "Манчестер Юнайтед",
  "member": {
    "@type": "OrganizationRole",
    "member": {
      "@type": "Person",
      "name": "Райан Гиггз"
    },
    "startDate": "1990",
    "endDate": "2014",
    "roleName": "Полузащитник"
  }
}
</script>

Ниже пример разметки для случая, когда на странице два типа контента:

<script type="application/ld+json">
[{
  "@context": "https://schema.org/",
  "@type": "Recipe",
  "name": "Вареники с бананом",
  "description": "Самые вкусные вареники. Лучшее блюдо с бананом."
  },{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [{
    "@type": "ListItem",
    "position": 1,
    "name": "Рецепты",
    "item": "https://example.com/recipes"
  },{
    "@type": "ListItem",
    "position": 2,
    "name": "Вареники",
    "item": "https://example.com/recipes/dumplings"
  },{
    "@type": "ListItem",
    "position": 3,
    "name": "Вареники с бананом"
  }]
}]
</script>

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

Стоит также учесть, что поисковые роботы Google отдают предпочтение формату JSON-LD.