Обеспечьте показ своих видео в Google, используя разметку schema.org

Google Поиск позволяет находить и смотреть видео. Google будет пытаться автоматически извлечь сведения о вашем видео, однако вы можете воспользоваться объектом VideoObject и явным образом указать URL значка видео, описание ролика, данные о его продолжительности и дате загрузки и т. д. Видео могут показываться в результатах поиска Google, результатах поиска видео, Google Картинках и рекомендациях Google.

Скриншот с примером видеоконтента в результатах поиска Google и рекомендациях, а также на вкладке "Видео"

С помощью специальной разметки вы можете сделать представление видео в результатах поиска еще более удобным и информативным:

Способы улучшения видео

Пометка "Прямой эфир". Чтобы рядом с видео появлялась пометка "Прямой эфир", достаточно добавить для него свойство BroadcastEvent. Эту пометку можно добавить к любому общедоступному видео, которое транслируется в течение какого угодно периода времени. Вот некоторые примеры видео, к которым можно добавить такую пометку:

  • спортивные мероприятия;
  • церемонии вручения наград;
  • видеоролики авторитетных пользователей;
  • прямые трансляции видеоигр.

Чтобы роботы Google своевременно сканировали вашу страницу, соблюдайте специальные требования и пользуйтесь Indexing API.

Видео с пометкой "Прямой эфир" в результатах поиска

Домашние занятия. Помогите пользователям найти тренировки, которые можно выполнять дома. Ваши видеоролики и онлайн-мероприятия будут показываться в интерактивных расширенных результатах Google по запросам, связанным с тренировками в домашних условиях. После того как вы добавите на сайт структурированные данные типа Video, ваш контент сможет показываться в расширенных результатах поиска Google без каких-либо дополнительных действий с вашей стороны.

Более подробную информацию о доступности этой функции, инструкции по работе с ней, рекомендации и примеры вы найдете в статье Домашние занятия.

 Домашние занятия в результатах поиска

Ключевые моменты

С помощью функции ключевых моментов зритель может быстро переходить к определенным местам в видео, как будто открывая главу книги. Это помогает улучшить взаимодействие с вашим контентом. Google Поиск может самостоятельно обнаруживать основные эпизоды в вашем видео и предлагать их пользователям. Вам для этого не нужно ничего предпринимать. Однако вы можете вручную указать Google на важные моменты в видео, и они получат более высокий приоритет. Это можно сделать с помощью структурированных данных или описания на YouTube.

Чтобы не выделять ключевые моменты и запретить Google их автоматический показ, используйте метатег nosnippet.

Видео с ключевыми моментами в результатах поиска
Карусель видео с вашего сайта (ограниченный доступ). Если добавить структурированные данныеItemList, пользователи смогут знакомиться со страницами галереи ваших видео.

Как добавлять структурированные данные

Структурированные данные – стандартизированный формат, используемый для представления сведений о странице и классификации ее контента. Подробнее о принципах работы структурированных данных…

Ниже в общих чертах описано, как создать, проверить и добавить на сайт структурированные данные. Пошаговые инструкции вы найдете в этой практической работе.

  1. Добавьте обязательные свойства. Узнайте, в каких частях страницы нужно размещать структурированные данные выбранного вами формата.
  2. Следуйте рекомендациям.
  3. Протестируйте свой код с помощью инструмента проверки расширенных результатов.
  4. Опубликуйте страницу и с помощью инструмента проверки URL посмотрите, как она выглядит в результатах поиска Google. Убедитесь, что доступ Google к странице не заблокирован файлом robots.txt или метатегом noindex и для доступа к странице не требуется авторизация. Если все в порядке, запросите повторное сканирование ваших URL.
  5. Отправляйте нам файл Sitemap, чтобы информировать нас об изменениях на сайте. Отправку такого файла можно автоматизировать с помощью Search Console Sitemap API.

Примеры

Обычный расширенный результат с видео

Пример стандартных результатов поиска видео

Нажмите кнопку ниже, чтобы увидеть пример одного свойства VideoObject.

JSON-LD

