Разметка Open Graph

Наш робот может индексировать видео на страницах, размеченных по стандарту OpenGraphProtocol. Сам протокол достаточно распространён и лёгок в применении: всё что вам нужно — это добавить в блок <head> .... </head> HTML-страницы небольшое количество новых тегов.

Как добавить Open Graph разметку

Пример размещения ролика (Adobe Flash, HTML5 или просто файл):

Название — Мой любимый ролик
Описание — Формула 1, победа моей любимой команды
Типа ролика: Adobe Flash Video
Путь к ролику: http://myhost.ru/video/my_video.swf
Путь к обложке ролика — http://myhost.ru/video/my_video.jpg
Размер видеокартинки — 640x480
Длительность — 56 секунд

Чтобы ваш ролик был добавлен в индекс, блок head должен содержать примерно следующий текст:

<html xmlns:og="http://ogp.me/ns#">
<head>
............
    <meta property="og:title" content="Мой любимый ролик"/>
    <meta property="og:url" content="http://myhost.ru/video.html"/>
    <meta property="og:image" content="http://myhost.ru/video/my_video.jpg"/>
    <meta property="og:description" content="Формула 1, победа моей любимой команды"/>
    <meta property="og:video" content="http://myhost.ru/video/my_video.swf" />
    <meta property="og:video:height" content="640" />
    <meta property="og:video:width" content="480" />
    <meta property="og:duration" content="56" />
    <meta property="og:video:type" content="application/x-shockwave-flash" />
............
</head>

Больше ничего делать не нужно, при очередном обходе вашей страницы нашими роботами ролик будет автоматически добавлен в индекс Яндекс.Видео.

Обращаем внимание, что чрезмерно подробное описание ролика может быть расценено нашими алгоритмами как попытка спама, что приведет к игнорированию ролика.

Необходимый набор тегов

Ниже приведён весь список тегов из стандарта OpenGraphProtocol, поддерживаемых нашим роботом. Слово «желательно» в описании тегов означает, что мы анализируем этот тег и используем его, но он не является обязательным для попадания в индекс.

og:title — заголовок страницы/статьи/видеоролика (обязателен для индексации)
og:video — путь к видеоплееру или файлу (обязателен для индексации)
og:video:type — тип видео, например: application/x-shockwave-flash, video/webm, video/mp4, video/ogg (обязателен для индексации)
og:image — ссылка на обложку (обязательна для индексации)
og:description — описание страницы/статьи/видеоролика (желательно)
og:video:height и og:video:width — высота и ширина ролика (желательные атрибуты).
og:duration — длительность ролика в секундах (желательна)
og:url — канонический путь к странице, например: http://myhost.ru/video.html (необязателен)
og:latitude и og:longitude — широта и долгота места съемки (необязательны)

Обращаем внимание, что также обязательным является указание пространства имён: xmlns:og="http://ogp.me/ns#".

Пример правильного заполнения тега og:video и его проверка

<html xmlns:og="http://ogp.me/ns#">
............
<meta property ="og:video" content="http://myhost.ru/video/my_video.swf?param1=val1&param2=var2"/>
............
<body>
............
<object width="400" height="225">
    <param name="movie" value="http://myhost.ru/video/my_video.swf?param1=val1&param2=var2" />
    <param name="allowScriptAccess" value="sameDomain" />
    <param name="allowFullScreen" value="true" />
    <embed src="http://myhost.ru/video/my_video.swf?param1=val1&param2=var2"
            quality="high"
            allowscriptaccess="sameDomain"
            allowfullscreen="true"
            width="400"
            height="255"
            type="application/x-shockwave-flash">
    </embed>
</object>
............
</body>

Проверить правильность заполнения тега og:video можно, подставив значение тега в шаблон и проверив корректность отображения плеера в браузере.

Теги-синонимы из других форматов

Выражение «тег-синоним» означает, что теги являются синонимами с точки зрения робота Яндекса. Это не означает, что теги являются синонимами с точки зрения стандарта Open Graph Protocol. Вы можете выбрать тот набор тегов, который вам удобней, но мы рекомендуем использовать OpenGraphProtocol, как наиболее полный. Размечать одновременно несколько тегов-синонимов нет необходимости, но если вам нужно это не только для индексации видео, то нет ничего страшного, если будут присутствовать и title, и og:title. Правила обязательности тегов-синонимов аналогичны правилам для тегов Open Graph Protocol.

Обратите внимание, что имена тегов OpenGraphProtocol и синонимов задаются в разных атрибутах мета-тегов.

Список тегов-синонимов:

Как добавить Open Graph разметку

Необходимый набор тегов

Рекомендации по заполнению тегов

Пример правильного заполнения тега og:video и его проверка

Теги-синонимы из других форматов

Полезные инструменты