Розмітка Schema.org для відео

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

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

ВластивістьТипОпис
urlURL

Посилання на відеоролик.

nameText

Назва відео.

descriptionText

Опис відео.

durationDuration

Тривалість відео.

isFamilyFriendlyBoolean

Ознака, що визначає, чи можна дивитися цей відеоролик дітям:

  • true — якщо можна дивитися дітям.
  • false — якщо є елементи, які оцінюються законом або власником сайту як неприпустимі для дітей.
thumbnailImageObject

Опис зображення при попередньому перегляді.

uploadDateDate

Дата завантаження відеоролика на сайті у форматі ISO 8601.

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

<div itemscope itemtype="http://schema.org/VideoObject" > 
<!--Зазначення типу об'єкта-->
    <a itemprop="url" href="https://www.mysite.com/view/306/">
    <h1 itemprop="name">Що таке Schema.org</h1></a>
    <p itemprop="description">Schema.org – це стандарт семантичної розмітки даних у мережі, оголошений пошуковими системами Google, Bing і Yahoo! влітку 2011 року. Мета семантичної розмітки — зробити інтернет зрозумілішим, структурованішим та полегшити пошуковим системам і спеціальним програмам добування й обробку інформації для зручного її представлення в результатах пошуку.</p>
    <meta itemprop="duration" content="PT6M58S">
    <meta itemprop="isFamilyFriendly" content="true">
    <p>Дата завантаження:<span itemprop="uploadDate">2013-06-05T00:00:00</span></p>
    <span itemprop="thumbnail" itemscope itemtype="http://schema.org/ImageObject"> 
    <img itemprop="contentUrl" src="https://www.mysite.com/images/preview/img1.jpg">
    <meta itemprop="width" content="250">
    <meta itemprop="height" content="120">
    </span>
</div>

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

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

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

  1. Розмістіть плеєр на окремій сторінці.
  2. Зазначте посилання на цю сторінку в елементі embedUrl.
    <link itemprop="embedUrl" href="https://www.mysite.com/iframe/yacinema/123/">
  3. Після того як ви зазначите плеєр у розмітці, напишіть нам про це через форму зворотного зв'язку. Ми протестуємо плеєр і повідомимо вам про результати.

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

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

Формат відео

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

  • height — висота відеоролика.

  • width — ширина відеоролика.

  • bitrate — максимальний бітрейт, у кілобітах за секунду (kbps).

  • videoQuality — якість кодування відео.

    Підтримувані значення:

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

  • contentSize — розмір відео в кілобайтах.

Категорії відео

Параметри плеєра

Підтримувані характеристики:

  • embedUrl — iframe-посилання для вставлення плеєра, який програє відео.

  • allowEmbed — ознака того, що відео можна показувати на сторінці результатів пошуку Яндекса.

    За замовчуванням відео можна програвати прямо в результатах пошуку.

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

    За наявності кількох доступних кодеків їх слід зазначати через кому.

  • availablePlatform — платформа, на якій можна відтворити це відео.

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

    • Windows

    • Linux

    • OSX

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

    • iOS

    • Android

    • WindowsPhone

    • WindowsMobile

    • Symbian

    • Bada

    • BlackBerry

    • MeeGo

Формат дати

Дати зазначаються у форматі ISO 8601.

Підтримувані характеристики:

  • dateCreated — дата створення відеоролика.

  • datePublished — дата першої публікації відеоролика.

  • dateModified — дата зміни інформації про відео на сайті.

  • expires — дата, після якої відео буде недоступне.

    Використовується, наприклад, якщо права на відео обмежені за часом.

Приклад розмітки:

<meta itemprop="dateCreated" content="2012-11-08">
<meta itemprop="datePublished" content="2013-06-05">
<meta itemprop="dateModified" content="2013-07-22"> 

Статистика

Підтримувані характеристики:

  • interactionCount — лічильники специфічних типів користувацької взаємодії з відеороликом.

    Ви можете зазначити такі типи лічильників у форматі назваЛічильника:число:

    • UserComments — кількість коментарів;

    • UserLikes — кількість користувачів, яким сподобалося відео;

    • UserDislikes — кількість користувачів, яким не сподобалося відео;

    • UserViewsLastMonth — кількість переглядів за останній місяць;

    • UserViewsLastWeek — кількість переглядів за останній тиждень;

    • UserViewsLastDay — кількість переглядів за останній день;

    • UserViews — загальна кількість переглядів.

  • aggregateRating — загальний рейтинг, що базується на збиранні користувацьких оцінок відео.

    Для узагальненого рейтингу можуть бути вказані такі параметри:

    • worstRating — нижнє значення рейтингу (за замовчуванням 1);

    • bestRating — верхнє значення рейтингу (за замовчуванням 5);

    • ratingValue — значення рейтингу;

    • ratingCount — кількість оцінок, на яких базується рейтинг.