<html>
  <head>
    <title>Introducing the self-driving bicycle in the Netherlands</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "name": "Introducing the self-driving bicycle in the Netherlands",
      "description": "This spring, Google is introducing the self-driving bicycle in Amsterdam, the world's premier cycling city. The Dutch cycle more than any other nation in the world, almost 900 kilometres per year per person, amounting to over 15 billion kilometres annually. The self-driving bicycle enables safe navigation through the city for Amsterdam residents, and furthers Google's ambition to improve urban mobility with technology. Google Netherlands takes enormous pride in the fact that a Dutch team worked on this innovation that will have great impact in their home country.",
      "thumbnailUrl": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "uploadDate": "2016-03-31T08:00:00+08:00",
      "duration": "PT1M54S",
      "contentUrl": "https://www.example.com/video/123/file.mp4",
      "embedUrl": "https://www.example.com/embed/123",
      "interactionStatistic": {
        "@type": "InteractionCounter",
        "interactionType": { "@type": "WatchAction" },
        "userInteractionCount": 5647018
      },
      "regionsAllowed": "US,NL"
    }
    </script>
  </head>
  <body>
  </body>
</html>
Микроданные

<html itemscope itemprop="VideoObject" itemtype="https://schema.org/VideoObject">
<head>
  <title itemprop="name">Introducing the self-driving bicycle in the Netherlands</title>
</head>
<body>
  <meta itemprop="uploadDate" content="2016-03-31T08:00:00+08:00" />
  <meta itemprop="duration" content="PT1M54S" />
  <p itemprop="description">This spring, Google is introducing the self-driving bicycle in Amsterdam, the world's premier cycling city. The Dutch cycle more than any other nation in the world, almost 900 kilometres per year per person, amounting to over 15 billion kilometres annually. The self-driving bicycle enables safe navigation through the city for Amsterdam residents, and furthers Google's ambition to improve urban mobility with technology. Google Netherlands takes enormous pride in the fact that a Dutch team worked on this innovation that will have great impact in their home country.</p>
  <div itemprop="interactionStatistic" itemtype="https://schema.org/InteractionCounter" itemscope>
    <meta itemprop="userInteractionCount" content="5647018" />
    <meta itemprop="interactionType" itemtype="https://schema.org/WatchAction" />
  </div>
  <link itemprop="embedUrl" href="https://www.example.com/embed/123" />
  <meta itemprop="contentUrl" content="https://www.example.com/video/123/file.mp4" />
  <meta itemprop="regionsAllowed" content="US,NL" />
  <meta itemprop="thumbnailUrl" content="https://example.com/photos/1x1/photo.jpg" />
</body>
</html>

Пометка "Прямой эфир"

Пример видео с пометкой "Прямой эфир" в результатах поиска

Примеры элементов VideoObject и BroadcastEvent.

JSON-LD

<html>
  <head>
    <title>Bald Eagle at the Park - Livestream</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "contentURL": "https://example.com/bald-eagle-at-the-park.mp4",
      "description": "Bald eagle at the park livestream.",
      "duration": "PT37M14S",
      "embedUrl": "https://example.com/bald-eagle-at-the-park",
      "expires": "2018-10-30T14:37:14+00:00",
      "regionsAllowed": "US",
      "interactionStatistic": {
        "@type": "InteractionCounter",
        "interactionType": { "@type": "WatchAction" },
        "userInteractionCount": 4756
      },
      "name": "Bald eagle nest livestream!",
      "thumbnailUrl": "https://example.com/bald-eagle-at-the-park",
      "uploadDate": "2018-10-27T14:00:00+00:00",
      "publication": [
        {
          "@type": "BroadcastEvent",
          "isLiveBroadcast": true,
          "startDate": "2018-10-27T14:00:00+00:00",
          "endDate": "2018-10-27T14:37:14+00:00"
        },
        {
          "@type": "BroadcastEvent",
          "isLiveBroadcast": true,
          "startDate": "2018-10-27T18:00:00+00:00",
          "endDate": "2018-10-27T18:37:14+00:00"
        }
      ]
    }
    </script>
  </head>
  <body>
  </body>
</html>
Микроданные

<html itemscope itemprop="VideoObject" itemtype="https://schema.org/VideoObject">
<head>
  <title itemprop="name">Bald Eagle at the Park - Livestream</title>
