Uporządkowane dane wideo (VideoObject, Clip, BroadcastEvent)

Wyszukiwarka Google to miejsce, w którym użytkownicy mogą odkrywać i oglądać filmy. Google stara się automatycznie rozpoznawać szczegóły dotyczące filmów, ale możesz jednoznacznie podać takie informacje jak opis, adres URL miniatury, data umieszczenia w sieci i czas trwania, dodając do filmu znacznik VideoObject. Filmy mogą pojawiać się w wynikach wyszukiwania Google, wynikach wyszukiwania filmów, Grafice Google i Google Discover.

Zrzut ekranu przedstawiający treści wideo w wynikach wyszukiwania Google, na karcie Filmy i w Discover

W zależności od tego, jak oznaczysz swoje treści, możesz korzystać z tych ulepszeń filmów:

Ulepszenia filmów

Plakietka NA ŻYWO: dodaj do filmu plakietkę transmisji na żywo, używając znacznika BroadcastEvent. Plakietkę NA ŻYWO można stosować do dowolnych dostępnych publicznie materiałów wideo, które są przekazywane strumieniowo na żywo przez dowolny czas. Oto kilka przykładów:

  • zawody sportowe,
  • ceremonie wręczania nagród,
  • filmy influencerów,
  • gry wideo prezentowane w ramach strumieniowej transmisji wideo na żywo.

Przestrzegaj wytycznych dotyczących plakietek NA ŻYWO i sprawdź za pomocą interfejsu Indexing API, czy Google indeksuje stronę we właściwym czasie.

 Film z plakietką NA ŻYWO w wynikach wyszukiwania

Sposoby spędzania czasu w domu: ułatw użytkownikom znalezienie rzeczy, które mogą robić w domu. Podczas wyszukiwania zajęć w domu w atrakcyjnych wynikach z elementami rozszerzonymi pojawiają się filmy i wydarzenia online. Już samo dodanie uporządkowanych danych Video może sprawić, że Twoje filmy będą kwalifikowały się do wyświetlania jako wyniki z elementami rozszerzonymi i nie będzie trzeba nic więcej robić.

Więcej informacji o dostępności funkcji oraz wskazówki i przykłady znajdziesz w artykule na temat sposobów spędzania czasu w domu.

 Sposoby spędzania czasu w domu w wynikach wyszukiwania

Kluczowe momenty

The key moments feature is a way for users to navigate video segments like chapters in a book, which can help users engage more deeply with your content. Google Search tries to automatically detect the segments in your video and show key moments to users, without any effort on your part. Alternatively, you can manually tell Google about the important points of your video. We will prioritize key moments set by you, either through structured data or the YouTube description.

  • If your video is hosted on your web page, there are two ways that you can enable key moments:
    • Clip structured data: Specify the exact start and end point to each segment, and what label to display for each segment. This is supported in all languages where Google Search is available.
    • SeekToAction structured data: Tell Google where timestamps typically go in your URL structure, so that Google can automatically identify key moments and link users to those points within the video. This is currently supported for the following languages: English, Spanish, Portuguese, Italian, Chinese, French, Japanese, German, Turkish, Korean, Dutch, and Russian. We aim to extend this to more languages over time. Even in supported languagues, not all videos will have key moments identified, but we aim to improve this over time as well.
  • If your video is hosted on YouTube, you can specify the exact timestamps and labels in the video description on YouTube. Check out the best practices for marking timestamps in YouTube descriptions. This is supported in all languages where Google Search is available.

    If you want to enable Video Chapters on YouTube, follow these additional guidelines.

To opt out of the key moments feature completely (including any efforts Google may make to show key moments automatically for your video), use the nosnippet meta tag.

Film z kluczowymi momentami w wynikach wyszukiwania
Karuzela hosta z filmami (ograniczony dostęp): dodanie uporządkowanych danych ItemList umożliwi użytkownikom przeglądanie stron galerii filmów. Ta funkcja jest obecnie dostępna dla niewielkiej grupy dostawców. Wyszukiwarka Google może automatycznie wyświetlać karuzelę hosta dla Twojej witryny – nie musisz dodawać uporządkowanych danych ItemList.