Приклад розмітки:

<meta itemprop="interactionCount" content="UserComments:18" />
<meta itemprop="interactionCount" content="UserLikes:152" />
<meta itemprop="interactionCount" content="UserDislikes:3" />
<meta itemprop="interactionCount" content="UserViewsLastMonth:25550" />
<meta itemprop="interactionCount" content="UserViewsLastWeek:2544" />
<meta itemprop="interactionCount" content="UserViewsLastDay:2154" />
<meta itemprop="interactionCount" content="UserViews:2154587" />
<div itemprop="aggregateRating" itemscope itemtype="http://schema.org/AggregateRating">
  <meta itemprop="worstRating" content="1">
  <meta itemprop="bestRating" content="5">
  <meta itemprop="ratingValue" content="5">
  <meta itemprop="ratingCount" content="2545">
</div>

Обмеження показів

Підтримувані характеристики:

  • allowCountries — перелік країн, у яких доступний цей відеоролик із зазначенням мінімального віку глядачів. Наприклад, RU (18+), US (16+), UK (12+).

    Це поле рекомендовано використовувати, коли для показу відеоролика визначено фіксований перелік країн, для решти країн ролик недоступний.

  • disallowCountries — перелік країн, у яких заборонено або обмежено до показу цей відеоролик.

    Це поле використовується у випадках, коли перегляд дозволено без обмежень у більшості країн.

    У разі обмеження до показу зазначається мінімальний вік глядачів. Наприклад, RU (18+), US (16+), UK (12+).

Платний доступ до перегляду відео

Підтримувані характеристики:

  • offerType — тип доступу до відео.

    За замовчуванням відео вважається таким, що надається безкоштовно і без реєстрації. Щоб коректно розмітити тип доступу до відеоконтенту, потрібно додати у код сторінки посилання на відповідний XML-документ. Рекомендуємо використовувати для цього тег link:

    <link itemprop="offerType" href="https://yandex.ua/support/video/partners/schema-org.html#price"/>

    Підтримувані типи:

    • Free — відео доступне користувачеві без оплати і без обов'язкової реєстрації на сайті;

    • Buy — користувач отримує постійний доступ до перегляду конкретного відеоролика (купівля).

    • Rent — користувач отримує доступ до перегляду конкретного відеоролика на обмежений період часу (оренда).

    • Subscription — користувачеві надається доступ до відеороликів цієї серії на певний строк (підписка).

  • offers — умови отримання доступу до відеоролика.

  • price — ціна.

  • priceCurrency — валюта ціни.

    Зазначається у трилітерному форматі ISO 4217 (наприклад, UAH).

  • duration — тривалість підписки або оренди відеоролика.

    Зазначається у форматі ISO 8601 (наприклад, P1DT12H).

Властивості, які підтримує Яндекс.Відео

Примітка. Властивості, яких немає у стандарті, але підтримувані у розширенні Яндекса, виділені напівжирним шрифтом.
ВластивістьТипОпис
Обов'язкові
urlURL

Посилання на відеоролик.

nameText

Назва відео.

descriptionText

Опис відео.

durationDuration

Тривалість відео.

<meta itemprop="duration" content="PT6M58S">
isFamilyFriendlyBoolean

Ознака, що визначає, чи можна дивитися цей відеоролик дітям:

  • true — якщо можна дивитися дітям.
  • false — якщо є елементи, які оцінюються законом або власником сайту як неприпустимі для дітей.
thumbnailImageObject

Опис зображення при попередньому перегляді.

uploadDateDate

Дата завантаження відеоролика на сайті у форматі ISO 8601.

Додаткові
content_idText

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

Одне і те ж відео, розміщене на різних сторінках, повинне мати один і той же ідентифікатор у розмітці цих сторінок. Таким чином робот зможе уникнути індексування дублікатів;

authorPerson

Логін користувача, який завантажив ролик на сайт.

captionText

Підпис до відео.

contentUrlURL

Адреса, за якою доступний файл із відеороликом.

