Разметка Open Graph для видео

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

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

Свойство

Тип

Описание

og:title

String

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

Максимальная длина — 1000 символов, более длинный текст обрезается.

og:url

URL

Канонический путь к странице, например: http://myhost.ru/video.html.

og:video

URL

Путь к видеоплееру или файлу.

og:image

URL

URL заставки видео.

Минимальный размер — 352 × 198 пикселей.

Рекомендованный размер — 564 × 318 пикселей.

Допустимые форматы — JPG, PNG и GIF.

og:description

String

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

Рекомендуемый объем описания видео 150-1000 символов.

ya:ovs:upload_date

DateTime

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

ya:ovs:adult

Boolean

Признак контента с возрастным ограничением 18+.

Чтобы отметить видео для взрослых, укажите значение «true». Если возрастное ограничение не требуется, укажите значение «false».

video:duration

Integer

Длительность видео в секундах с округлением до целого числа.

og:type

String

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

Некоторые категории могут требовать дополнительные поля для описания видео.

og:video:type

String

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

Некоторые данные необходимы для корректного индексирования видеоролика. Минимальное описание видео в разметке Open Graph может выглядеть так:

<html prefix="og: http://ogp.me/ns#
              video: http://ogp.me/ns/video#
              ya: http://webmaster.yandex.ru/vocabularies/">
             <!--Указание используемых префиксов-->
<head>
  <meta property="og:title" content="Open Graph для видео"/> 
  <meta property="og:url" content="http://mysite.com/view/308/"/> 
  <meta property="og:video" content="//mysite.com/iframe/yacinema/123/"/> 
  <meta property="og:description" content="Стандарт Open Graph разработан социальной сетью Facebook. Он позволяет контролировать превью, которое формируется при публикации ссылки на сайт в социальных сетях, и передавать информацию другим интернет-сервисам."/> 
  <meta property="video:duration" content="4878787787"/>
  <meta property="og:image" 
        content="http://yandex.st/lego/_/X31pO5JJJKEifJ7sfvuf3mGeD_8.png"/>
  <meta property="ya:ovs:upload_date" content="2013-06-05"/>
  <meta property="ya:ovs:adult" content="false"/>
  <meta property="og:type" content="video.other"/>
  <meta property="og:video:type" content="flash"/>
</head>

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

Примечание

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

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

  • Разместите плеер на отдельной странице и разрешите воспроизводить видео в результатах поиска Яндекса. Для этого добавьте элемент ya:ovs:allow_embed со значением true.

    <meta property="og:url" content="//mysite.com/r5cia8fb8q.4708/"/>
<meta property="ya:ovs:allow_embed" content="true"/>

  • Передайте HTML-код для встраивания вашего плеера с помощью элемента ya:ovs:embed_html.

    <meta property="ya:ovs:embed_html" content="
<object data=&quot;//mysite.com/r5cia8fb8q.4708/&quot; id=&quot;flash&quot; type=&quot;application/x-shockwave-flash&quot; height=&quot;240&quot; width=&quot;320&quot;>
<param value=&quot;always&quot; name=&quot;allowscriptaccess&quot;/>
<param value=&quot;true&quot; name=&quot;allowFullScreen&quot;/>
<param value=&quot;high&quot; name=&quot;quality&quot;/>
<param value=&quot;#000000&quot; name=&quot;bgcolor&quot;/><param value=&quot;true&quot; name=&quot;allowfullscreen&quot;/>
<param value=&quot;playlist=13470&quot; name=&quot;flashvars&quot;/></object>"/>

После того, как вы укажите плеер в разметке, напишите нам об этом через форму обратной связи. Мы протестируем плеер и сообщим вам о результатах.

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

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

Формат видео

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

  • og:video:width — ширина видео в пикселях.

  • og:video:height — высота видео в пикселях.

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

  • ya:ovs:quality — качество кодирования видео.

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

    • 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).

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

Каждый тип видео, указанный в поле og:type (кроме типа other), предполагает дополнительные поля, характеризующие его.

Фильм (video.movie)

Если для элемента og:type указано значение video.movie, видео можно дополнительно описать следующими полями:

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

  • video:release_date — дата выхода фильма.

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