Film edukacyjny: dodaj uporządkowane dane dotyczące filmów edukacyjnych, aby pomóc uczniom i nauczycielom w ich znajdowaniu. Więcej informacji o dostępności funkcji, wytyczne i przykłady znajdziesz w dokumentacji filmów edukacyjnych.

 Film edukacyjny w wynikach wyszukiwania

Dodawanie uporządkowanych danych

Uporządkowane dane to standardowy format udostępniania informacji o stronie i klasyfikowania jej zawartości. Jeśli dopiero zaczynasz, dowiedz się, jak działają uporządkowane dane.

Poniżej omawiamy sposób tworzenia, testowania i udostępniania uporządkowanych danych. Szczegółowe instrukcje dodawania uporządkowanych danych do strony internetowej znajdziesz w ćwiczeniach z programowania poświęconych uporządkowanym danym.

  1. Dodaj wymagane właściwości. Dowiedz się, w którym miejscu na stronie umieścić uporządkowane dane w zależności od używanego formatu.
  2. Przestrzegaj wskazówek.
  3. Zweryfikuj kod za pomocą testu wyników z elementami rozszerzonymi i napraw błędy krytyczne. Rozważ też usunięcie niekrytycznych problemów, które mogą zostać zgłoszone w narzędziu – to może poprawić jakość uporządkowanych danych (ale nie jest to konieczne, aby witryna kwalifikowała się do wyników z elementami rozszerzonymi).
  4. Możesz wdrożyć kilka stron z uporządkowanymi danymi i dzięki narzędziu do sprawdzania adresów URL zobaczyć, jak Google je odczytuje. Upewnij się, że Twoja strona jest dostępna dla Google i nie jest blokowana przez plik robots.txt lub tag noindex ani nie wymaga logowania. Jeśli strona wygląda dobrze, możesz poprosić Google o ponowne zindeksowanie adresów URL.
  5. Aby na bieżąco informować Google o przyszłych zmianach, prześlij mapę witryny. Możesz zautomatyzować ten proces za pomocą interfejsu Search Console Sitemap API.

Przykłady

Standardowy wynik wideo z elementami rozszerzonymi

Przykład standardowych wyników wyszukiwania filmów

Oto przykład pojedynczego znacznika 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>
Mikrodane

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

Plakietka NA ŻYWO

Przykład filmu z plakietką NA ŻYWO w wynikach wyszukiwania

Oto przykład znaczników VideoObject i 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>
Mikrodane

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

Oto przykład uporządkowanych danych VideoObject i ItemList. Ta funkcja jest obecnie dostępna dla niewielkiej grupy dostawców.

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

<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

Przykład filmu z kluczowymi momentami w wynikach wyszukiwania

Oto przykład znaczników VideoObject i 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": "PT10M",
      "uploadDate": "2019-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",
      "regionsAllowed": "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>
Mikrodane

<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="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="regionsAllowed" content="US" />
  <meta itemprop="thumbnailUrl" content="https://www.example.com/cat.jpg" />
</body>
</html>

SeekToAction

Oto przykład pojedynczego obiektu VideoObject zawierającego dodatkowe właściwości wymagane w przypadku znaczników 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-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>
Mikrodane

<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="https://www.example.com/daily-workout.jpg" />
</body>
</html>

Wytyczne

Aby pomóc Google w lepszym poznaniu Twoich treści wideo, postępuj zgodnie z tymi wytycznymi:

Wytyczne dotyczące plakietek NA ŻYWO

