Разметка Schema.org для видео
Минимальный пример разметки
Ниже перечислены свойства, без указания которых видеоролики проиндексированы не будут.
Свойство |
Тип |
Описание |
url |
Ссылка на видеоролик. |
|
name |
Название видео. |
|
description |
Описание видео. |
|
duration |
Продолжительность видео. |
|
isFamilyFriendly |
Признак, определяющий можно ли смотреть данный видеоролик детям:
|
|
thumbnail |
Описание изображения при предварительном просмотре. |
|
uploadDate |
Дата загрузки видеоролика на сайт в формате 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 роликов.
Чтобы ваш плеер попал в результаты поиска по видео, сообщите о нем роботу Яндекса:
-
Разместите плеер на отдельной странице.
-
Укажите ссылку на эту страницу в элементе
embedUrl
.<link itemprop="embedUrl" href="https://www.mysite.com/iframe/yacinema/123/">
-
Сообщите нам о плеере через форму обратной связи. Мы протестируем его и сообщим вам о результатах.
Дополнительная разметка
Перечисленные ниже поля необязательны к заполнению, но их наличие позволит лучше индексировать ваши видеоролики и выдавать их по релевантным запросам пользователей.
Формат видео
Поддерживаются следующие поля:
-
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 |
Ссылка на видеоролик. |
|
name |
Название видео. |
|
description |
Описание видео. |
|
duration |
Продолжительность видео.
|
|
isFamilyFriendly |
Признак, определяющий можно ли смотреть данный видеоролик детям:
|
|
thumbnail |
Описание изображения при предварительном просмотре. |
|
uploadDate |
Дата загрузки видеоролика на сайт в формате ISO 8601. |
|
Дополнительные |
||
content_id |
Идентификатор видео, который должен быть уникальным для каждого видео. Одно и то же видео, размещенное на разных страницах, должно иметь один и тот же идентификатор в разметке этих страниц. Таким образом робот сможет избежать индексирования дубликатов. |
|
author |
Логин пользователя, загрузившего ролик на сайт. |
|
caption |
Подпись к видео. |
|
contentUrl |
Адрес, по которому доступен файл с видеороликом. |
|
feedUrl |
Адрес XML-фида для данной страницы. Если для страницы существует XML-фид рекомендованного формата, то с помощью Schema.org можно указать, только категорию объекта и ссылку на фид. Однако могут быть заполнены и другие поля. При наличии одновременно XML-фида и заполненных полей Schema.org предпочтение отдается фиду. В случае, если по каким-либо причинам фид недоступен, данные будут получены из микроразметки. |
|
genre |
Здесь может быть указана тематика (юмор, спорт, музыка и т. д.) и жанр (комедия, драма, рок, поп) видео. |
|
license |
Тип лицензии, по которой распространяется видео. |
|
image |
Официальное изображение к видео (постер фильма, обложка альбома). |
|
productionCompany |
Text или Organization |
Компания-производитель видео. |
isOfficial |
Признак видео, размещенного на официальном сайте или канале производителя, исполнителя или правообладателя. Чтобы показать, что видео официальное, добавьте атрибут |
|
status |
Состояние, в котором на данный момент находится видео. Доступны следующие статусы:
|
|
height |
Высота видеоролика. |
|
width |
Ширина видеоролика. |
|
bitrate |
Максимальный битрейт в килобитах в секунду (kbps). |
|
videoQuality |
Качество кодирования видео. Поддерживаемые значения:
|
|
contentSize |
Размер видео в килобайтах. |
|
embedUrl |
Iframe-cсылка для вставки плеера, проигрывающего видео. |
|
allowEmbed |
Признак того, что видео можно показывать на странице результатов поиска Яндекса. По умолчанию видео можно проигрывать прямо в результатах поиска. |
|
playerType |
Доступные кодеки для данного формата видео. При наличии нескольких доступных кодеков, указываются через запятую. |
|
availablePlatform |
Платформа, на которой можно воспроизвести данное видео. Полный список поддерживаемых значений
|
|
dateCreated |
Дата создания видеоролика. |
|
datePublished |
Дата первой публикации видеоролика. |
|
dateModified |
Дата изменения информации о видеоролике на сайте. |
|
expires |
Дата, после которой видео не будет доступно. Используется, например, если права на видео ограничены по времени. |
|
interactionCount |
Счетчики специфических типов пользовательского взаимодействия с видеороликом. Подробнее см. в разделе Статистика. |
|
aggregateRating |
Общий рейтинг, основанный на сборе пользовательских оценок видео. Подробнее см. в разделе Статистика. |
|
allowCountries |
Перечень стран, в которых доступен видеоролик. Например, RU, US, UK. Это поле рекомендуется использовать, когда для показа видеоролика определен фиксированный перечень стран, для остальных стран ролик недоступен. |
|
disallowCountries |
Перечень стран, в которых запрещен или ограничен к показу данный видеоролик. Это поле используется в случаях, когда просмотр разрешен без ограничений в большинстве стран. |
|
productionCountry |
Страна-производитель. Указывается в формате ISO 3166-1. |
|
inLanguage |
Язык видеоролика. Код языка указывается в формате ISO 639 (например, EN). |
|
dubbing |
Студия, дублировавшая видео. |
Пример подробного описания видео
<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>