Структурированные данные для видео (VideoObject, Clip, BroadcastEvent)

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

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

Функции для обработки видео
Пометка "Прямой эфир". Чтобы рядом с видео появлялась пометка "Прямой эфир", достаточно добавить для него свойство BroadcastEvent. Эту пометку можно добавить к любой общедоступной трансляции, независимо от ее продолжительности. Вот некоторые примеры видео, к которым можно добавить такую пометку: спортивные мероприятия; церемонии вручения наград; видео инфлюенсеров; прямые трансляции видеоигр. Чтобы роботы Google своевременно сканировали вашу страницу, соблюдайте специальные требования и пользуйтесь Indexing API.
Ключевые моменты С помощью функции ключевых моментов зритель может быстро переходить к определенным местам в видео, как будто открывая главу книги. Так видео становится понятнее, и пользователям удобнее его смотреть. Google Поиск может самостоятельно обнаруживать основные эпизоды в вашем видео и предлагать их пользователям. Вам для этого не нужно ничего предпринимать. Однако вы можете указать Google на важные моменты в видео, и они получат более высокий приоритет. Это можно сделать с помощью структурированных данных или описания на YouTube. Если видео встроено в вашу веб-страницу или опубликовано на вашей платформе, разметить ключевые моменты можно с помощью двух типов структурированных данных: Структурированные данные Clip. Позволяют указать время начала и окончания каждого момента и дать ему название. Эта возможность доступна для всех языков, совместимых с Google Поиском. Структурированные данные SeekToAction. Позволяют сообщить Google о том, где обычно располагаются временные метки в структуре ваших URL, чтобы роботы Google автоматически определяли ключевые моменты и выбирали определенные эпизоды в видео, на которые нужно обратить внимание пользователей. Эта возможность доступна для английского, испанского, итальянского, китайского, корейского, немецкого, нидерландского, португальского, русского, турецкого, французского и японского языков. Если ролик размещен на YouTube, вы можете указать временные метки и названия эпизодов в его описании. Ознакомьтесь с рекомендациями по установке временных меток в описаниях видео на YouTube. Эта возможность доступна для всех языков, совместимых с Google Поиском. Чтобы включить разделение видео YouTube на эпизоды, следуйте этим дополнительным рекомендациям. Чтобы не выделять ключевые моменты и запретить Google их автоматический показ, используйте тег nosnippet (meta).

How to add structured data

Structured data is a standardized format for providing information about a page and classifying the page content. If you're new to structured data, you can learn more about how structured data works.

Here's an overview of how to build, test, and release structured data.