</head>
<body>
  <meta itemprop="uploadDate" content="2018-10-27T14:00:00+00:00" />
  <meta itemprop="duration" content="PT37M14S" />
  <p itemprop="description">Bald eagle at the park livestream.</p>
  <div itemprop="interactionStatistic" itemtype="https://schema.org/InteractionCounter" itemscope>
    <meta itemprop="userInteractionCount" content="4756" />
    <meta itemprop="interactionType" itemtype="https://schema.org/WatchAction" />
  </div>
  <link itemprop="embedUrl" href="https://example.com/bald-eagle-at-the-park" />
  <meta itemprop="expires" content="2018-10-30T14:37:14+00:00" />
  <meta itemprop="contentUrl" content="https://example.com/bald-eagle-at-the-park.mp4" />
  <meta itemprop="regionsAllowed" content="US" />
  <meta itemprop="thumbnailUrl" content="https://example.com/bald-eagle-at-the-park" />
  <div itemprop="publication" itemtype="https://schema.org/BroadcastEvent" itemscope>
    <meta itemprop="isLiveBroadcast" content="true" />
    <meta itemprop="startDate" content="2018-10-27T14:00:00+00:00" />
    <meta itemprop="endDate" content="2018-10-27T14:37:14+00:00" />
  </div>
  <div itemprop="publication" itemtype="https://schema.org/BroadcastEvent" itemscope>
    <meta itemprop="isLiveBroadcast" content="true" />
    <meta itemprop="startDate" content="2018-10-27T18:00:00+00:00" />
    <meta itemprop="endDate" content="2018-10-27T18:37:14+00:00" />
  </div>
</body>
</html>

Ниже приведен пример структурированных данных VideoObject и ItemList. В настоящее время доступ к этой функции имеют лишь некоторые поставщики.

JSON-LD

<html>
  <head>
    <title>Introducing the self-driving bicycle in the Netherlands</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "ItemList",
      "itemListElement": [
        {
          "@type": "VideoObject",
          "position": 1,
          "name": "Introducing the self-driving bicycle in the Netherlands",
          "url": "https://www.example.com/video/self-driving-bicycle",
          "description": "This spring, Google is introducing the self-driving bicycle in Amsterdam, the world's premier cycling city. The Dutch cycle more than any other nation in the world, almost 900 kilometres per year per person, amounting to over 15 billion kilometres annually. The self-driving bicycle enables safe navigation through the city for Amsterdam residents, and furthers Google's ambition to improve urban mobility with technology. Google Netherlands takes enormous pride in the fact that a Dutch team worked on this innovation that will have great impact in their home country.",
          "thumbnailUrl": [
            "https://www.example.com/video/self-driving-bicycle/1x1/photo.jpg",
            "https://www.example.com/video/self-driving-bicycle/4x3/photo.jpg",
            "https://www.example.com/video/self-driving-bicycle/16x9/photo.jpg"
          ],
          "uploadDate": "2016-03-31T08:00:00+08:00",
          "duration": "PT1M54S",
          "contentUrl": "https://www.example.com/video/self-driving-bicycle/file.mp4",
          "embedUrl": "https://www.example.com/embed/self-driving-bicycle",
          "interactionStatistic": {
            "@type": "InteractionCounter",
            "interactionType": { "@type": "WatchAction" },
            "userInteractionCount": 5647018
          }
        },
        {
          "@type": "VideoObject",
          "position": 2,
          "name": "How to tie a tie",
          "url": "https://www.example.com/video/how-to-tie-a-tie",
          "description": "How to tie a four-in-hand knot.",
          "thumbnailUrl": [
            "https://www.example.com/video/how-to-tie-a-tie/1x1/photo.jpg",
            "https://www.example.com/video/how-to-tie-a-tie/4x3/photo.jpg",
            "https://www.example.com/video/how-to-tie-a-tie/16x9/photo.jpg"
          ],
          "uploadDate": "2019-02-28T08:00:00+08:00",
          "duration": "PT5M01S",
          "contentUrl": "https://www.example.com/video/how-to-tie-a-tie/file.mp4",
          "embedUrl": "https://www.example.com/embed/how-to-tie-a-tie",
          "interactionStatistic": {
            "@type": "InteractionCounter",
            "interactionType": { "@type": "WatchAction" },
            "userInteractionCount": 102111
          }
        }
      ]
    }
    </script>
  </head>
  <body>
  </body>
</html>
Микроданные