Jeśli do strumieniowych transmisji wideo na żywo dodajesz znacznik BroadcastEvent, musisz przestrzegać tych wytycznych:

  • W uporządkowanych danych nie używaj wulgaryzmów ani języka potencjalnie obraźliwego.
  • Aby mieć pewność, że Google zindeksuje Twoją strumieniową transmisję wideo na żywo we właściwym czasie, użyj interfejsu Indexing API. Wywołuj ten interfejs API w przypadku takich zdarzeń:
    • Rozpoczyna się transmisja na żywo materiału wideo.
    • Odtwarzanie strumieniowe materiału wideo zakończyło się, a w znacznikach endDate na stronie zaktualizowano datę i godzinę końca transmisji.
    • Za każdym razem, gdy wprowadzono zmianę w znacznikach i należy powiadomić o tym Google.

Sprawdzone metody oznaczania sygnatur czasowych w YouTube

Jeśli Twój film jest hostowany w YouTube, wyszukiwarka Google może automatycznie włączyć kluczowe momenty na podstawie opisu filmu w YouTube. Nie musisz w tym opisie oznaczać określonych sygnatur czasowych. Możesz też bezpośrednio przekazać nam informacje o ważnych fragmentach filmu, co jest dla nas wygodniejszym rozwiązaniem. Poniższy diagram pokazuje, jak sygnatury czasowe i etykiety w opisie filmu w YouTube mogą wyglądać w wynikach wyszukiwania:

Film w wynikach wyszukiwania z sygnaturami czasowymi i etykietami
1. Etykieta: nazwa klipu.
2. Sygnatura czasowa: czas rozpoczęcia klipu.

Podczas formatowania sygnatur czasowych i etykiet w opisach YouTube przestrzegaj tych wytycznych:

  • Podaj sygnaturę czasową w tym formacie: [hour]:[minute]:[second]. Jeśli nie ma godziny, nie musisz jej uwzględniać.
  • Określ etykietę sygnatury czasowej w tym samym wierszu co samą sygnaturę.
  • Podaj każdą sygnaturę czasową w nowym wierszu opisu filmu.
  • Połącz sygnaturę czasową z określonym fragmentem filmu.
  • Upewnij się, że etykieta zawiera co najmniej jedno słowo.
  • Wyświetl sygnatury czasowe w porządku chronologicznym.

Jeśli chcesz włączyć funkcję rozdziałów filmu w YouTube, postępuj zgodnie z tymi dodatkowymi wytycznymi.

Wytyczne dotyczące obiektów Clip i SeekToAction

Jeśli dodajesz uporządkowane dane Clip lub SeekToAction, aby oznaczyć segmenty filmu, przestrzegaj tych zasad:

  • Film musi zawierać precyzyjne linki prowadzące do innych punktów niż punkt początkowy w adresie URL filmu. Na przykład https://www.example.com/example?t=30 rozpoczyna się po 30 sekundach filmu.
  • Uporządkowane dane VideoObject należy dodać do strony, na której użytkownicy mogą obejrzeć film. Wskazanie strony, na której nie da się go wyświetlić, może powodować frustrację użytkowników.
  • Łączny czas trwania filmu musi wynosić co najmniej 30 sekund.
  • Film musi zawierać wymagane właściwości wymienione w dokumentacji dotyczącej uporządkowanych danych VideoObject.
  • Tylko w przypadku uporządkowanych danych Clip: upewnij się, że żadne 2 klipy w 1 filmie zdefiniowane na określonej stronie nie mają tego samego czasu rozpoczęcia.
  • Tylko w przypadku uporządkowanych danych SeekToAction: Google musi mieć możliwość pobrania plików wideo.

Definicje typów uporządkowanych danych

