Разметка Schema.org для видео

  1. Минимальный пример разметки
  2. Добавление плеера
  3. Дополнительная разметка
  4. Свойства, которые поддерживает поиск по видео
  5. Пример подробного описания видео

Минимальный пример разметки

Ниже перечислены свойства, без указания которых видеоролики проиндексированы не будут.

Свойство Тип Описание
url URL

Ссылка на видеоролик.
name Text

Название видео.
description Text

Описание видео.
duration Duration

Продолжительность видео.
isFamilyFriendly Boolean

Признак, определяющий можно ли смотреть данный видеоролик детям:

  • true — если можно смотреть детям.
  • false — если есть элементы, которые оцениваются законом или владельцем сайта, как недопустимые для детей.
thumbnail ImageObject

Описание изображения при предварительном просмотре.
uploadDate Date

Дата загрузки видеоролика на сайт в формате ISO 8601.
Свойство Тип Описание
url URL

Ссылка на видеоролик.
name Text

Название видео.
description Text

Описание видео.
duration Duration

Продолжительность видео.
isFamilyFriendly Boolean

Признак, определяющий можно ли смотреть данный видеоролик детям:

  • true — если можно смотреть детям.
  • false — если есть элементы, которые оцениваются законом или владельцем сайта, как недопустимые для детей.
thumbnail ImageObject

Описание изображения при предварительном просмотре.
uploadDate Date

Дата загрузки видеоролика на сайт в формате ISO 8601.

Пример минимального описания видео

<div itemscope itemtype="http://schema.org/VideoObject" > 

<!--Указание типа объекта-->
    <a itemprop="url" href="https://www.mysite.com/view/306/">
    <h1 itemprop="name">Что такое Schema.org</h1></a>
    <p itemprop="description">Schema.org - это стандарт семантической разметки данных в сети, объявленный поисковыми системами Google, Bing и Yahoo! летом 2011 года. Цель семантической разметки — сделать интернет более понятным, структурированным и облегчить поисковым системам и специальным программам извлечение и обработку информации для удобного её представления в результатах поиска.</p>
    <meta itemprop="duration" content="PT6M58S">
    <meta itemprop="isFamilyFriendly" content="true">
    <p>Дата загрузки:<span itemprop="uploadDate">2013-06-05T00:00:00</span></p>
    <span itemprop="thumbnail" itemscope itemtype="http://schema.org/ImageObject"> 
    <img itemprop="contentUrl" src="https://www.mysite.com/images/preview/img1.jpg">
    <meta itemprop="width" content="250">
    <meta itemprop="height" content="120">
    </span>

</div>

Добавление плеера

Примечание. В настоящее время в поиск по видео встраиваются плееры крупных хостингов, в базе которых есть не менее 500 роликов.

Чтобы ваш плеер попал в результаты поиска по видео, сообщите о нем роботу Яндекса:

  1. Разместите плеер на отдельной странице.
  2. Укажите ссылку на эту страницу в элементе embedUrl.
    <link itemprop="embedUrl" href="https://www.mysite.com/iframe/yacinema/123/">
  3. Сообщите нам о плеере через форму обратной связи. Мы протестируем его и сообщим вам о результатах.

Дополнительная разметка

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

  1. Формат видео
  2. Категории видео
  3. Параметры плеера
  4. Формат даты
  5. Статистика
  6. Ограничение показов

Формат видео

Поддерживаются следующие поля:

  • height — высота видеоролика.

  • width — ширина видеоролика.

  • bitrate — максимальный битрейт, в килобитах в секунду (kbps).

  • videoQuality — качество кодирования видео.

    Поддерживаемые значения:

    • low — низкое качество (разрешение меньше 360×640, битрейт ниже 717 kbps);

    • medium — среднее качество (разрешение от 360×640 до 720×1280, битрейт от 717 kbps до 1 Mbps);

    • HD — HD-качество (разрешение от 720×1280 до 1080×1920, битрейт 1-2 Mbps);

    • full HD — качество 1080p (разрешение больше 1080×1920, битрейт выше 2 Mbps).

  • contentSize — размер видео в килобайтах.

Категории видео

Параметры плеера