<div>
      <div itemprop="video" itemscope itemtype="https://schema.org/VideoObject">
        <!-- Thumbnail -->
        <a href="https://example.com/videos/self-driving-bicycle"
           title="Introducing the self-driving bicycle in the Netherlands">
          <img src="https://example.com/videos/self-driving-bicycle/thumbnail.jpg"
               alt="Introducing the self-driving bicycle in the Netherlands"
               title="Introducing the self-driving bicycle in the Netherlands"
               itemprop="thumbnailUrl">
        </a>
        <!-- URL, name, and description -->
        <h1>
          <a itemprop="contentUrl" href="https://example.com/videos/self-driving-bicycle"
             title="Introducing the self-driving bicycle in the Netherlands">
            <span itemprop="name">Introducing the self-driving bicycle in the Netherlands</span>
          </a>
        </h1>
        <a href="https://example.com/videos/self-driving-bicycle"
             title="Introducing the self-driving bicycle in the Netherlands">
          <div itemprop="description">"This spring, Google is introducing the self-driving bicycle
            in Amsterdam, the world's premier cycling city. The Dutch cycle more than any other
            nation in the world, almost 900 kilometres per year per person, amounting to over 15
            billion kilometres annually. The self-driving bicycle enables safe navigation through
            the city for Amsterdam residents, and furthers Google's ambition to improve urban
            mobility with technology. Google Netherlands takes enormous pride in the fact that a
            Dutch team worked on this innovation that will have great impact in their home country.
          "</div>
        </a>
        <!-- Other metadata -->
        <meta itemprop="duration" content="PT1M54S" />
        <meta itemprop="uploadDate" content="2016-03-31T08:00:00+08:00" />
        <span itemprop="interactionStatistic" itemscope itemtype="https://schema.org/InteractionCounter">
        	<span itemprop="interactionType" itemscope itemtype="https://schema.org/WatchAction"></span>
        	<meta itemprop="userInteractionCount" content="5647018" />
        </span>
      </div>

      <div itemprop="video" itemscope itemtype="https://schema.org/VideoObject">
        <!-- Thumbnail -->
        <a href="https://example.com/videos/how-to-tie-a-tie"
           title="How to tie a tie">
          <img src="https://example.com/videos/how-to-tie-a-tie/thumbnail.jpg"
               alt="How to tie a tie"
               title="How to tie a tie"
               itemprop="thumbnailUrl">
        </a>
        <!-- URL, name, and description -->
        <h1>
          <a itemprop="contentUrl" href="https://example.com/videos/how-to-tie-a-tie"
             title="Tie a Tie">
            <span itemprop="name">Tie a Tie</span>
          </a>
        </h1>
        <a href="https://example.com/videos/how-to-tie-a-tie"
             title="Tie a Tie">
          <div itemprop="description">How to tie a four-in-hand knot.</div>
        </a>
        <!-- Other metadata -->
        <meta itemprop="duration" content="PT5M01S" />
        <meta itemprop="uploadDate" content="2019-01-05T08:00:00+08:00" />
        <span itemprop="interactionStatistic" itemscope itemtype="https://schema.org/InteractionCounter">
        	<span itemprop="interactionType" itemscope itemtype="https://schema.org/WatchAction"></span>
        	<meta itemprop="userInteractionCount" content="102111" />
        </span>
      </div>
    </div>

Clip

Пример видео, в котором отмечены ключевые моменты, в результатах поиска

Примеры элементов VideoObject и Clip.

JSON-LD

<html>
  <head>
    <title>Cat jumps over the fence</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "VideoObject",
      "name": "Cat video",
      "duration": "P10M",
      "uploadDate": "2019-07-19",
      "thumbnailUrl": "http://www.example.com/cat.jpg",
      "description": "Watch this cat jump over a fence!",
      "contentUrl": "http://www.example.com/cat_video_full.mp4",
      "regionsAllowed": "US",
      "hasPart": [{
        "@type": "Clip",
        "name": "Cat jumps",
        "startOffset": 30,
        "endOffset": 45,
        "url": "http://www.example.com/example?t=30"
      },
      {
        "@type": "Clip",
        "name": "Cat misses the fence",
        "startOffset": 111,
        "endOffset": 150,
        "url": "http://www.example.com/example?t=111"
      }]
    }
    </script>
  </head>
  <body>
  </body>
</html>
Микроданные