Серия сериала (video.episode)

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

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

  • ya:ovs:original_name — название эпизода на языке производителя.

  • video:release_date — дата выхода серии в эфир.

  • ya:ovs:season — номер сезона, к которому относится эпизод.

Музыкальное видео (ya:ovs:music)

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

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

  • ya:ovs:album — название альбома, в который входит трек.

Выпуск шоу (video.tv_show)

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

  • ya:ovs:episode (обязательное поле) — номер выпуска телешоу.

  • video:release_date — дата выхода выпуска телешоу.

  • ya:ovs:season — номер сезона, к которому относится выпуск.

Прямая трансляция (ya:ovs:broadcast)

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

  • ya:ovs:start_date (обязательное поле) — дата и время начала трансляции.

  • ya:ovs:end_date — дата и время окончания трансляции (не указывается, если по окончании трансляции запись доступна по тому же адресу.

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

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

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

    <meta property="og:url" content="//mysite.com/r5cia8fb8q.4708/"/>
<meta property="ya:ovs:allow_embed" content="true"/>

  • ya:ovs:embed_html — HTML-код для вставки плеера, проигрывающего видео.

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

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

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

    <meta property="ya:ovs:available_platform" content="Windows"/>
<meta property="ya:ovs:available_platform" content="WindowsPhone"/>

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

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

      • Windows

      • Linux

      • OSX

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

      • iOS

      • Android

      • WindowsPhone

      • WindowsMobile

      • Symbian

      • Bada

      • BlackBerry

      • MeeGo

Формат даты

Дату и время следует указывать согласно стандарту ISO 8601, в формате YYYY-MM-DDTHH:mm:ss+03:00, где:

  • YYYY — год

  • MM — месяц

  • DD — день

  • HH — час

  • mm — минута

  • ss — секунда

  • +03:00 — часовой пояс (в данном случае московское время).

Если вы хотите указать только год (например, в качестве даты выхода фильма), укажите полночь 1 января в нужном году, например, 2001-01-01T00:00:00.

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

<meta property="ya:ovs:upload_date" content="2013-06-05T06:15:00"/>

Статистика

Статистику просмотров и рейтингов видео можно описать с помощью следующих элементов:

  • ya:ovs:views_last_day — число просмотров видео за последний день.

  • ya:ovs:views_last_month — число просмотров за последний месяц.

  • ya:ovs:views_last_week — число просмотров видео за последнюю неделю.

  • ya:ovs:views_total — общее число просмотров видео.

  • ya:ovs:comments — общее количество отзывов на видео.

  • ya:ovs:likes — общее число пользователей, которым понравилось видео.

  • ya:ovs:dislikes — общее число пользователей, которым не понравилось видео.

  • ya:ovs:rating — усредненный рейтинг видео (по целой шкале от 0 до 10).

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

<meta property="ya:ovs:views_last_day" content="5"/>
<meta property="ya:ovs:views_last_month" content="555"/>
<meta property="ya:ovs:views_last_week" content="25"/>
<meta property="ya:ovs:views_total" content="78787"/> 
<meta property="ya:ovs:comments" content="23"/> 
<meta property="ya:ovs:likes" content="78782"/> 
<meta property="ya:ovs:dislikes" content="5"/> 
<meta property="ya:ovs:rating" content="9"/>

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

Ограничения на показ видео задаются с помощью тегов og:restrictions.

Международные ограничения

С помощью элементов og:restrictions:country:allowed и og:restrictions:country:disallowed вы можете точно указать ограничения на международные показы видео:

  • Элемент og:restrictions:country:allowed рекомендуется использовать, если видео разрешено показывать только в определенных странах.

  • Элемент og:restrictions:country:disallowed рекомендуется использовать, если показ видео ограничен только в некоторых странах. Совместное использование этих двух элементов приведет к ошибке.

Страны следует указывать в формате ISO 3166-1. Несколько ограничений можно перечислить через запятую или указать в отдельных элементах.

Возрастные ограничения

С помощью элемента og:restrictions:age вы можете указать возрастные ограничения на показ видео.

Платный доступ к просмотру видео

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

  • ya:ovs:price:rate — стоимость видео (в соответствии с типом оплаты).

  • ya:ovs:price — тип оплаты видео.

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

    • rent — право на просмотр в течение ограниченного времени,

    • subscription — подписка на серию роликов или на длительный срок,

    • purchase — приобретение видео,

    • currency — валюта в формате ISO 4217.

    • duration— продолжительность (для платы за период времени) в формате ISO 8601.

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

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

Свойство

Тип

Описание

og:title

String

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

Максимальная длина — 1000 символов, более длинный текст обрезается.

og:url

URL

Канонический путь к странице, например: http://myhost.ru/video.html.

og:video

URL

Путь к видеоплееру или файлу.

og:image

URL

URL заставки видео.

Минимальный размер 120х90 пикселей. Допустимые форматы — JPG, PNG и GIF.

og:description

String

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

Рекомендуемый объем описания видео от 150 до 1000 символов.

ya:ovs:upload_date

DateTime

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

ya:ovs:adult

Boolean

Признак контента с возрастным ограничением 18+.

Чтобы отметить видео для взрослых, укажите значение «true». Если возрастное ограничение не требуется, укажите значение «false».

video:duration

Integer

Длительность видео в секундах с округлением до целого числа.

og:type

String

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

Некоторые категории могут требовать дополнительные поля для описания видео.

og:video:type

String

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

Дополнительные

ya:ovs:content_id

String

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

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

ya:ovs:status

Enum

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

Несколько статусов можно перечислить через запятую или указать в нескольких тегах <meta>.

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

  • published — опубликовано.

  • blocked — заблокировано.

  • private — защищено настройками приватности.

  • processing — обрабатывается.

  • deleted — удалено.

ya:ovs:login

String

Имя пользователя, загрузившего видео.

ya:ovs:is_official

Boolean

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

Чтобы указать, что видео официальное, задайте поле со значением «true». Если поля ya:ovs:is_official в фиде нет, Яндекс сочтет видео неофициальным.

ya:ovs:license

Enum

Тип лицензии на видеоконтент.

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

  • «cc» — лицензия Creative Commons

  • «commercial» — коммерческая лицензия

og:restrictions:country:allowed

String

Список стран, в которых разрешен показ данного видео.

Подробнее см. в разделе Ограничение показов.

og:restrictions:country:disallowed

String

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

Подробнее см. в разделе Ограничение показов.

og:restrictions:age

String

Возрастные ограничения для данного видео.

Подробнее см. в разделе Ограничение показов.

ya:ovs:available_platform

Enum

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

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

<meta property="ya:ovs:available_platform" content="Windows"/>
<meta property="ya:ovs:available_platform" content="WindowsPhone"/>
Полный список поддерживаемых значений

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

    • Windows

    • Linux

    • OSX

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

    • iOS

    • Android

    • WindowsPhone

    • WindowsMobile

    • Symbian

    • Bada

    • BlackBerry

    • MeeGo

og:video:width

Integer

Ширина видео в пикселях.

og:video:height

Integer

Высота видео в пикселях.

ya:ovs:bitrate

Integer

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

ya:ovs:quality

Enum

Качество кодирования видео.

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

  • 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).