W tej sekcji opisano typy uporządkowanych danych związane z funkcjami wideo w wyszukiwarce Google. Aby treści mogły wyświetlać się w wynikach wideo z elementami rozszerzonymi, musisz określić dla nich wymagane właściwości VideoObject. Możesz też dodać do nich właściwości zalecane, by wzbogacić informacje o treściach dla wygody użytkowników. Oprócz właściwości VideoObject możesz też dodać poniższe typy danych, by włączyć ulepszenia filmów w wyszukiwarce Google:

  • BroadcastEvent: dodaj te znaczniki do strumieniowych transmisji wideo na żywo, by w filmie włączyć plakietkę NA ŻYWO.
  • ItemList: dodaj do stron znaczniki listy filmów, aby włączyć karuzelę hosta z filmami.
  • Clip: oznacz ręcznie ważne segmenty filmu, aby umożliwić użytkownikom szybkie przejście do jego określonych fragmentów.
  • SeekToAction: włącz kluczowe momenty, wskazując sposób działania struktury adresów URL. Dzięki temu będziemy mogli automatycznie rozpoznawać kluczowe momenty i udostępniać użytkownikom linki do nich.
  • Film edukacyjny: dodaj uporządkowane dane dotyczące filmów edukacyjnych, aby pomóc uczniom i nauczycielom w ich znajdowaniu.

VideoObject

Pełną definicję znaczników VideoObject znajdziesz na schema.org/VideoObject. Jeśli nie podasz wymaganych właściwości, Google może nie być w stanie wyodrębnić żadnych informacji o filmie. Możesz też dodać do nich właściwości zalecane, by wzbogacić informacje o treściach dla wygody użytkowników.

Właściwości wymagane
name

Text

Tytuł filmu.
thumbnailUrl

Powtórzony URL.

URL wskazujący plik miniatury filmu. Postępuj zgodnie ze wskazówkami dotyczącymi miniatur.
uploadDate

Date

Data pierwszej publikacji filmu podana w formacie ISO 8601.
Właściwości zalecane
contentUrl

URL

URL wskazujący multimedialny plik wideo w jednym z obsługiwanych formatów kodowania. Nie umieszczaj linku do strony, na której jest film. Musi to być adres URL wskazujący plik wideo.


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

Przestrzegaj naszych sprawdzonych metod dotyczących filmów.
description

Text

Opis filmu. Tagi HTML są ignorowane.
duration

Duration

Czas trwania filmu podany w formacie ISO 8601. Na przykład PT00H30M5S wskazuje czas trwania „trzydzieści minut i pięć sekund”.
embedUrl

URL

Adres URL prowadzący do odtwarzacza konkretnego filmu. Nie umieszczaj linku do strony, na której jest film. Musi to być adres URL odtwarzacza. Zazwyczaj ta informacja znajduje się w atrybucie src tagu <embed>.


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

Przestrzegaj naszych sprawdzonych metod dotyczących filmów.
expires

Date

Data, po której film nie będzie już dostępny, podana w formacie ISO 8601. Nie podawaj tej informacji, jeśli Twój film będzie dostępny przez cały czas.
hasPart

Jeśli Twój film zawiera ważne segmenty, musisz w obiekcie VideoObject umieścić wymagane właściwości Clip, np.:


<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

InteractionCounter

Liczba obejrzeń filmu, np.:


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

Jeśli film jest transmitowany na żywo i chcesz uzyskać plakietkę NA ŻYWO, musisz w obiekcie VideoObject umieścić właściwości BroadcastEvent, np.:


<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

Regiony, w których film jest dozwolony. Jeśli ich nie określisz, założymy, że film jest dozwolony wszędzie. Określ kraje w formacie ISO 3166. Aby dodać wiele krajów, użyj spacji lub przecinka jako separatora.

BroadcastEvent

Aby film wyświetlał się z plakietką NA ŻYWO, umieść w obiekcie VideoObject te właściwości. Chociaż właściwości BroadcastEvent nie są wymagane, musisz dodać poniższe właściwości, jeśli chcesz, by Twój film wyświetlał się z plakietką NA ŻYWO.

Pełną definicję znaczników BroadcastEvent znajdziesz na schema.org/BroadcastEvent.

Właściwości wymagane
publication

BroadcastEvent

Podaje, kiedy odbędzie się transmisja strumieniowa filmu na żywo. Może to być lista lub wartość pojedyncza.
publication.endDate

DateTime

Data i godzina zaplanowanego lub przewidywanego zakończenia transmisji na żywo, podane w formacie ISO 8601.