Поддерживаемые характеристики:

  • embedUrl — iframe-cсылка для вставки плеера, проигрывающего видео.

  • allowEmbed — признак того, что видео можно показывать на странице результатов поиска Яндекса.

    По умолчанию видео можно проигрывать прямо в результатах поиска.

  • playerType — доступные кодеки для данного формата видео.

    Если доступных кодеков несколько, укажите их через запятую.

  • availablePlatform — платформа, на которой можно воспроизвести данное видео.

    Полный список поддерживаемых значений

    • Desktop — указание на то, что поддерживаются основные платформы персональных компьютеров (перечислены ниже)

    • Windows

    • Linux

    • OSX

    • Mobile — указание на то, что поддерживаются основные мобильные платформы (перечислены ниже)

    • iOS

    • Android

    • WindowsPhone

    • WindowsMobile

    • Symbian

    • Bada

    • BlackBerry

    • MeeGo

Формат даты

Даты указываются в формате ISO 8601.

Поддерживаемые характеристики:

  • dateCreated — дата создания видеоролика.

  • datePublished — дата первой публикации видеоролика.

  • dateModified — дата изменения информации о видеоролике на сайте.

  • expires — дата, после которой видео не будет доступно.

    Используется, например, если права на видео ограничены по времени.

Пример разметки:

<meta itemprop="dateCreated" content="2012-11-08">
<meta itemprop="datePublished" content="2013-06-05">
<meta itemprop="dateModified" content="2013-07-22">

Статистика

Поддерживаемые характеристики:

  • interactionCount — счетчики специфических типов пользовательского взаимодействия с видеороликом.

    Вы можете указать следующие типы счетчиков в формате названиеСчетчика:число:

    • UserComments — количество комментариев;

    • UserLikes — количество пользователей, которым понравилось видео;

    • UserDislikes — количество пользователей, которым не понравилось видео;

    • UserViewsLastMonth — количество просмотров за последний месяц;

    • UserViewsLastWeek — количество просмотров за последнюю неделю;

    • UserViewsLastDay — количество просмотров за последний день;

    • UserViews — общее количество просмотров.

  • aggregateRating — общий рейтинг, основанный на сборе пользовательских оценок видео.

    Для обобщенного рейтинга могут быть указаны следующие параметры:

    • worstRating — нижнее значения рейтинга (по умолчанию 1);

    • bestRating — верхнее значение рейтинга (по умолчанию 5);

    • ratingValue — значение рейтинга;

    • ratingCount — количество оценок, на которых основан рейтинг.

Пример разметки:

<meta itemprop="interactionCount" content="UserComments:18" />
<meta itemprop="interactionCount" content="UserLikes:152" />
<meta itemprop="interactionCount" content="UserDislikes:3" />
<meta itemprop="interactionCount" content="UserViewsLastMonth:25550" />
<meta itemprop="interactionCount" content="UserViewsLastWeek:2544" />
<meta itemprop="interactionCount" content="UserViewsLastDay:2154" />
<meta itemprop="interactionCount" content="UserViews:2154587" />
<div itemprop="aggregateRating" itemscope itemtype="http://schema.org/AggregateRating">
  <meta itemprop="worstRating" content="1">
  <meta itemprop="bestRating" content="5">
  <meta itemprop="ratingValue" content="5">
  <meta itemprop="ratingCount" content="2545">
</div>

Ограничение показов

Поддерживаемые характеристики:

  • allowCountries — перечень стран, в которых доступен видеоролик. Например, RU, US, UK.

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

  • disallowCountries — перечень стран, в которых запрещен или ограничен к показу данный видеоролик.

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

Свойства, которые поддерживает поиск по видео

Примечание. Свойства, отсутствующие в стандарте, но поддерживаемые в расширении Яндекса, выделены полужирным шрифтом.
Свойство Тип Описание
Обязательные
url URL

Ссылка на видеоролик.
name Text

Название видео.
description Text

Описание видео.
duration Duration

Продолжительность видео.

<meta itemprop="duration" content="PT6M58S">
isFamilyFriendly Boolean

Признак, определяющий можно ли смотреть данный видеоролик детям:

  • true — если можно смотреть детям.
  • false — если есть элементы, которые оцениваются законом или владельцем сайта, как недопустимые для детей.
thumbnail ImageObject

Описание изображения при предварительном просмотре.
uploadDate Date

Дата загрузки видеоролика на сайт в формате ISO 8601.
Дополнительные
content_id Text

Идентификатор видео, который должен быть уникальным для каждого видео.

Одно и то же видео, размещенное на разных страницах, должно иметь один и тот же идентификатор в разметке этих страниц. Таким образом робот сможет избежать индексирования дубликатов.
author Person