ya:ovs:allow_embed

Boolean

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

По умолчанию видео можно проигрывать прямо в результатах поиска. Чтобы видео можно было посмотреть только на вашем сайте, задайте поле так:
<meta property="ya:ovs:allow_embed" content="false"/>

ya:ovs:embed_html

String

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

ya:ovs:content_url

URL

URL видеофайла.

Допускаются любые форматы видео — .mpg, .mpeg, .mp4, .m4v, .mov, .wmv, .asf, .avi, .ra, .ram, .rm, .flv и так далее.

Роботу Яндекса необходим доступ к видеофайлу для извлечения и актуализации дополнительной информации о видео. Если вы запретили публичный доступ к файлу, рекомендуем воспользоваться обратным DNS-запросом, чтобы разрешить скачивание только роботу Яндекса.

ya:ovs:content_url:public

Boolean

Признак публичности видео.

Доступные значения:

  • true — видеофайл могут скачивать пользователи

  • false — видеофайл может скачать только поисковый робот, для автоматизированного анализа видеопотока

ya:ovs:category

String

Категория видео («музыка», «фильм», «сериал» и т. п.).

ya:ovs:genre

String

Жанр видео, в свободной форме (рок, драма, пародия).

Вы можете указать несколько жанров, через запятую или в отдельных элементах genre. Списки популярных жанров можно найти в статьях Википедии, посвященных жанрам игрового кино и музыкальным жанрам.