feedUrlURL

Адреса XML-фіда для цієї сторінки.

Якщо для сторінки є XML-фід рекомендованого формату, то за допомогою Schema.org можна зазначити лише категорію об'єкта і посилання на фід.

Проте можуть бути заповнені й інші поля. За наявності одночасно XML-фіда і заповнених полів Schema.org перевага надається фіду. У разі якщо з яких-небудь причин фід недоступний, дані буде отримано з мікророзмітки;

genreText

Тут може бути зазначено тематику (гумор, спорт, музика тощо) і жанр (комедія, драма, рок, поп) відео.

licenseText

Тип ліцензії, за якою поширюється відео.

imageURL

Офіційне зображення відео (постер фільму, обкладинка альбому).

productionCompanyText або Organization

Компанія-виробник відео.

isOfficialBoolean

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

Щоб показати, що відео офіційне, додайте атрибут isOfficial зі значенням true. Якщо це поле не заповнене, Яндекс визнає відео неофіційним.

statusText або URL

Стан, у якому зараз перебуває відео.

Доступні такі статуси:

  • published — відео опубліковане на сайті, загальнодоступне;

  • private — відео є на сайті, але доступ до нього обмежено;

  • blocked — відео заблоковано;

  • processing — відео завантажене і обробляється;

  • deleted — відео видалено з сайту.

heightDistance

Висота відеоролика.

widthDistance

Ширина відеоролика.

bitrateText

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

videoQualityText

Якість кодування відео. Підтримувані значення:

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

contentSizeText

Розмір відео у кілобайтах.

embedUrlURL

Iframe-посилання для вставлення плеєра, який програє відео.

allowEmbedBoolean

Ознака того, що відео можна показувати на сторінці результатів пошуку Яндекса. За замовчуванням відео можна програвати прямо в результатах пошуку.

playerTypeText

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

availablePlatformText

Платформа, на якій можна відтворити це відео.

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

  • Windows

  • Linux

  • OSX

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

  • iOS

  • Android

  • WindowsPhone

  • WindowsMobile

  • Symbian

  • Bada

  • BlackBerry

  • MeeGo

dateCreatedDate

Дата створення відеоролика.

datePublishedDate

Дата першої публікації відеоролика.

dateModifiedDate

Дата зміни інформації про відеоролик на сайті.

expiresDate

Дата, після якої відео не буде доступне.

Використовується, наприклад, якщо права на відео обмежені за часом.

interactionCountText

Лічильники специфічних типів користувацької взаємодії з відеороликом.

Докладніше див. у розділі Статистика.

aggregateRatingAggregateRating

Загальний рейтинг, що базується на збиранні користувацьких оцінок відео.

Докладніше див. у розділі Статистика.

allowCountriesText

Перелік країн, у яких доступний цей відеоролик із зазначенням мінімального віку глядачів. Наприклад, RU (18+), US (16+), UK (12+).

Це поле рекомендовано використовувати, коли для показу відеоролика визначено фіксований перелік країн, для решти країн ролик недоступний.

disallowCountriesText

Перелік країн, у яких заборонено або обмежено до показу цей відеоролик.

Це поле використовується у випадках, коли перегляд дозволено без обмежень у більшості країн. У разі обмеження до показу зазначається мінімальний вік глядачів. Наприклад, RU (18+), US (16+), UK (12+).

productionCountryText

Країна-виробник.

Зазначається у форматі ISO 3166-1.

inLanguageText

Мова відеоролика.

Код мови зазначається у форматі ISO 639 (наприклад, EN).

dubbingText

Студія, що дублювала відео.

offersOffer

Умови отримання доступу до відеоролика.

price

Ціна.

priceCurrencyText

Валюта, у якій зазначено ціну.

Для зазначення ціни використовуйте трилітерний формат ISO 4217 (наприклад, UAH).

offerTypeText або URL

Тип доступу до відео.

За замовчуванням відео вважається таким, що надається безкоштовно і без реєстрації. Щоб коректно розмітити тип доступу до відеоконтенту, потрібно додати у код сторінки посилання на відповідний XML-документ. Рекомендуємо використовувати для цього тег link:

<link itemprop="offerType" href="https://yandex.ua/support/video/partners/schema-org.html#price"/>