Użycie właściwości endDate jest wymagane, gdy materiał wideo już się skończył i przestał być wyświetlany na żywo. Jeśli przewidywana wartość właściwości endDate jest nieznana przed rozpoczęciem transmisji na żywo, zalecamy podanie w polu endDate wartości szacunkowej.

Jeśli wartość podana w polu endDate należy do przeszłości lub jest zgodna z bieżącą datą i godziną, oznacza to, że transmisja strumieniowa tak naprawdę dobiegła już końca i materiał wideo nie jest dostępny na żywo. Jeśli wartość podana w polu endDate należy do przyszłości, oznacza to, że zakończenie transmisji strumieniowej jest zaplanowane na tę datę i godzinę.
publication.isLiveBroadcast

Wartość logiczna

Jeśli materiał wideo jest, był lub będzie transmitowany strumieniowo na żywo, podaj wartość true.
publication.startDate

DateTime

Data i godzina zaplanowanego lub przewidywanego rozpoczęcia transmisji na żywo, podane w formacie ISO 8601. Jeśli wartość podana w polu startDate należy do przeszłości lub jest zgodna z bieżącą datą i godziną, oznacza to, że transmisja strumieniowa tak naprawdę już się zaczęła. Jeśli wartość podana w polu startDate należy do przyszłości, oznacza to, że rozpoczęcie transmisji strumieniowej jest zaplanowane na tę datę i godzinę.

ItemList (ograniczony dostęp)

Aby pomóc Google w lepszym poznaniu treści Twoich stron galerii filmów, oprócz właściwości VideoObject musisz dodać poniższe właściwości ItemList. Więcej informacji o karuzelach znajdziesz w artykule Karuzela.

Pełną definicję znaczników ItemList znajdziesz na schema.org/ItemList.

Właściwości wymagane
itemListElement

ListItem

Adnotacja o pojedynczej stronie elementu. Każdy element ListItem musi zawierać właściwości VideoObject i właściwości ListItem.
ListItem.position

Integer

Pozycja porządkowa strony elementu na liście, np.:


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

URL

Kanoniczny URL strony elementu. Każdy element musi mieć niepowtarzalny URL.

Clip

Aby ręcznie wskazać Google, jakiej sygnatury czasowej i etykiety użyć w funkcji kluczowych momentów, w obiekcie VideoObject umieść poniższe właściwości. Chociaż właściwości Clip nie są wymagane, musisz dodać właściwości wymienione poniżej, jeśli chcesz, aby w Google pojawiały się sygnatury czasowe i etykiety określone przez Ciebie, a nie segmenty filmu, które Google może pokazywać automatycznie.

Pełną definicję znaczników Clip znajdziesz na schema.org/Clip.

Właściwości wymagane
name

Text

Opisowy tytuł zawartości klipu.
startOffset

Number

Czas rozpoczęcia klipu wyrażony w postaci liczby sekund od początku filmu.
url

URL

Adres URL wskazujący czas rozpoczęcia klipu.

Adres URL klipu musi wskazywać tę samą ścieżkę adresu URL co film, z dodatkowymi parametrami zapytania określającymi czas.

Na przykład ten URL oznacza, że klip rozpoczyna się po upływie 2 minut od początku filmu:


"url": "https://www.example.com/example?t=120"
Właściwości zalecane
endOffset

Number

Czas zakończenia klipu wyrażony w postaci liczby sekund od rozpoczęcia filmu.

SeekToAction

Aby wskazać Google, jak działa struktura adresów URL (dzięki czemu będziemy mogli automatycznie rozpoznawać kluczowe momenty filmu i je wyświetlać), umieść w obiekcie VideoObject poniższe właściwości. Chociaż właściwości SeekToAction nie są wymagane, musisz dodać właściwości wymienione poniżej, jeśli chcesz wskazać Google, jak działa Twoja struktura adresów URL, abyśmy mogli udostępniać użytkownikom linki do określonych momentów filmu.