<html itemscope itemprop="VideoObject" itemtype="https://schema.org/VideoObject">
<head>
  <title itemprop="name">Cat jumps over the fence</title>
</head>
<body>
  <meta itemprop="uploadDate" content="2019-07-19" />
  <meta itemprop="duration" content="P10M" />
  <p itemprop="description">Watch this cat jump over a fence!</p>
  <div itemprop="interactionStatistic" itemtype="https://schema.org/InteractionCounter" itemscope>
    <meta itemprop="userInteractionCount" content="5647018" />
    <meta itemprop="interactionType" itemtype="https://schema.org/WatchAction" />
  </div>
  <div itemprop="hasPart" itemtype="https://schema.org/Clip" itemscope>
    <meta itemprop="name" content="Cat jumps" />
    <meta itemprop="startOffset" content="30" />
    <meta itemprop="endOffset" content="45" />
    <meta itemprop="url" content="http://www.example.com/example?t=30" />
  </div>
  <div itemprop="hasPart" itemtype="https://schema.org/Clip" itemscope>
    <meta itemprop="name" content="Cat misses the fence" />
    <meta itemprop="startOffset" content="111" />
    <meta itemprop="endOffset" content="150" />
    <meta itemprop="url" content="http://www.example.com/example?t=111" />
  </div>
  <link itemprop="embedUrl" href="https://www.example.com/embed/123" />
  <meta itemprop="contentUrl" content="http://www.example.com/cat_video_full.mp4" />
  <meta itemprop="regionsAllowed" content="US" />
  <meta itemprop="thumbnailUrl" content="http://www.example.com/cat.jpg" />
</body>
</html>

SeekToAction

Пример одного объекта VideoObject с дополнительными свойствами для разметки SeekToAction.

JSON-LD

<html>
  <head>
    <title>John Smith (@johnsmith123) on VideoApp: My daily workout! #stayingfit</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "potentialAction" : {
        "@type": "SeekToAction",
        "target": "https://video.example.com/watch/videoID?t={seek_to_second_number}",
        "startOffset-input": "required name=seek_to_second_number"
      },
      "name": "My daily workout!",
      "uploadDate": "2020-07-19",
      "thumbnailUrl": "http://www.example.com/daily-workout.jpg",
      "description": "My daily workout!",
      "embedUrl": "https://example.com/daily-workout"
    }
    </script>
  </head>
  <body>
  </body>
</html>
Микроданные

<html itemscope itemprop="VideoObject" itemtype="https://schema.org/VideoObject">
<head>
  <title itemprop="name">John Smith (@johnsmith123) on VideoApp: My daily workout! #stayingfit</title>
</head>
<body>
  <meta itemprop="uploadDate" content="2020-07-19" />
  <p itemprop="description">My daily workout!</p>
  <div itemprop="potentialAction" itemtype="https://schema.org/SeekToAction" itemscope>
    <meta itemprop="target" content="https://video.example.com/watch/videoID?t={seek_to_second_number}" />
    <meta itemprop="startOffset-input" content="required name=seek_to_second_number" />
  </div>
  <link itemprop="embedUrl" href="https://example.com/daily-workout" />
  <meta itemprop="thumbnailUrl" content="http://www.example.com/daily-workout.jpg" />
</body>
</html>

Правила

Чтобы наша система корректно распознавала ваши видео, следуйте приведенным ниже правилам.

Рекомендации по работе с пометкой "Прямой эфир"

Если вы добавляете свойство BroadcastEvent в видео прямой трансляции, соблюдайте приведенные ниже правила.

  • В структурированных данных не должно быть грубых или потенциально оскорбительных выражений.
  • Воспользуйтесь Indexing API, чтобы робот Google просканировал вашу прямую трансляцию своевременно. Вызывать API нужно при следующих событиях:
    • Начало трансляции видео.
    • Прекращение трансляции и обновление разметки страницы для указания времени окончания (endDate).
    • Изменение разметки, о котором необходимо сообщить Google.

Рекомендации по установке временных меток на YouTube

Если видео размещено на YouTube, на основе его описания из этого сервиса ключевые моменты в Google Поиске могут быть включены автоматически. При этом, возможно, вам не потребуется устанавливать временные метки в описании видео на YouTube. Вы также можете явным образом указать важные метки в видео, и эти сведения будут считаться приоритетными. На диаграмме ниже показано, как в результатах поиска могут выглядеть временные метки и ярлыки из описания видео на YouTube.

Видео с временными метками и ярлыками в результатах поиска
1. Временная метка. Время начала фрагмента.
2. Ярлык. Название фрагмента.

При оформлении временных меток и ярлыков в описаниях к видео на YouTube учитывайте следующие рекомендации:

  • Временная метка должна иметь следующий формат: [hour]:[minute]:[second]. Для значений менее 1 часа указывать час не нужно.
  • Каждый ярлык должен находиться на той же строке, что и временная метка, к которой он относится.
  • Каждая временная метка должна быть указана в отдельной строке описания.
  • Каждая временная метка должна быть связана с определенным эпизодом в видео.
  • В ярлыке должно быть хотя бы одно слово.
  • Временные метки необходимо перечислять в хронологическом порядке.

Рекомендации по структурированным данным Clip и SeekToAction

Если вы размечаете видеосегменты с помощью структурированных данных Clip или SeekToAction, соблюдайте приведенные ниже правила.

  • В URL видео должна быть предусмотрена возможность указывать ссылки на его фрагменты, а не только на начало ролика. Пример фрагмента, начинающегося через 30 секунд после начала видео: http://www.example.com/example?t=30.
  • На страницу, где пользователи могут посмотреть видео, необходимо добавить структурированные данные VideoObject. Не направляйте посетителей на страницу, на которой видео недоступно.
  • Общая продолжительность видео должна быть не менее 30 секунд.
  • Для видео нужно указать обязательные свойства, перечисленные в документации по структурированным данным VideoObject.
  • Только для структурированных данных Clip. На одной странице не должно быть двух фрагментов одного видео с одинаковым временем начала.
  • Только для структурированных данных SeekToAction. У Google должен быть доступ к вашему видеоконтенту.

Типы структурированных данных

В этом разделе описаны типы структурированных данных, связанные с функциями, которые поддерживаются для видео в Google Поиске. Чтобы ваш контент мог отображаться в расширенных результатах как видео, необходимо задать все обязательные свойства VideoObject. Также можно добавить рекомендуемые свойства, чтобы пользователям было удобнее просматривать информацию. Помимо VideoObject, вы также можете добавить следующие типы данных, чтобы улучшить результаты, представленные в Google Поиске:

  • BroadcastEvent: разметка для показа прямых трансляций с пометкой "Прямой эфир".
  • ItemList: разметка для страниц, содержащих список роликов, используемых в карусели видео с вашего сайта.
  • Clip: создаваемая вручную разметка для видео, которая позволяет быстро переходить к нужному фрагменту ролика.
  • SeekToAction: указание структуры ваших URL, чтобы система Google автоматически определяла ключевые моменты и направляла зрителей к определенным частям видео.

VideoObject

Полное описание типа VideoObject приведено на странице schema.org/VideoObject. Если не указать все обязательные свойства, у роботов Google могут возникнуть трудности с извлечением информации о видео. Вы также можете добавить рекомендуемые свойства, чтобы сделать результаты поиска еще более информативными.

Обязательные свойства
description

Text

Описание видео. Теги HTML игнорируются.
name

Text

Название видео.
thumbnailUrl

Повторяющийся URL

URL файла со значком видео. Следуйте инструкциям в отношении таких значков.
uploadDate

Date

Дата первой публикации видео, указанная в формате ISO 8601.
Рекомендуемые свойства
contentUrl

URL

URL файла видео, закодированного в одном из поддерживаемых форматов. Не указывайте здесь ссылку на страницу, где размещено видео: здесь должен быть URL самого видеофайла.


"contentUrl": "https://www.example.com/video/123/file.mp4"

Соблюдайте рекомендации по работе с видео.
duration

Duration

Продолжительность видео в формате ISO 8601. Например, значение PT00H30M5S соответствует продолжительности 30 минут 5 секунд.
embedUrl

URL

URL проигрывателя, предназначенного для показа определенного видеоролика. Вы должны привести здесь не ссылку на страницу, где размещено видео, а URL самого видеофайла. Обычно эта информация указывается в атрибуте src тега <embed>.


"embedUrl": "https://www.example.com/embed/123"

Соблюдайте рекомендации по работе с видео.
expires

Date

Дата в формате ISO 8601, после которой доступ к видео будет закрыт. Если видео не имеет срока действия, эту информацию указывать не требуется.
hasPart

Если в видео есть важные сегменты, добавьте обязательные свойства Clip в VideoObject. Пример:


<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "VideoObject",
  "name": "Cat video",
  "hasPart": {
    "@type": "Clip",
    "name": "Cat jumps",
    "startOffset": 30,
    "url": "http://www.example.com/example?t=30"
  }
}
</script>
interactionStatistic

InteractionCounter

Количество просмотров конкретного видео. Пример:


"interactionStatistic":
  {
    "@type": "InteractionCounter",
    "interactionType": { "@type": "WatchAction" },
    "userInteractionCount": 12345
  }
publication

Если видео демонстрируется в режиме прямой трансляции и вы хотите использовать пометку "Прямой эфир", добавьте свойства BroadcastEvent в VideoObject. Пример:


<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "VideoObject",
  "name": "Cat video",
  "publication": {
    "@type": "BroadcastEvent",
    "name": "First scheduled broadcast",
    "isLiveBroadcast": true,
    "startDate": "2018-10-27T14:00:00+00:00",
    "endDate": "2018-10-27T14:37:14+00:00"
  }
}
</script>
regionsAllowed

Place

Регионы, в которых видео разрешено. Если регионы не указаны, будет считаться, что видео разрешено везде. Страны необходимо указывать в формате ISO 3166. Если значений несколько, разделите их пробелами или запятыми.

BroadcastEvent

Чтобы видео можно было показывать с пометкой "Прямой эфир", необходимо добавить в VideoObject указанные ниже свойства. Свойства BroadcastEvent не являются обязательными, но перечисленные ниже свойства необходимо добавить, чтобы видео показывалось с пометкой "Прямой эфир".

Полное описание типа BroadcastEvent приведено на странице schema.org/BroadcastEvent.

Обязательные свойства
publication

BroadcastEvent

Время начала прямой трансляции видео. Можно указать одно значение или список.
publication.endDate

DateTime

Дата и время известного или предполагаемого окончания трансляции в формате ISO 8601.

Свойство endDate необходимо добавить, если прямая трансляция уже завершена. Если точная дата окончания endDate неизвестна заранее, укажите примерное значение endDate.

Если endDate соответствует прошедшей или текущей дате, значит прямая трансляция завершилась. Если дата endDate ещё не наступила, значит прямая трансляция должна завершиться в указанное время.
publication.isLiveBroadcast

Логическое значение

Укажите значение true, если видео передается как прямая трансляция, транслировалось ранее или будет транслироваться позже.
publication.startDate

DateTime

Дата и время известного или предполагаемого начала прямой трансляции в формате ISO 8601. Если startDate соответствует прошедшей или текущей дате, значит прямая трансляция уже началась. Если дата startDate ещё не наступила, значит прямая трансляция должна начаться в указанное время.

ItemList (ограниченный доступ)

Чтобы наша система корректно распознавала страницы вашей галереи видео, добавьте свойства ItemList и VideoObject. Подробнее…

Полное описание типа ItemList приведено на странице schema.org/ItemList.

Обязательные свойства
itemListElement

ListItem

Описание страницы отдельного элемента списка. Каждый элемент ListItem должен включать свойства типов VideoObject и ListItem.
ListItem.position

Integer

Порядковый номер страницы элемента в списке. Пример:


"itemListElement": [
  {
    "@type": "VideoObject",
    "position": 1,
    ... other VideoObject properties ...
  }, {
    "@type": "VideoObject",
    "position": 2,
    ... other VideoObject properties ...
  }
]
ListItem.url

URL

Канонический URL страницы элемента. У каждого элемента должен быть уникальный URL.

Clip

Чтобы вручную указать, какие временные метки и названия использовать для функции "Ключевые моменты", добавьте в объект VideoObject перечисленные ниже свойства. Добавлять свойства Clip необязательно, однако это необходимо, если вы хотите, чтобы в Google показывались заданные вами временные метки и их названия, а не моменты, которые были подобраны для вашего видео автоматически.

Полное описание типа Clip приведено на странице schema.org/Clip.

Обязательные свойства
name

Text

Описательное название, отражающее содержание фрагмента.
startOffset

Number

Время начала фрагмента, указанное в секундах с начала видео.
url

URL

Ссылка на время начала фрагмента.

URL фрагмента должен иметь тот же путь URL, что и видео, и содержать параметр, указывающий начало фрагмента.

Например, из этого URL видно, что фрагмент начинается через две минуты (120 сек.) после начала видео:


"url": "https://www.example.com/example?t=120"
Рекомендуемые свойства
endOffset

Number

Время окончания фрагмента, указанное в секундах с начала видео.

SeekToAction

Чтобы сообщить Google, как интерпретировать ваши URL (для автоматического определения ключевых моментов видео), добавьте в объект VideoObject перечисленные ниже свойства. Добавлять свойства SeekToAction необязательно, однако это нужно делать, если вы хотите, чтобы система Google понимала структуру ваших URL и направляла зрителей к определенным частям видео.

Полное описание типа SeekToAction приведено на странице schema.org/SeekToAction.

Обязательные свойства
potentialAction

SeekToAction

Обозначает возможное действие. Добавьте следующие вложенные свойства:

Пример: 


{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "potentialAction" : {
    "@type": "SeekToAction",
    "target": "https://video.example.com/watch/videoID?t={seek_to_second_number}",
    "startOffset-input": "required name=seek_to_second_number"
  }
)
potentialAction.startOffset-input

Text

Строка-плейсхолдер, которую Google использует в качестве временной метки и заменяет на количество секунд видео, которые необходимо пропустить. Укажите следующее значение:


"startOffset-input": "required name=seek_to_second_number"
potentialAction.target

EntryPoint

URL страницы с объектом VideoObject, содержащий плейсхолдер, который определяет, куда Google будет подставлять количество пропускаемых секунд видео. Так Google распознаёт структуру ваших URL и формат временных меток. Замените часть URL, выступающую в роли временной метки, на следующую строку-плейсхолдер:


{seek_to_second_number}

Предположим, URL с временной меткой имеет следующий вид: 


"target": "https://video.example.com/watch/videoID?t=30"
В этом случае свойство должно иметь следующее значение: 

"target": "https://video.example.com/watch/videoID?t={seek_to_second_number}"

Сбор статистики по расширенным результатам в Search Console

С помощью Search Console вы можете собирать данные об эффективности страниц вашего ресурса в Google Поиске. Вам не обязательно регистрироваться в этом сервисе, чтобы ваши страницы попали в результаты поиска. Однако это позволит узнать, как роботы Google воспринимают сайт, и оптимизировать его. Рекомендуем проверять информацию в Search Console в следующих случаях:

  1. После первого размещения структурированных данных
  2. После выпуска новых шаблонов или обновления кода
  3. При регулярном анализе трафика

После первого размещения структурированных данных

Когда ваши страницы будут проиндексированы, проверьте их на наличие ошибок с помощью отчета о статусе расширенных результатов. Желательно, чтобы количество страниц с правильной разметкой выросло, а число ошибок и предупреждений – нет. Если в структурированных данных будут обнаружены ошибки, примите следующие меры:

  1. Внесите исправления.
  2. Проверьте исправленную страницу, чтобы узнать, обнаруживаются ли ошибки.
  3. Запросите проверку ресурса, используя отчет о статусе расширенных результатов.

После выпуска новых шаблонов или обновления кода

Если вы внесли значительные изменения на сайт, проверьте, не увеличилось ли число ошибок и предупреждений, связанных со структурированными данными.
  • Увеличилось число ошибок? Возможно, вы создали шаблон, с которым что-то не так, или имеющийся шаблон используется некорректно.
  • Уменьшилось число действительных элементов, но не увеличилось количество ошибок? Возможно, на ваших страницах не размещены структурированные данные. Выяснить, с чем связаны ошибки, можно при помощи инструмента проверки URL.

    • При регулярном анализе трафика

    Анализировать трафик сайта из Google Поиска можно с помощью отчета об эффективности. Из этого отчета вы узнаете, как часто страница появляется в Поиске в виде расширенного результата, с какой регулярностью пользователи нажимают на нее и какова ее средняя позиция в результатах поиска. Эти сведения также можно автоматически получать с помощью Search Console API.

    Устранение неполадок

    Если у вас возникли трудности с добавлением или отладкой структурированных данных, вам помогут ресурсы и сведения, доступные по приведенным ниже ссылкам.