video:tag

String

Ключевые слова (теги), характеризующие видео.

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

ya:ovs:languages

String

Список языков, для которых в видео присутствуют звуковые дорожки.

Несколько языков можно перечислить через запятую или указать в отдельных элементах. Языки следует указывать в формате ISO 639-1.

ya:ovs:dubbing

String

Название студии дубляжа.

ya:ovs:subtitle

URL

Ссылка на файл субтитров на определенном языке.

ya:ovs:subtitle:language

String

Язык субтитров в формате ISO 639-1.

ya:ovs:price

Enum

Тип оплаты видео.

ya:ovs:price:duration

DateTime

Продолжительность оплаты (за период времени) в формате ISO 8601.

ya:ovs:price:rate

Integer

Стоимость видео (соответственно типу оплаты в поле ya:ovs:price).

ya:ovs:price:currency

String

Валюта, в которой указана стоимость видео (в формате ISO 4217).

ya:ovs:feed_url

URL

Адрес, по которому можно получить актуальные метаданные о видео.

Может совпадать с адресом страницы видео, при наличии достаточно полной семантической разметки.

ya:ovs:views_last_day

Integer

Число просмотров видео за последний день.

ya:ovs:views_last_month

Integer

Число просмотров за последний месяц.

ya:ovs:views_last_week

Integer

Число просмотров видео за последнюю неделю.

ya:ovs:views_total

Integer

Общее число просмотров видео.

ya:ovs:comments

Integer

Общее количество отзывов на видео.

ya:ovs:likes

Integer

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

ya:ovs:dislikes

Integer

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

ya:ovs:rating

Integer

Усредненный рейтинг видео (по целой шкале от 0 до 10).

ya:ovs:person

String

Имя человека, участвовавшего в съемке видео.

ya:ovs:person:role

String

Участник видео с указанием его роли в создании видео.

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

ya:ovs:production_coumpany

String

Компания, создавшая видео.

ya:ovs:country

String

Страна, в которой было создано видео.

Несколько стран можно перечислить через запятую или указать в отдельных элементах. Страны следует указывать в формате ISO 3166-1.

ya:ovs:poster

URL

Ссылка на изображение обложки альбома, постера фильма и т. п.

Несколько изображений можно указать в нескольких элементах poster. Минимальный размер изображения — 256×360. Поддерживаются форматы JPG, PNG и GIF.

ya:ovs:created_date

DateTime

Дата создания видео в формате ISO 8601.

ya:ovs:modify_date

DateTime

Дата изменения видео в формате ISO 8601.

ya:ovs:expiration_date

DateTime

Дата истечения срока прав на видеоконтент в формате ISO 8601.

Не следует указывать, если права на видео не имеют срока действия.

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

<!--Обязательные поля-->
<html prefix="og: http://ogp.me/ns#
             video: http://ogp.me/ns/video#
             ya: http://webmaster.yandex.ru/vocabularies/">
 <head>
  ...
  <meta property="og:title" content="Что такое schema.org"/>
  <meta property="ya:ovs:id" content="3543"/>
  <meta property="og:url" content="http://mysite.com/view/308/"/>
  <meta property="og:description" content="Schema.org — это стандарт семантической разметки данных в сети, объявленный поисковыми системами Google, Bing и Yahoo! летом 2011 года. Цель семантической разметки — сделать интернет более понятным, структурированным и облегчить поисковым системам и специальным программам извлечение и обработку информации для удобного её представления в результатах поиска."/>
  <meta property="video:duration" content="4878787787"/>
  <meta property="og:image" content="http://yandex.st/lego/_/X31pO5JJJKEifJ7sfvuf3mGeD_8.png"/>
  <meta property="ya:ovs:upload_date" content="2013-06-05T00:00:00"/>
  <meta property="ya:ovs:adult" content="false"/>
  <meta property="og:type" content="video.other"/>
  <meta property="og:video:type" content="flash"/>