Pełną definicję znaczników SeekToAction znajdziesz na schema.org/SeekToAction.

Właściwości wymagane
potentialAction

SeekToAction

Wskazuje potencjalne działanie. Uwzględnij te właściwości zagnieżdżone:

Na przykład: 


{
  "@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

Ciąg zastępczy, który Google zidentyfikuje jako strukturę sygnatury czasowej, a następnie zastąpi liczbą sekund, które mają zostać pominięte. Użyj tej wartości:


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

startOffset-input to właściwość z adnotacjami. Więcej informacji znajdziesz na stronie Potential Actions.

potentialAction.target

EntryPoint

URL strony zawierającej obiekt VideoObject, łącznie z obiektem zastępczym w strukturze adresu URL, który wskazuje miejsce wstawienia odpowiedniej liczby sekund do pominięcia w filmie. W ten sposób Google rozpoznaje strukturę adresu URL i formatuje sygnatury czasowe. Zastąp fragment adresu URL z sygnaturą czasową tym ciągiem zastępczym:


{seek_to_second_number}

Na przykład: 


"target": "https://video.example.com/watch/videoID?t=30"
Sygnatura czasowa po zmianie: 

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

Monitorowanie wyników z elementami rozszerzonymi w Search Console

Search Console to narzędzie, które pomaga monitorować skuteczność stron w wyszukiwarce Google. Aby Twoja witryna mogła pojawiać się w wynikach wyszukiwania Google, nie musisz rejestrować jej w Search Console. Jeśli jednak to zrobisz, lepiej zrozumiesz, jak robot Google widzi Twoją witrynę i jak możesz mu ułatwić jej skanowanie. Zalecamy sprawdzenie danych w Search Console w tych przypadkach:

  1. po pierwszym wdrożeniu uporządkowanych danych,
  2. po opublikowaniu nowych szablonów lub zaktualizowaniu kodu,
  3. podczas okresowego analizowania ruchu.

Po pierwszym wdrożeniu uporządkowanych danych

Gdy Google zindeksuje Twoje strony, poszukaj problemów w odpowiednim raporcie o stanie wyników z elementami rozszerzonymi. W idealnej sytuacji powinno się pojawić więcej elementów prawidłowych, a liczba elementów nieprawidłowych nie powinna się zwiększyć. Jeśli zauważysz problemy w uporządkowanych danych:

  1. Napraw nieprawidłowe elementy
  2. Sprawdź opublikowany adres URL, by zobaczyć, czy problem nadal występuje.
  3. Poproś o weryfikację, korzystając z raportu o stanie.

Po opublikowaniu nowych szablonów lub zaktualizowaniu kodu

Po wprowadzeniu istotnych zmian w witrynie monitoruj wzrost liczby nieprawidłowych elementów w uporządkowanych danych.
  • Możesz zauważyć większą liczbę elementów nieprawidłowych, jeśli wprowadzisz nowy szablon, który nie działa, lub jeśli Twoja witryna wykorzystuje istniejący szablon w nowy i nieprawidłowy sposób.
  • Jeśli okaże się, że jest mniej prawidłowych elementów (ale liczba nieprawidłowych elementów się nie zwiększyła), być może na swoich stronach nie umieszczasz już uporządkowanych danych. Użyj narzędzia do sprawdzania adresów URL, by dowiedzieć się, co jest przyczyną problemu.

Okresowe analizowanie ruchu

Analizuj ruch w wyszukiwarce Google za pomocą raportu skuteczności. Zawarte w nim dane pokazują, jak często Twoja strona wyświetla się w wyszukiwarce jako wynik z elementami rozszerzonymi, jak często użytkownicy ją klikają i jaka jest jej średnia pozycja w wynikach wyszukiwania. Możesz też pobrać te wyniki automatycznie za pomocą interfejsu Search Console API.

Rozwiązywanie problemów

Jeśli masz problem z zastosowaniem lub debugowaniem uporządkowanych danych, skorzystaj z tych rozwiązań: