Микроразметка Article JSON-LD с видео: как разметить статью и проверить результат

Структурированные данные помогают поисковой системе однозначнее определить, что перед ней статья, кто ее опубликовал и какое видео относится к основному материалу. Для этого страницу описывают объектом Article, а ролик добавляют в свойство video как вложенный VideoObject.

Микроразметка Article JSON LD с видео не меняет вид страницы для посетителя и сама по себе не гарантирует расширенный результат, позиции или трафик. Ее задача уже: передать поисковому роботу согласованное машинно-читаемое описание реально доступного контента.

Что именно решает такая разметка

Без структурированных данных робот анализирует заголовки, подписи, видеоплеер и служебные элементы независимо. Когда на странице несколько изображений или роликов, основной медиаматериал может быть определен неоднозначно. Связка Article → video → VideoObject прямо сообщает, какое видео относится к статье.

Это не следует смешивать с Open Graph. Метатеги Open Graph управляют главным образом превью ссылки в социальных сетях и мессенджерах. Schema.org описывает сущности и их отношения для поисковых систем. На одной странице допустимо использовать оба механизма, но поля одного не заменяют другой.

Какие данные подготовить до внедрения

Сначала соберите фактические данные страницы и видео. Не заполняйте поля условными значениями: валидный синтаксис с вымышленным URL остается некорректной реализацией.

Поле Что указать Что проверить
headline Заголовок статьи Соответствует видимому H1 без рекламных дополнений
image Основное изображение Абсолютный индексируемый URL и рабочий ответ сервера
datePublished Дата первой публикации Формат ISO 8601 и соответствие видимой дате
dateModified Дата содержательного обновления Не менять ее при каждой технической генерации страницы
author Реальный автор или организация Название совпадает с информацией на странице
thumbnailUrl Превью видео Файл доступен роботу по абсолютному URL
uploadDate Дата публикации видео Указана дата самого ролика, а не текущий день
contentUrl или embedUrl Файл либо адрес проигрывателя URL открывает заявленный видеоматериал

Готовый шаблон Article с VideoObject

JSON-LD обычно размещают в элементе <script type="application/ld+json"> внутри <head> или <body>. Скрипт не должен зависеть от действий пользователя. Ниже — шаблон: замените домен, даты, изображения и адреса видео фактическими значениями.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "@id": "https://example.ru/blog/article.html#article",
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://example.ru/blog/article.html"
  },
  "headline": "Видимый заголовок статьи",
  "description": "Краткое и точное описание материала.",
  "image": [
    "https://example.ru/images/article-cover.jpg"
  ],
  "datePublished": "2026-08-10T09:00:00+03:00",
  "dateModified": "2026-08-16T12:30:00+03:00",
  "author": {
    "@type": "Person",
    "name": "Имя автора",
    "url": "https://example.ru/authors/author/"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Название издания",
    "url": "https://example.ru/"
  },
  "video": {
    "@type": "VideoObject",
    "@id": "https://example.ru/blog/article.html#video",
    "name": "Название видео",
    "description": "Что показано в ролике.",
    "thumbnailUrl": [
      "https://example.ru/video/preview.jpg"
    ],
    "uploadDate": "2026-08-10T09:00:00+03:00",
    "duration": "PT6M20S",
    "contentUrl": "https://example.ru/video/file.mp4",
    "embedUrl": "https://example.ru/video/player/",
    "inLanguage": "ru-RU"
  }
}
</script>

Как выбрать адрес видео

contentUrl ведет непосредственно к видеофайлу или потоковому ресурсу. embedUrl ведет к странице проигрывателя, которую можно встроить. Если доступны оба корректных адреса, можно указать оба. Не подставляйте URL страницы статьи вместо адреса файла или плеера.

Как записать продолжительность

Для duration используется формат ISO 8601. Например, PT45S означает 45 секунд, PT6M20S — 6 минут 20 секунд, PT1H2M — 1 час 2 минуты. Значение должно совпадать с фактической продолжительностью ролика.

Диагностический алгоритм

  1. Сверьте видимую страницу и JSON-LD. Заголовок, автор, даты, описание видео и изображения должны описывать тот контент, который действительно видит пользователь.
  2. Проверьте синтаксис. Убедитесь, что используются двойные кавычки, нет завершающих запятых, комментариев и незакрытых скобок. JSON отличается от объекта JavaScript.
  3. Проверьте связи. У статьи должно быть свойство video, а его значением — объект с типом VideoObject. Не размещайте несвязанный объект только рядом со статьей.
  4. Откройте каждый URL. Canonical, изображение, превью, файл и проигрыватель должны возвращать ожидаемый ресурс без авторизации и бесконечных перенаправлений.
  5. Протестируйте код. Запустите проверку в валидаторе Schema.org и инструменте проверки расширенных результатов Google. Первый выявляет проблемы словаря и типов, второй показывает требования конкретной поисковой функции.
  6. Проверьте опубликованный URL. Тест фрагмента кода недостаточен: итоговая HTML-страница может отличаться из-за шаблона, кеша, JavaScript или фильтрации скриптов.
  7. Проверьте доступность для робота. Страница и ресурсы не должны быть закрыты правилами robots, требовать входа или возвращать ошибку. После изменений повторите тест публичного URL.

Проверяемые критерии корректной реализации

  • на странице есть один основной объект Article;
  • mainEntityOfPage.@id совпадает с каноническим URL статьи;
  • все URL в разметке абсолютные и используют рабочий протокол HTTPS;
  • вложенный объект имеет явный тип VideoObject;
  • название и описание относятся именно к размеченному видео;
  • у видео указаны доступное превью и дата загрузки;
  • ролик присутствует на странице и доступен посетителю;
  • даты переданы в ISO 8601, продолжительность — в ISO 8601 duration;
  • валидаторы не сообщают о синтаксических ошибках;
  • предупреждения разобраны по смыслу, а не скрыты формальным заполнением.

Типовые ошибки

Разметка не соответствует содержимому

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

Недоступное превью

thumbnailUrl может вести на закрытое хранилище, возвращать HTML вместо изображения или блокироваться защитой от внешних запросов. Проверяйте URL без активной сессии администратора.

Неверная вложенность

Если Article и VideoObject объявлены отдельными объектами, поисковой системе нужна явная связь через @id. Простое соседство двух скриптов связи не создает. Вложение в свойство video обычно проще и нагляднее.

Подмена отсутствующих данных

Не добавляйте фиктивную дату, длительность или адрес файла только ради исчезновения предупреждения. Сначала получите достоверное значение либо устраните причину, по которой ресурс недоступен.

Дубли и противоречия

Плагины CMS и шаблон могут одновременно генерировать несколько объектов статьи. Дубли допустимы не всегда: разные авторы, даты или URL создают неоднозначность. Изучайте полный исходный HTML, а не только вручную добавленный блок.

Границы метода

Корректная Schema.org-разметка — технический сигнал, а не команда поисковой системе. Она не исправляет закрытую индексацию, медленную загрузку, недоступный видеоресурс, слабое содержание или ошибочный canonical. Валидатор также не подтверждает, что страница будет проиндексирована и получит специальное оформление.

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

Итог

Надежная реализация строится на трех условиях: данные соответствуют видимому материалу, VideoObject явно связан с Article, а все ресурсы доступны по публичным абсолютным URL. После синтаксической проверки обязательно тестируйте опубликованную страницу и вручную сверяйте значения.

Если нужно оценить публичный URL без доступа к CMS, SiteVisor помогает проверить технические, SEO/GEO и конверсионные сигналы страницы. Запустите бесплатную проверку, а дополнительные практические материалы смотрите в блоге SiteVisor.