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

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

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

Свойство

Тип

Описание

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. Сообщите нам о плеере через форму обратной связи. Мы протестируем его и сообщим вам о результатах.

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

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

Формат видео

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

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

Формат даты

Статистика

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

Формат видео

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

  • 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 — размер видео в килобайтах.

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

Фильм

Для описания фильмов используйте схему Movie.

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

  • video (обязательное поле) — описание основного содержимого видеоролика.

    Вложенные поля заполняются так же, как и поля для простого видео.

  • alternativeHeadline — название фильма на языке производителя.

  • dateReleased — дата выхода фильма в прокат.

  • part — номер части, если фильм состоит из нескольких частей (например: «Гарри Поттер и Дары смерти: Часть 1»).

  • subtitleLanguage — язык субтитров.

    Код языка указывается в формате IETF BCP 47 (например, en).

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

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

  <span>
    <a itemprop="director" href="/name/23330/">Лана Вачовски</a>,
    <a itemprop="director" href="/name/26439/">Том Тыквер</a>.
  </span>

  <span>
    <a itemprop="producer" href="/name/26437/">Штефан Арндт</a>,
    <a itemprop="producer" href="/name/31351/">Грант Хилл</a>,
    <a href="/film/464484/cast/#producer" >и другие</a>.
  </span>

  <span>
    <a itemprop="musicBy" href="/name/312865/">Райнхольд Хайль</a>,
    <a itemprop="musicBy" href="/name/26439/">Том Тыквер</a>.
  </span>

  <span>
    <a itemprop="genre" href="/level/10/m_act%5Bgenre%5D/8/">драма</a>,
    <a itemprop="genre" href="/level/10/m_act%5Bgenre%5D/17/">детектив</a>,
    <a href="/film/464484/keywords/">и другие</a>.
  </span>

  <span class="title">В главных ролях:</span>
  <div> 
    <a itemprop="actor" href="/name/9144/">Том Хэнкс</a>
    <a itemprop="actor" href="/name/1179/">Холли Берри</a>
    <a itemprop="actor" href="/name/38704/">Джим Броудбент</a>
  </div>

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

<!-- Описание видеоролика, общее для всех видео -->
  <link itemprop="url" href="https://www.kinopoisk.ru/film/464484/">
  <span itemprop="description">Шесть историй — пять реинкарнаций, происходящих в разное время, тесно переплетаются между собой…</span>
  <meta itemprop="contentRating" content="MPAA R">
  <meta itemprop="duration" content="PT2H52M04S">
  <meta itemprop="dateReleased" content="2013-11-08T00:00:00">
  <meta itemprop="uploadDate" content="2014-11-08T00:00:00">
  <meta itemprop="dateCreated" content="2013-09-09T00:00:00">
  <meta itemprop="inLanguage" content="ru">
  <meta itemprop="isFamilyFriendly" content="true">
  <meta itemprop="productionCompany" content="Warner Bros">
  <div>
   <h1 itemprop="name">Облачный атлас</h1>
   <span itemprop="alternativeHeadline">Cloud Atlas</span>
   <img src="https://st.kinopoisk.ru/images/film/464484.jpg" alt="Облачный атлас (Cloud Atlas)" itemprop="thumbnail"/>
  </div>

<!-- Язык субтитров -->
   <meta itemprop="subtitleLanguage" content="en">   
</div>
Серия сериала

Для описания сериалов используйте схему TVEpisode.

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

  • video (обязательное поле) — описание основного содержимого видеоролика.

    Вложенные поля заполняются так же, как и поля для простого видео.

  • episodeNumber (обязательное поле) — номер эпизода.

  • alternativeHeadline — название на языке производителя.

  • dateReleased — дата выхода в эфир.

  • partOfSeason — номер сезона.

  • subtitleLanguage — язык субтитров.

    Код языка указывается в формате IETF BCP 47 (например, en).

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

<div itemscope itemtype="http://schema.org/TVEpisode">
  <meta itemprop="alternativeHeadline" content="The best series">
  <meta itemprop="dateReleased" content="2008-12-05T00:00:00">
  <meta itemprop="episodeNumber" content="133">
  <meta itemprop="subtitleLanguage" content="en">
  <div itemprop="video" itemscope itemtype="http://schema.org/VideoObject">
  ...
  </div>
</div>
Музыкальное видео

Для описания музыкальных видео используйте схему MusicVideoObject.

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

  • video (обязательное поле) — описание основного содержимого видеоролика.

    Вложенные поля заполняются так же, как и поля для простого видео.

  • trackName (обязательное поле) — название трека.

  • album — название альбома.

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

<div itemscope itemtype="http://schema.org/MusicVideoObject">
  <meta itemprop="trackName" content="Welcome to My World">
  <meta itemprop="album" content="Delta Machine">
  <div itemprop="video" itemscope itemtype="http://schema.org/VideoObject">
  ...
  </div>
</div>
Выпуск телешоу

Для описания телешоу используйте схему TVSeries.

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

  • video (обязательное поле) — описание основного содержимого видеоролика.

    Вложенные поля заполняются так же, как и поля для простого видео.

  • dateReleased (обязательное поле) — дата выхода в эфир.

  • alternativeHeadline — название на языке производителя.

  • partOfSeason — номер сезона.

  • episodeNumber — номер эпизода.

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

<div itemscope itemtype="http://schema.org/TVSeries">
  <meta itemprop="alternativeHeadline" content="SuperShow">
  <meta itemprop="dateReleased" content="2012-02-03T00:00:00">
  <meta itemprop="partOfSeason" content="2">
  <meta itemprop="episodeNumber" content="3">
  <div itemprop="video" itemscope itemtype="http://schema.org/VideoObject">
  ...
  </div>
</div>
Прямая трансляция

Для описания трансляций используйте схему BroadcastEvent.

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

  • video (обязательное поле) — описание основного содержимого видеоролика.

    Вложенные поля заполняются так же, как и поля для простого видео.

  • dateStarted (обязательное поле) — дата начала трансляции.

  • dateEnded — дата окончания трансляции.

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

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

<div itemscope itemtype="http://schema.org/BroadcastEvent">
  Дата начала трансляции<span itemprop="dateStarted">2013-02-01T00:00:00</span>
  Дата окончания трансляции<span itemprop="dateEnded">2013-02-12T00:00:00</span>
  <div itemprop="video" itemscope itemtype="http://schema.org/VideoObject">
  ...
  </div>
</div>

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

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

  • 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

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

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

<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>
Написать в службу поддержки