ПоискПочтаКартыМаркетНовостиСловариБлогиВидеоКартинки
Войти

Разметка Open Graph

Наш робот может индексировать видео на страницах, размеченных по стандарту OpenGraphProtocol.

Чтобы разметить страницы нужным образом, в теге <html> нужно указать пространство имен, а в элемент <head> включить теги <meta> с информацией о видео.

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

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

Пространство имен для расширения Яндекса следует указывать в теге <html> вместе с prefix="og: http://ogp.me/ns#".

<html prefix="og: http://ogp.me/ns#"
      prefix="ya: http://webmaster.yandex.ru/vocabularies/">

Разметка видео

Некоторые данные необходимы для корректной индексации видеоролика. Минимальное описание видео в разметке 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="Что такое schema.org"/> <!--Название видео-->
  <meta property="og:url" content="http://mysite.com/view/308/" /> <!--Канонический путь к странице-->
  <meta property="og:video" content="http://mysite.com/video/?clid=1222111&filmId=142936078" /> <!--Путь к видеоплееру или файлу-->
  <meta property="og:description" content="Schema.org - это стандарт семантической разметки данных в сети, объявленный поисковыми системами Google, Bing и Yahoo! летом 2011 года.
    Цель семантической разметки — сделать интернет более понятным, структурированным и облегчить поисковым системам и специальным программам извлечение и обработку информации для удобного её представления в результатах поиска."/> <!--Описание видео-->
  <meta property="video:duration" content="4878787787"/><!--Длительность видео в секундах-->
  <meta property="og:image" content="http://i1.ytimg.com/vi/xcL-oGPxgCg/maxresdefault.jpg" /> <!--URL заставки видео-->
  <meta property="ya:ovs:upload_date" content="2013-06-05"/><!--Дата загрузки видео в формате ISO 8601-->
  <meta property="ya:ovs:adult" content="false"/><!--Признак контента с возрастным ограничением 18+ -->
  <meta property="og:type" content="video.other"/><!--Тип видео-->
  <meta property="og:video:type" content="flash"/><!--Доступные кодеки для данного формата видео-->
</head>

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

Элемент

Тип данных

Описание

Обязательные поля

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+.

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

video:duration

Integer

Длительность видео в секундах.

og:type

String

Тип видео. Указанный тип может требовать дополнительные поля для описания видео. Подробно эти поля описаны в разделе Разметка различных типов видео.

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

  • «video.movie» — фильм
  • «video.episode» — серия сериала
  • «video.tv_show» — эпизод телешоу
  • «ya:ovs:broadcast» — трансляция
  • «ya:ovs:music» — музыкальное видео
  • «video.other» — видео, не принадлежащее ни одной из поддерживаемых категорий

og:video:type

Integer

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

Необязательные поля

ya:ovs:content_id

String

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

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

ya:ovs:status

Enum

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

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

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

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

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

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

  • «deleted» — удалено

ya:ovs:login

String

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

ya:ovs:is_official

Boolean

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

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

ya:ovs:license

Enum

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

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

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

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

og:restrictions:country:allowed

String

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

og:restrictions:country:disallowed

String

Список стран, в которых показ данного видео запрещен или ограничен. Подробно о международных ограничениях читайте подраздел Ограничения показов видеo.

og:restrictions:age

String

Возрастные ограничения для данного видео. Подробно об ограничениях читайте подраздел Ограничения показов видеo.

ya:ovs:available_platform

Enum

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

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

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

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

  • «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 и 717 kbps соответственно, но ниже, чем HD);
  • HD — HD-качество (разрешение и битрейт выше, чем 720×1280 и 1 Mbps соответственно, но ниже, чем full HD);
  • 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

String

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

ya:ovs:genre

String

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

video:tag

String

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

ya:ovs:languages

String

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

ya:ovs:dubbing

String

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

ya:ovs:subtitle

URL

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

ya:ovs:subtitle:language

String

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

ya:ovs:price

Enum

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

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

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

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

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

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

Во вложенных элементах можно привести статистику по данному видео.

ya:ovs:price:duration

DateTime

duration — продолжительность (для платы за период времени) в формате 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

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

Предлагаемые Яндексом профессии

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

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

  • Актер (Actor)

  • Акустическая гитара (Acoustic Guitar)

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

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

  • Ведущий (Host)

  • Вокал (Vocalist)

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

  • Дирижёр (Conductor)

  • Дублер (Double)

  • Дубляж (Dubbing)

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

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

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

  • Клавишные (Keyboard)

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

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

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

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

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

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

  • Подбор актеров (Casting)

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

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

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

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

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

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

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

  • Свет (Gaffer)

  • Скрипка (Violin)

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

  • Ударные (Drums)

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

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

  • Электрогитара (Electric guitar)

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. Не следует указывать, если права на видео не имеют срока действия.

Разметка различных типов видео

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

Фильм

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

Поле

Тип данных

Описание

Необязательные поля

ya:ovs:original_name

String

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

video:release_date

DateTime

Дата выхода фильма.

ys:ovs:movie:part

Integer

Номер части, для фильмов из нескольких частей, например «Гарри Поттер и Дары смерти: Часть 1».

Серия сериала

Поле

Тип данных

Описание

Обязательные поля

ya:ovs:episode

Integer

Номер эпизода.

Необязательные поля

ya:ovs:original_name

String

Название эпизода на языке производителя.

video:release_date

DateTime

Дата выхода серии в эфир.

ya:ovs:season

Integer

Номер сезона, в состав которого входит эпизод.

Эпизод телешоу

Поле

Тип данных

Описание

Обязательные поля

ya:ovs:episode

Integer

Номер выпуска телешоу.

Необязательные поля

video:release_date

DateTime

Дата выхода выпуска телешоу.

ya:ovs:season

Integer

Номер сезона, в состав которого входит выпуск.

Трансляция

Поле

Тип данных

Описание

Обязательные поля

ya:ovs:start_date

DateTime

Дата и время начала трансляции.

Необязательные поля

ya:ovs:end_date

DateTime

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

Музыкальное видео

Поле

Тип данных

Описание

ya:ovs:track_name

String

Название трека.

Необязательные поля

ya:ovs:album

String

Название альбома, в состав которого входит трек.

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

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

Международные

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

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

Возрастные

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

Формат даты

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

  • YYYY — год

  • MM — месяц

  • DD — день

  • HH — час

  • mm — минута

  • ss — секунда

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

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

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

<!--обязательные поля-->
<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://i1.ytimg.com/vi/xcL-oGPxgCg/maxresdefault.jpg"/>
  <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"/>

<!--дополнительные поля-->
  <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 string" 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="http://mysite.com/r5cia8fb8q.4708/"/>
  <meta property="ya:ovs:embed_html" content="<![CDATA[
  <object data="http://mysite.com/r5cia8fb8q.4708/" id="flash" type="application/x-shockwave-flash" height="240" width="320"><param value="always" name="allowscriptaccess"/><param value="true" name="allowFullScreen"/><param value="high" name="quality"/><param value="#000000" name="bgcolor"/><param value="true" name="allowfullscreen"/><param value="playlist=13470" name="flashvars"/></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://i1.ytimg.com/vi/xcL-oGPxgCg/maxresdefault.jpg"/> 
  <meta property="ya:ovs:created_date" content="2012-11-08"/> 
  <meta property="ya:ovs:modify_date" content="2013-06-05"/> 
  <meta property="ya:ovs:expiration_date" content="2023-06-05"/> 
Клавиатура
ruRu