Логин пользователя, загрузившего ролик на сайт.
caption Text

Подпись к видео.
contentUrl URL

Адрес, по которому доступен файл с видеороликом.
feedUrl URL

Адрес XML-фида для данной страницы.

Если для страницы существует XML-фид рекомендованного формата, то с помощью Schema.org можно указать, только категорию объекта и ссылку на фид.

Однако могут быть заполнены и другие поля. При наличии одновременно XML-фида и заполненных полей Schema.org предпочтение отдается фиду. В случае, если по каким-либо причинам фид недоступен, данные будут получены из микроразметки.
genre Text

Здесь может быть указана тематика (юмор, спорт, музыка и т. д.) и жанр (комедия, драма, рок, поп) видео.
license Text

Тип лицензии, по которой распространяется видео.
image URL

Официальное изображение к видео (постер фильма, обложка альбома).
productionCompany Text или Organization

Компания-производитель видео.
isOfficial Boolean

Признак видео, размещенного на официальном сайте или канале производителя, исполнителя или правообладателя.

Чтобы показать, что видео официальное, добавьте атрибут isOfficial со значением true. Если это поле не указано, Яндекс сочтет видео неофициальным.
status Text или URL

Состояние, в котором на данный момент находится видео.

Доступны следующие статусы:

  • published — видео опубликовано на сайте, общедоступно;

  • private — видео находится на сайте, но доступ к нему ограничен;

  • blocked — видео заблокировано;

  • processing — видео загружено и обрабатывается;

  • deleted — видео удалено с сайта.
height Distance

Высота видеоролика.
width Distance

Ширина видеоролика.
bitrate Text

Максимальный битрейт в килобитах в секунду (kbps).
videoQuality Text

Качество кодирования видео. Поддерживаемые значения:

  • low — низкое качество (разрешение меньше 360×640, битрейт ниже 717 kbps);

  • medium — среднее качество (разрешение от 360×640 до 720×1280, битрейт от 717 kbps до 1 Mbps);

  • HD — HD-качество (разрешение от 720×1280 до 1080×1920, битрейт 1-2 Mbps);

  • full HD — качество 1080p (разрешение больше 1080×1920, битрейт выше 2 Mbps).
contentSize Text

Размер видео в килобайтах.
embedUrl URL

Iframe-cсылка для вставки плеера, проигрывающего видео.
allowEmbed Boolean

Признак того, что видео можно показывать на странице результатов поиска Яндекса. По умолчанию видео можно проигрывать прямо в результатах поиска.
playerType Text

Доступные кодеки для данного формата видео. При наличии нескольких доступных кодеков, указываются через запятую.
availablePlatform Text

Платформа, на которой можно воспроизвести данное видео.

Полный список поддерживаемых значений

  • Desktop — указание на то, что поддерживаются основные платформы персональных компьютеров (перечислены ниже)

  • Windows

  • Linux

  • OSX

  • Mobile — указание на то, что поддерживаются основные мобильные платформы (перечислены ниже).

  • iOS

  • Android

  • WindowsPhone

  • WindowsMobile

  • Symbian

  • Bada

  • BlackBerry

  • MeeGo
dateCreated Date

Дата создания видеоролика.

datePublished Date

Дата первой публикации видеоролика.

dateModified Date

Дата изменения информации о видеоролике на сайте.

expires Date

Дата, после которой видео не будет доступно.

Используется, например, если права на видео ограничены по времени.
interactionCount Text

Счетчики специфических типов пользовательского взаимодействия с видеороликом.

Подробнее см. в разделе Статистика.
aggregateRating AggregateRating

Общий рейтинг, основанный на сборе пользовательских оценок видео.

Подробнее см. в разделе Статистика.

allowCountries Text

Перечень стран, в которых доступен видеоролик. Например, RU, US, UK.

Это поле рекомендуется использовать, когда для показа видеоролика определен фиксированный перечень стран, для остальных стран ролик недоступен.
disallowCountries Text

Перечень стран, в которых запрещен или ограничен к показу данный видеоролик.

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

productionCountry Text

Страна-производитель.

Указывается в формате ISO 3166-1.
inLanguage Text

Язык видеоролика.

Код языка указывается в формате ISO 639 (например, EN).
dubbing Text

Студия, дублировавшая видео.
Свойство Тип Описание
Обязательные
url URL

