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

Мінімальний приклад розмітки

Нижче перераховано усі властивості розмітки відео, оброблювані роботом Яндекса.

Властивість Тип Опис
og:title

String

Назва відео.

Максимальна довжина — 1000 символів, довший текст буде обрізано.

og:url

URL

Канонічний шлях до сторінки, наприклад: https://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

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

Деякі дані потрібні для коректного індексування відеоролика. Мінімальний опис відео в розмітці 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" href="https://www.mysite.com/view/308/"/> 
  <meta property="og:video" href="https://www.mysite.com/iframe/yacinema/123/"/> 
  <meta property="og:description" content="Стандарт Open Graph розроблено соціальною мережею Facebook. Він дозволяє контролювати прев'ю, яке формується під час публікації посилання на сайт у соціальних мережах, і передавати інформацію іншим інтернет-сервісам."/>  
  <meta property="video:duration" content="4878787787"/>
  <meta property="og:image" href="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>

Додавання плеєра

Примітка. Наразі в пошук Яндекс.Відео вбудовуються плеєри великих хостингів, на базі яких є не менше 1000 роликів.

Щоб ваш плеєр потрапив у результати пошуку за відео, повідомте про нього роботу Яндекса:

  1. Розмістіть плеєр на окремій сторінці.
  2. Дозвольте відтворювати відео в результатах пошуку Яндекса. Для цього додайте елемент ya:ovs:allow_embed зі значенням true.
    <meta property="og:video" href="https://www.mysite.com/iframe/yacinema/123/"/>
    <meta property="ya:ovs:allow_embed" content="true"/>
  3. Після того як ви зазначите плеєр у розмітці, напишіть нам про це через форму зворотного зв'язку. Ми протестуємо плеєр і повідомимо вам про результати.

Додаткова розмітка

Перелічені нижче поля необов'язкові для заповнення, але їх наявність дозволить краще індексувати ваші відеоролики і видавати їх на релевантні запити користувачів.

Формат відео

Підтримуються такі поля:

  • 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" href="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+02:00, де:

  • YYYY — рік

  • MM — місяць

  • DD — день

  • HH — година

  • mm — хвилина

  • ss — секунда

  • +02: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

Канонічний шлях до сторінки, наприклад: https://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: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

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

Варто зазначити, ким є ця людина, — актором, режисером, продюсером, виконавцем тощо.

Повний список підтримуваних професій

Задаючи елемент 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.

Не треба зазначати, якщо права на відео не мають строку дії.

Приклад докладного опису відео

<!--Обов'язкові поля-->
<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:id" content="3543"/>
  <meta property="og:url" href="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" href="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" href="https://www.mysite.com/iframe/yacinema/123/"/>
  
  <meta property="ya:ovs:content_url" href="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: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" href="https://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" href="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"/>