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

Проверка разметки

Для проверки соответствия разметки нашим требованиям вы можете воспользоваться валидатором. Обращаем внимание, что он не проверяет ваши страницы на полное соответствие стандарту Open Graph Protocol, а лишь тестирует наличие достаточной информации для индексирования вашего видео.

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

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

Свойство Тип Описание
og:title

String

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

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

og:url

URL

Канонический путь к странице, например: https://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#">

<!--Указание используемых префиксов-->
<head>
  <meta property="og:title" content="Open Graph для видео"/>
  <meta property="og:url" content="https://www.mysite.com/view/308/"/>
  <meta property="og:video" content="https://www.mysite.com/iframe/yacinema/123/"/>
  <meta property="og:description" content="Стандарт Open Graph позволяет контролировать превью, которое формируется при публикации ссылки на сайт в социальных сетях, и передавать информацию другим интернет-сервисам."/>
  <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>

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

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

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

После успешного тестирования плеер будет добавлен на страницу. Видео попадут в результаты поиска Яндекса. Если вы не хотите, чтобы ваши видео попадали в результаты поиска, см. раздел Запрет на показ видео в поиске.

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

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

Формат видео

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

  • 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), предполагает дополнительные поля, характеризующие его.

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

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

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

    <meta property="og:video" content="https://www.mysite.com/iframe/yacinema/123/"/>
    <meta property="ya:ovs:allow_embed" content="true"/>
  • 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:duplicate. Можно добавить до 10 дублей.

Пример разметки, когда у видео два дубля:

<meta property="ya:ovs:duplicate" content="https://vk.com/video-208726617_456239105"/>
<meta property="ya:ovs:duplicate" content="https://rutube.ru/video/ead49dddf9fa9aa76cb13bcbe77d4f96"/>

Яндекс объединяет одинаковые видео с разных видеохостингов в один документ, позволяя выбрать предпочтительный источник для воспроизведения. Подробнее см. в разделе Объединение дублей видео

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

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

Свойство Тип Описание
Обязательные
og:title

String

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

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

og:url

URL

Канонический путь к странице, например: https://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

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

Дополнительные
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

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

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

ya:ovs:embed_region_allowed

String

По аналогии с og:restrictions:country:allowed, но только для роботов Яндекса.

ya:ovs:embed_region_disallowed

String

По аналогии с og:restrictions:country:disallowed, но только для роботов Яндекса.

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: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: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

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

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

Cписок поддерживаемых профессий

Задавая элемент ovs:person, в значении атрибута role можно указывать как русские, так и английские названия профессий.

  • Автор текстов (Songwriter)

  • Актер (Actor)

  • Актер дубляжа (Dubbing mixer)

  • Аранжировщик (Arranger)

  • Барабанщик (Drummer)

  • Бас-гитарист (Bass guitar player)

  • Ведущий (Host)

  • Вокалист (Vocalist)

  • Директор картины (Executive producer)

  • Директор по подбору актеров (Casting director)

  • Дирижёр (Conductor)

  • Дублёр (Body double)

  • Звукооператор (Sound engineer)

  • Звукорежиссер (Sound designer)

  • Исполнитель на акустической гитаре (Acoustic guitar player)

  • Исполнитель на электрогитаре (Electric guitarist)

  • Исполнитель трюков (Stunt performer)

  • Клавишник (Keyboardist)

  • Композитор (Composer)

  • Консультант (Сonsultant)

  • Костюмер (Costume supervisor)

  • Оператор (Camera operator)

  • Оператор-постановщик (Camera director)

  • Осветитель (Gaffer)

  • Парикмахер (Hair stylist)

  • Помощник режиссера (Stage manager)

  • Постановщик трюков (Stunt coordinator)

  • Продюсер (Producer)

  • Редактор (Editor)

  • Режиссер монтажа (Film editor)

  • Режиссер-постановщик (Film director)

  • Ритм-гитарист (Rhythm guitarist)

  • Скрипач (Violinist)

  • Сценарист (Script writer)

  • Художник-постановщик (Production designer)

  • Художник по костюмам (Costume designer)

ya:ovs:production_company

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#">
 <head>
  ...
  <meta property="og:title" content="Что такое schema.org"/>
  <meta property="ya:ovs:content_id" content="3543"/>
  <meta property="og:url" content="https://www.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, 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="https://www.mysite.com/iframe/yacinema/123/"/>
  <meta property="ya:ovs:content_url" content="https://www.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="https://www.mysite.com/r5cia8fb8q.4708/sdf.str"/>
  <meta property="ya:ovs:subtitle:language" content="ru"/>
  <meta property="ya:ovs:feed_url" content="https://example.com/user111/view24/view24.xml"/>
  <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"/>