Ссылка на видеоролик.
name Text

Название видео.
description Text

Описание видео.
duration Duration

Продолжительность видео.

<meta itemprop="duration" content="PT6M58S">
isFamilyFriendly Boolean

Признак, определяющий можно ли смотреть данный видеоролик детям:

  • true — если можно смотреть детям.
  • false — если есть элементы, которые оцениваются законом или владельцем сайта, как недопустимые для детей.
thumbnail ImageObject

Описание изображения при предварительном просмотре.
uploadDate Date

Дата загрузки видеоролика на сайт в формате ISO 8601.
Дополнительные
content_id Text

Идентификатор видео, который должен быть уникальным для каждого видео.

Одно и то же видео, размещенное на разных страницах, должно иметь один и тот же идентификатор в разметке этих страниц. Таким образом робот сможет избежать индексирования дубликатов.
author Person

Логин пользователя, загрузившего ролик на сайт.
caption Text

Подпись к видео.
contentUrl URL

Адрес, по которому доступен файл с видеороликом.
feedUrl URL

Адрес XML-фида для данной страницы.

Если для страницы существует XML-фид рекомендованного формата, то с помощью Schema.org можно указать, только категорию объекта и ссылку на фид.

Однако могут быть заполнены и другие поля. При наличии одновременно XML-фида и заполненных полей Schema.org предпочтение отдается фиду. В случае, если по каким-либо причинам фид недоступен, данные будут получены из микроразметки.
genre Text

Здесь может быть указана тематика (юмор, спорт, музыка и т. д.) и жанр (комедия, драма, рок, поп) видео.
license Text

Тип лицензии, по которой распространяется видео.
image URL

Официальное изображение к видео (постер фильма, обложка альбома).
productionCompany Text или Organization

Компания-производитель видео.
isOfficial Boolean

Признак видео, размещенного на официальном сайте или канале производителя, исполнителя или правообладателя.

Чтобы показать, что видео официальное, добавьте атрибут isOfficial со значением true. Если это поле не указано, Яндекс сочтет видео неофициальным.
status Text или URL

Состояние, в котором на данный момент находится видео.

Доступны следующие статусы:

  • published — видео опубликовано на сайте, общедоступно;

  • private — видео находится на сайте, но доступ к нему ограничен;

  • blocked — видео заблокировано;

  • processing — видео загружено и обрабатывается;

  • deleted — видео удалено с сайта.
height Distance

Высота видеоролика.
width Distance

Ширина видеоролика.
bitrate Text

Максимальный битрейт в килобитах в секунду (kbps).
videoQuality Text

Качество кодирования видео. Поддерживаемые значения:

  • low — низкое качество (разрешение меньше 360×640, битрейт ниже 717 kbps);

  • medium — среднее качество (разрешение от 360×640 до 720×1280, битрейт от 717 kbps до 1 Mbps);

  • HD — HD-качество (разрешение от 720×1280 до 1080×1920, битрейт 1-2 Mbps);

  • full HD — качество 1080p (разрешение больше 1080×1920, битрейт выше 2 Mbps).
contentSize Text

Размер видео в килобайтах.
embedUrl URL

Iframe-cсылка для вставки плеера, проигрывающего видео.
allowEmbed Boolean

Признак того, что видео можно показывать на странице результатов поиска Яндекса. По умолчанию видео можно проигрывать прямо в результатах поиска.
playerType Text

Доступные кодеки для данного формата видео. При наличии нескольких доступных кодеков, указываются через запятую.
availablePlatform Text

Платформа, на которой можно воспроизвести данное видео.

Полный список поддерживаемых значений

  • Desktop — указание на то, что поддерживаются основные платформы персональных компьютеров (перечислены ниже)

  • Windows

  • Linux

  • OSX

  • Mobile — указание на то, что поддерживаются основные мобильные платформы (перечислены ниже).

  • iOS

  • Android

  • WindowsPhone

  • WindowsMobile

  • Symbian

  • Bada

  • BlackBerry

  • MeeGo
dateCreated Date

Дата создания видеоролика.

datePublished Date

Дата первой публикации видеоролика.

dateModified Date

Дата изменения информации о видеоролике на сайте.

expires Date

Дата, после которой видео не будет доступно.

Используется, например, если права на видео ограничены по времени.
interactionCount Text

Счетчики специфических типов пользовательского взаимодействия с видеороликом.