1. Add the required properties. Based on the format you're using, learn where to insert structured data on the page.
2. Follow the guidelines.
3. Validate your code using the Rich Results Test and fix any critical errors. Consider also fixing any non-critical issues that may be flagged in the tool, as they can help improve the quality of your structured data (however, this isn't necessary to be eligible for rich results).
4. Deploy a few pages that include your structured data and use the URL Inspection tool to test how Google sees the page. Be sure that your page is accessible to Google and not blocked by a robots.txt file, the noindex tag, or login requirements. If the page looks okay, you can ask Google to recrawl your URLs.
5. To keep Google informed of future changes, we recommend that you submit a sitemap. You can automate this with the Search Console Sitemap API.

Примеры

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

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

<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": "2024-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="2024-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" />
  <meta itemprop="regionsAllowed" content="NL" />
  <meta itemprop="thumbnailUrl" content="https://example.com/photos/1x1/photo.jpg" />
</body>
</html>

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

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

<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": "2024-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": "2024-10-27T14:00:00+00:00",
      "publication": [
        {
          "@type": "BroadcastEvent",
          "isLiveBroadcast": true,
          "startDate": "2024-10-27T14:00:00+00:00",
          "endDate": "2024-10-27T14:37:14+00:00"
        },
        {
          "@type": "BroadcastEvent",
          "isLiveBroadcast": true,
          "startDate": "2024-10-27T18:00:00+00:00",
          "endDate": "2024-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="2024-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="2024-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="2024-10-27T14:00:00+00:00" />
    <meta itemprop="endDate" content="2024-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="2024-10-27T18:00:00+00:00" />
    <meta itemprop="endDate" content="2024-10-27T18:37:14+00:00" />
  </div>
</body>
</html>

Clip

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

<html>
  <head>
    <title>Cat jumps over the fence</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "VideoObject",
      "name": "Cat video",
      "duration": "PT10M",
      "uploadDate": "2024-07-19T08:00:00+08:00",
      "thumbnailUrl": "https://www.example.com/cat.jpg",
      "description": "Watch this cat jump over a fence!",
      "contentUrl": "https://www.example.com/cat_video_full.mp4",
      "ineligibleRegion": "US",
      "hasPart": [{
        "@type": "Clip",
        "name": "Cat jumps",
        "startOffset": 30,
        "endOffset": 45,
        "url": "https://www.example.com/example?t=30"
      },
      {
        "@type": "Clip",
        "name": "Cat misses the fence",
        "startOffset": 111,
        "endOffset": 150,
        "url": "https://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="2024-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="https://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="https://www.example.com/example?t=111" />
  </div>
  <link itemprop="embedUrl" href="https://www.example.com/embed/123" />
  <meta itemprop="contentUrl" content="https://www.example.com/cat_video_full.mp4" />
  <meta itemprop="ineligibleRegion" content="US" />
  <meta itemprop="thumbnailUrl" content="https://www.example.com/cat.jpg" />
</body>
</html>

SeekToAction

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

<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": "2024-07-19T08:00:00+08:00",
      "thumbnailUrl": "https://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="2024-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="https://www.example.com/daily-workout.jpg" />
</body>
</html>

Правила

Структурированные данные для видео должны соответствовать требованиям, изложенным в руководствах Главное о Поиске, Общие рекомендации по использованию структурированных данных и Какие видео можно проиндексировать.

Кроме того, рекомендуем ознакомиться с указанными ниже рекомендациями, если они применимы к вашему видеоконтенту:

• Правила в отношении прямых трансляций
• Правила в отношении структурированных данных Clip и SeekToAction
• Рекомендации по установке временных меток на YouTube

Правила в отношении пометки "Прямой эфир"

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

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

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

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

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

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

Чтобы включить разделение видео YouTube на эпизоды, следуйте этим дополнительным рекомендациям.

Правила в отношении структурированных данных Clip и SeekToAction

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

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

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

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

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

VideoObject

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

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

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

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

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

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

BroadcastEvent

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

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

Clip

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

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

"url": "https://www.example.com/example?t=120"

SeekToAction

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

Полное описание типа SeekToAction приведено на странице schema.org/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"
  }
}

"startOffset-input": "required name=seek_to_second_number"

{seek_to_second_number}

"target": "https://video.example.com/watch/videoID?t=30"

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

Monitor rich results with Search Console

Search Console is a tool that helps you monitor how your pages perform in Google Search. You don't have to sign up for Search Console to be included in Google Search results, but it can help you understand and improve how Google sees your site. We recommend checking Search Console in the following cases:

1. After deploying structured data for the first time
2. After releasing new templates or updating your code
3. Analyzing traffic periodically

After deploying structured data for the first time

After Google has indexed your pages, look for issues using the relevant Rich result status report. Ideally, there will be an increase of valid items, and no increase in invalid items. If you find issues in your structured data:

1. Fix the invalid items.
2. Inspect a live URL to check if the issue persists.
3. Request validation using the status report.

After releasing new templates or updating your code

• If you see an increase in invalid items, perhaps you rolled out a new template that doesn't work, or your site interacts with the existing template in a new and bad way.
• If you see a decrease in valid items (not matched by an increase in invalid items), perhaps you are no longer embedding structured data in your pages. Use the URL Inspection tool to learn what is causing the issue.

Analyzing traffic periodically

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

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

• Если вы используете систему управления контентом (CMS) или поручили настройку сайта другому человеку, обратитесь за помощью к нему или разработчику CMS. Не забудьте переслать ему сообщения о проблеме, полученные вами в Search Console.
• Google не гарантирует показ вашего контента в результатах поиска, которые формируются на основе структурированных данных. Возможные причины, по которым ваши материалы могут не показываться в виде расширенных результатов, перечислены в общих рекомендациях по использованию структурированных данных.
• Ознакомьтесь со списком типичных ошибок в структурированных данных и отчетом о структурированных данных, которые невозможно обработать, и проверьте, правильно ли вы добавили разметку.
• Если мы вручную приняли меры в отношении страницы, недопустимые структурированные данные на ней будут игнорироваться до тех пор, пока вы не исправите код. При этом сама страница может появляться в результатах поиска и дальше. Чтобы устранить проблемы со структурированными данными, воспользуйтесь отчетом о мерах, принятых вручную.
• Ещё раз изучите рекомендации, чтобы выяснить, соответствует ли им ваш контент. Проблема может быть связана со спамом в контенте или разметке, а не с ошибками в синтаксисе. Тогда ее не получится выявить с помощью инструмента проверки расширенных результатов.
• Узнайте, чем может быть вызвано отсутствие расширенных результатов или уменьшение их общего количества.
• Робот Googlebot сканирует и индексирует страницы не сразу после обновления контента. С момента публикации страницы может пройти несколько дней, пока Google обнаружит и просканирует ее. Мы собрали на отдельной странице ответы на часто задаваемые вопросы о сканировании и индексировании.
• В случае необходимости задавайте вопросы на форуме Центра Google Поиска