<!--Дополнительные поля-->
  <meta property="ya:ovs:status" content="published"/>
  <meta property="ya:ovs:login" content="ivan1"/>
  <meta property="ya:ovs:is_official" content="true"/>
  <meta property="ya:ovs:license" content="cc"/>
  <meta property="og:restrictions:country:allowed" content="Ru, Ua, Us, Uk"/>
  <meta property="ya:ovs:available_platform" content="Desktop"/>
  <meta property="og:video:width" content="350"/>
  <meta property="og:video:height" content="700"/>
  <meta property="ya:ovs:bitrate" content="254"/>
  <meta property="ya:ovs:quality" content="low"/>
  <meta property="ya:ovs:allow_embed" content="true"/>
  <meta property="og:video" content="//mysite.com/iframe/yacinema/123/"/>
  <meta property="ya:ovs:embed_html" content="
   <object data=&quot;//mysite.com/r5cia8fb8q.4708/&quot; id=&quot;flash&quot;
    type=&quot;application/x-shockwave-flash&quot; height=&quot;240&quot; width=&quot;320&quot;/>
   <param value=&quot;always&quot; name=&quot;allowscriptaccess&quot;/>
   <param value=&quot;true&quot; name=&quot;allowFullScreen&quot;/>
   <param value=&quot;high&quot; name=&quot;quality&quot;/>
   <param value=&quot;#000000&quot; name=&quot;bgcolor&quot;/><param value=&quot;true&quot; 
    name=&quot;allowfullscreen&quot;/>
   <param value=&quot;playlist=13470&quot; name=&quot;flashvars&quot;/></object>"/>
  <meta property="ya:ovs:content_url" content="http://mysite.com/r5cia8fb8q.4708/111.swf"/>
  <meta property="ya:ovs:content_url:public" content="true"/>
  <meta property="ya:ovs:category" content="education"/>
  <meta property="ya:ovs:genre" content="technology"/>
  <meta property="video:tag" content="technology"/>
  <meta property="video:tag" content="schema.org"/>
  <meta property="ya:ovs:languages" content="ru"/>
  <meta property="ya:ovs:subtitle" content="http://mysite.com/r5cia8fb8q.4708/sdf.str"/>
  <meta property="ya:ovs:subtitle:language" content="ru"/>
  <meta property="ya:ovs:price" content="rent"/>
  <meta property="ya:ovs:price:duration" content="P1DT12H"/>
  <meta property="ya:ovs:price:rate" content="50"/>
  <meta property="ya:ovs:price:currency" content="rur"/>
  <meta property="ya:ovs:feed_url" content="http://example.com/user111/view24/view24.xml"/>
  <meta property="ya:ovs:price:currency" content="rur"/>
  <meta property="ya:ovs:views_last_day" content="5"/>
  <meta property="ya:ovs:views_last_month" content="555"/>
  <meta property="ya:ovs:views_last_week" content="25"/>
  <meta property="ya:ovs:views_total" content="78787"/> 
  <meta property="ya:ovs:comments" content="23"/> 
  <meta property="ya:ovs:likes" content="78782"/> 
  <meta property="ya:ovs:dislikes" content="5"/> 
  <meta property="ya:ovs:rating" content="9"/> 
  <meta property="ya:ovs:person" content="Иван Иванов"/> 
  <meta property="ya:ovs:person:role" content="director"/>
  <meta property="ya:ovs:person" content="Иван Петров"/> 
  <meta property="ya:ovs:person:role" content="host"/>
  <meta property="ya:ovs:production_company" content="yandes"/> 
  <meta property="ya:ovs:country" content="Ru"/> 
  <meta property="ya:ovs:poster" 
   content="http://yandex.st/lego/_/X31pO5JJJKEifJ7sfvuf3mGeD_8.png"/> 
  <meta property="ya:ovs:created_date" content="2012-11-08T00:00:00"/> 
  <meta property="ya:ovs:modify_date" content="2013-06-05T00:00:00"/> 
  <meta property="ya:ovs:expiration_date" content="2023-06-05T00:00:00"/>
Написать в службу поддержки



Также вы можете перейти на сервис