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

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

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

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

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

name Text

Назва відео.

description Text

Опис відео.

duration Duration

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

isFamilyFriendly Boolean

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

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

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

uploadDate Date

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

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

<div itemscope itemtype="http://schema.org/VideoObject" > 
<!--Зазначення типу об'єкта-->
    <a itemprop="url" href="http://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="http://mysite.com/images/preview/img1.jpg">
    <meta itemprop="width" content="250">
    <meta itemprop="height" content="120">
    </span>
</div>

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

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

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

  • Розмістіть плеєр на окремій сторінці та зазначте посилання на цю сторінку в елементі embedUrl.

    <link itemprop="embedUrl" content="//mysite.com/iframe/yacinema/123/">
  • Передайте HTML-код для вбудовування вашого плеєра, перетворивши його у тег embedHTML.

    <div itemprop="embedHTML"><iframe width="640" height="360" src="//mysite.com/123/?feature=player_detailpage" frameborder="0" allowfullscreen=></iframe></div>

Після того як ви зазначите плеєр у розмітці, напишіть нам про це через форму зворотного зв'язку. Ми протестуємо плеєр і повідомимо вам про результати.

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

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

    Формат відео

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

    • 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-посилання для вставлення плеєра, який програє відео.

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

      Зазначається, якщо не вдалося сформувати iframe-посилання для поля embedURL.

    • 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://webmaster.yandex.ru/vocabularies/Video/Subscription.xml"/>

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

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

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

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

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

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

    • price — ціна.

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

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

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

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

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

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

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

    name Text

    Назва відео.

    description Text

    Опис відео.

    duration Duration

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

    <meta itemprop="duration" content="PT6M58S">
    isFamilyFriendly Boolean

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

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

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

    uploadDate Date

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

    Додаткові
    content_id Text

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

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

    author Person

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

    caption Text

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

    contentUrl URL

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

    feedUrl URL

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

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

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

    genre Text

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

    license Text

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

    image URL

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

    productionCompany Text або Organization

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

    isOfficial Boolean

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

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

    status Text або URL

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

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

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

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

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

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

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

    height Distance

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

    width Distance

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

    bitrate Text

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

    videoQuality Text

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

    • 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 Text

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

    embedUrl URL

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

    embedHTML Text

    HTML-код для вставлення плеєра, що відтворює відео. Зазначається, якщо не вдалося сформувати iframe-посилання для поля embedURL.

    allowEmbed Boolean

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

    playerType Text

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

    availablePlatform Text

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

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

    • Windows

    • Linux

    • OSX

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

    • iOS

    • Android

    • WindowsPhone

    • WindowsMobile

    • Symbian

    • Bada

    • BlackBerry

    • MeeGo

    dateCreated Date

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

    datePublished Date

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

    dateModified Date

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

    expires Date

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

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

    interactionCount Text

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

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

    aggregateRating AggregateRating

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

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

    allowCountries Text

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

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

    disallowCountries Text

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

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

    productionCountry Text

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

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

    inLanguage Text

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

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

    dubbing Text

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

    offers Offer

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

    price

    Ціна.

    priceCurrency Text

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

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

    offerType Text або URL

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

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

    <link itemprop="offerType" href="https://webmaster.yandex.ru/vocabularies/Video/Subscription.xml"/>

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

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

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

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

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

    duration

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

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

    <div itemscope itemtype="http://schema.org/VideoObject">
    
    <!-- Основні характеристики -->
        <link itemprop="url" href="http://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="http://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="http://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="//mysite.com/iframe/yacinema/r5cia8fb8q.4708/">
          <div itemprop="embedHTML"><![CDATA[<iframe width="2133" height="1058"                
          src="//mysite.com/iframe/yacinema/123/" frameborder="0" allowfullscreen></iframe>]]></div>
          <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://webmaster.yandex.ua/vocabularies/Video/Subscription.xml">
            <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>