Подробнее см. в разделе Статистика.
aggregateRating AggregateRating

Общий рейтинг, основанный на сборе пользовательских оценок видео.

Подробнее см. в разделе Статистика.

allowCountries Text

Перечень стран, в которых доступен видеоролик. Например, RU, US, UK.

Это поле рекомендуется использовать, когда для показа видеоролика определен фиксированный перечень стран, для остальных стран ролик недоступен.
disallowCountries Text

Перечень стран, в которых запрещен или ограничен к показу данный видеоролик.

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

productionCountry Text

Страна-производитель.

Указывается в формате ISO 3166-1.
inLanguage Text

Язык видеоролика.

Код языка указывается в формате ISO 639 (например, EN).
dubbing Text

Студия, дублировавшая видео.

Пример подробного описания видео

<div itemscope itemtype="http://schema.org/VideoObject">

<!-- Основные характеристики -->
    <link itemprop="url" href="https://www.mysite.com/view/308/">
    <meta itemprop="name" content="Что такое schema.org">
    <meta itemprop="description" content="Schema.org – это стандарт семантической разметки данных в сети, объявленный поисковыми системами Google, Bing и Yahoo! летом 2011 года.
    Цель семантической разметки — сделать интернет более понятным, структурированным и облегчить поисковым системам и специальным программам извлечение и обработку информации для удобного её представления в результатах поиска.">
    <meta itemprop="duration" content="PT6M58S">
    <span itemprop="author" itemscope itemtype="http://schema.org/Person"></span>
    <meta itemprop="genre" content="education">
    <link itemprop="feedUrl" href="https://example.com/user111/view24/view24.xml"> 
    <meta itemprop="content_id" content="3543">   
    <meta itemprop="isFamilyFriendly" content="true">
    <meta itemprop="license" content="СС">
    <link itemprop="image" href="https://www.mysite.com/vi/xcL-oGPxgCg/maxresdefault.jpg">
    <meta itemprop="productionCompany" content="yandex">
    <meta itemprop="status" content="published">

<!-- Даты -->
    <meta itemprop="uploadDate" content="2013-06-05T00:00:00">
    <meta itemprop="dateCreated" content="2012-11-08T00:00:00">
    <meta itemprop="dateModified" content="2013-06-05T00:00:00">
    <meta itemprop="datePublished" content="2013-06-05T00:00:00">    

<!-- Картинки -->
    <span itemprop="thumbnail" itemscope itemtype="http://schema.org/ImageObject">
      <link itemprop="contentUrl" href="http://i1.ytimg.com/vi/xcL-oGPxgCg/maxresdefault.jpg">
      <meta itemprop="width" content="250">
      <meta itemprop="height" content="120">
    </span>

<!-- Плеер -->
      <link itemprop="embedUrl" href="https://www.mysite.com/iframe/yacinema/r5cia8fb8q.4708/">
      <meta itemprop="allowEmbed" content="true">
      <meta itemprop="playerType" content="Flash">
      <meta itemprop="width" content="1920">
      <meta itemprop="height" content="1080">
      <meta itemprop="videoQuality" content="full HD">
      <meta itemprop="bitrate" content="526">
      <meta itemprop="contentSize" content="526000">
      <meta itemprop="availablePlatform " content="Mobile">

<!-- Региональность -->
      <meta itemprop="allowCountries" 
      content="RU, US, UK">
      <meta itemprop="productionCountry" content="RU"> 
      <meta itemprop="inLanguage" content="RU">

<!-- Статистика -->
      <meta itemprop="interactionCount" content="UserComments:18"/>
      <meta itemprop="interactionCount" content="UserLikes:152"/>
      <meta itemprop="interactionCount" content="UserDislikes:3"/>
      <meta itemprop="interactionCount" content="UserViewsLastMonth:25550"/>
      <meta itemprop="interactionCount" content="UserViewsLastWeek:2544"/>
      <meta itemprop="interactionCount" content="UserViewsLastDay:2154"/>
      <meta itemprop="interactionCount" content="UserViews:2154587"/>
      <div itemprop="aggregateRating" itemscope itemtype="http://schema.org/AggregateRating">
       <meta itemprop="worstRating" content="1">
       <meta itemprop="bestRating" content="5">
       <meta itemprop="ratingValue" content="5">
       <meta itemprop="ratingCount" content="2545">
      </div>
</div>