Підтримувані типи:

  • Free — відео доступне користувачеві без оплати і без обов'язкової реєстрації на сайті;

  • Buy — користувач отримує постійний доступ до перегляду конкретного відеоролика (купівля).

  • Rent — користувач отримує доступ до перегляду конкретного відеоролика на обмежений період часу (оренда).

  • Subscription — користувачеві надається доступ до відеороликів цієї серії на певний строк (підписка).

duration

Тривалість підписки або оренди відеоролика. Зазначається у форматі ISO 8601 (наприклад, P1DT12H).

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

<div itemscope itemtype="http://schema.org/VideoObject">

<!-- Основні характеристики -->
    <link itemprop="url" href="https://www.mysite.com/view/308/">
    <meta itemprop="name" content="Що таке schema.org">
    <meta itemprop="description" content="Schema.org – це стандарт семантичної розмітки даних у мережі, оголошений пошуковими системами Google, Bing і Yahoo! влітку 2011 року.
    Мета семантичної розмітки — зробити інтернет зрозумілішим, структурованішим та полегшити пошуковим системам і спеціальним програмам добування й обробку інформації для зручного її представлення в результатах пошуку.">
    <meta itemprop="duration" content="PT6M58S">
    <span itemprop="author" itemscope itemtype="http://schema.org/Person"></span>
    <meta itemprop="genre" content="education">
    <link itemprop="feedUrl" href="https://example.com/user111/view24/view24.xml"> 
    <meta itemprop="content_id" content="3543">   
    <meta itemprop="isFamilyFriendly" content="true">
    <meta itemprop="license" content="СС">
    <link itemprop="image" href="https://www.mysite.com/vi/xcL-oGPxgCg/maxresdefault.jpg">
    <meta itemprop="productionCompany" content="yandex">
    <meta itemprop="status" content="published">

<!-- Дати -->
    <meta itemprop="uploadDate" content="2013-06-05T00:00:00">
    <meta itemprop="dateCreated" content="2012-11-08T00:00:00">
    <meta itemprop="dateModified" content="2013-06-05T00:00:00">
    <meta itemprop="datePublished" content="2013-06-05T00:00:00">    

<!-- Зображення -->
    <span itemprop="thumbnail" itemscope itemtype="http://schema.org/ImageObject">
      <link itemprop="contentUrl" href="http://i1.ytimg.com/vi/xcL-oGPxgCg/maxresdefault.jpg">
      <meta itemprop="width" content="250">
      <meta itemprop="height" content="120">
    </span>

<!-- Плеєр -->
      <link itemprop="embedUrl" href="https://www.mysite.com/iframe/yacinema/r5cia8fb8q.4708/">
      
      <meta itemprop="allowEmbed" content="true">
      <meta itemprop="playerType" content="Flash">
      <meta itemprop="width" content="1920">
      <meta itemprop="height" content="1080">
      <meta itemprop="videoQuality" content="full HD">
      <meta itemprop="bitrate" content="526">
      <meta itemprop="contentSize" content="526000">
      <meta itemprop="availablePlatform " content="Mobile">

<!-- Регіональність -->
      <meta itemprop="allowCountries" 
      content="RU (18+), US (16+), UK (12+), TR, AF (18+), AG (11+)">
      <meta itemprop="productionCountry" content="RU"> 
      <meta itemprop="inLanguage" content="RU">

<!-- Ціна -->
      <span itemprop="offers" itemscope itemtype="http://schema.org/Offer">
        <meta itemprop="price" content="15">
        <meta itemprop="priceCurrency" content="USD">
        <link itemprop="offerType"  
        href="https://yandex.ua/support/video/partners/schema-org.html#price">
        <meta itemprop="duration" content="P1DT12H">
      </span>

<!-- Статистика -->
      <meta itemprop="interactionCount" content="UserComments:18"/>
      <meta itemprop="interactionCount" content="UserLikes:152"/>
      <meta itemprop="interactionCount" content="UserDislikes:3"/>
      <meta itemprop="interactionCount" content="UserViewsLastMonth:25550"/>
      <meta itemprop="interactionCount" content="UserViewsLastWeek:2544"/>
      <meta itemprop="interactionCount" content="UserViewsLastDay:2154"/>
      <meta itemprop="interactionCount" content="UserViews:2154587"/>
      <div itemprop="aggregateRating" itemscope itemtype="http://schema.org/AggregateRating">
       <meta itemprop="worstRating" content="1">
       <meta itemprop="bestRating" content="5">
       <meta itemprop="ratingValue" content="5">
       <meta itemprop="ratingCount" content="2545">
      </div>
</div>