Données structurées des vidéos (VideoObject, Clip, BroadcastEvent)

La recherche Google est une plate-forme permettant aux internautes de découvrir et regarder des vidéos. Google essaie de comprendre automatiquement les détails de votre vidéo, mais vous pouvez fournir des informations explicites, telles que la description, l'URL de vignette, la date d'importation et la durée, via le balisage VideoObject. Les vidéos peuvent apparaître dans les résultats de recherche Google, les résultats de recherche de vidéos, Google Images et Google Discover.

Capture d'écran illustrant un contenu vidéo dans les résultats de recherche Google, l'onglet vidéo et Discover

Selon le balisage de votre contenu, vos vidéos peuvent également bénéficier des améliorations suivantes :

Améliorations vidéo

Badge EN DIRECT : ajoutez un badge EN DIRECT à votre vidéo grâce au balisage BroadcastEvent. Le badge EN DIRECT peut être appliqué à n'importe quelle vidéo publique diffusée en direct pendant une durée indéterminée. Voici quelques exemples :

  • Événements sportifs
  • Remise de prix
  • Vidéos d'influenceur
  • Jeux vidéo diffusés en direct

Veillez à respecter les consignes relatives aux badges EN DIRECT et à utiliser l'API d'indexation pour vous assurer que Google explore votre page au moment opportun.

Vidéo avec un badge EN DIRECT dans les résultats de recherche

Activités à faire chez soi : aidez les internautes à trouver des activités à faire à la maison. Lorsque les internautes recherchent des activités à faire chez eux, vos vidéos et événements en ligne s'affichent dans des résultats enrichis. Si vous utilisez des données structurées Video, vos vidéos sont peut-être déjà éligibles à ce type de résultat enrichi. Dans ce cas, vous n'avez rien de plus à faire.

Pour en savoir plus sur la disponibilité des fonctionnalités, prendre connaissance des consignes et voir des exemples, consultez la section Activités à faire chez soi.

 Activités à faire chez soi dans les résultats de recherche

Temps forts

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.

Vidéo avec des temps forts dans les résultats de recherche
Carrousel hôte de vidéos (accès limité) : aidez les utilisateurs à explorer les pages de votre galerie de vidéos en ajoutant des données structurées ItemList. > Cette fonctionnalité est actuellement limitée à un petit nombre de fournisseurs. La recherche Google peut afficher automatiquement un carrousel hôte pour votre site sans avoir à ajouter des données structurées ItemList.

Vidéo éducative : aidez les étudiants et les enseignants à trouver vos vidéos éducatives en leur associant des données structurées. Pour en savoir plus sur la disponibilité des fonctionnalités, prendre connaissance des consignes et voir des exemples, consultez la documentation sur les vidéos éducatives.

 Vidéo éducative dans les résultats de recherche

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. For a step-by-step guide on how to add structured data to a web page, check out the structured data codelab.

  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.

Exemples

Résultat enrichi standard pour une vidéo

Exemple de résultats de recherche de vidéo standards

Voici un exemple de VideoObject unique.

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>
Microdonnées

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

Badge EN DIRECT

Exemple de vidéo dans les résultats de recherche avec un badge EN DIRECT

Voici un exemple de VideoObject et 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>
Microdonnées

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

Voici un exemple de données structurées VideoObject et ItemList. Cette fonctionnalité est actuellement limitée à un petit nombre de fournisseurs.

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>
Microdonnées

<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

Exemple de vidéo avec des temps forts dans les résultats de recherche

Voici un exemple de VideoObject et 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-19",
      "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>
Microdonnées

<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

Voici un exemple de VideoObject unique qui inclut les propriétés supplémentaires nécessaires au balisage 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": "https://www.example.com/daily-workout.jpg",
      "description": "My daily workout!",
      "embedUrl": "https://example.com/daily-workout"
    }
    </script>
  </head>
  <body>
  </body>
</html>
Microdonnées

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

Consignes

Pour aider Google à interpréter votre vidéo, assurez-vous de respecter les consignes suivantes :

Consignes concernant les badges EN DIRECT

Si vous ajoutez BroadcastEvent à des vidéos en direct, suivez les instructions ci-dessous :

  • N'utilisez pas de langage vulgaire ni potentiellement offensant dans les données structurées.
  • Pour vous assurer que Google explore la vidéo diffusée en direct au moment opportun, utilisez l'API d'indexation. Appelez l'API pour les événements suivants :
    • Lorsque la vidéo commence à être diffusée en direct
    • Lorsque la diffusion de la vidéo est terminée et que le balisage de la page a été mis à jour pour indiquer la date de fin (endDate)
    • Chaque fois qu'un changement intervient dans le balisage et que Google doit en être informé

Bonnes pratiques de marquage des codes temporels sur YouTube

Si votre vidéo est hébergée sur YouTube, la recherche Google peut activer automatiquement des temps forts en fonction de la description de la vidéo sur YouTube et vous éviter ainsi de devoir marquer des codes temporels spécifiques dans votre description. Toutefois, si vous nous indiquez de façon explicite les points importants de votre vidéo, nous privilégierons ces informations. Le schéma suivant montre comment les codes temporels et les libellés d'une description de vidéo YouTube peuvent apparaître dans les résultats de recherche :

Vidéo dans les résultats de recherche, avec codes temporels et libellés
1. Libellé : nom de l'extrait vidéo
2. Code temporel : début d'un extrait

Gardez à l'esprit les consignes suivantes lors de la mise en forme des codes temporels et des libellés pour les descriptions YouTube :

  • Mettez en forme le code temporel de la manière suivante : [hour]:[minute]:[second]. S'il n'y a pas d'heure, vous n'avez pas besoin de l'inclure.
  • Indiquez le libellé du code temporel sur la même ligne que le code temporel lui-même.
  • Placez chaque code temporel sur une nouvelle ligne dans la description de la vidéo.
  • Associez le code temporel au point spécifié dans la vidéo.
  • Assurez-vous que le libellé contient au moins un mot.
  • Listez les codes temporels dans l'ordre chronologique.

Si vous souhaitez activer les chapitres vidéo sur YouTube, suivez ces consignes supplémentaires.

Consignes relatives à Clip et SeekToAction

Si vous ajoutez des données structurées Clip ou SeekToAction pour marquer des segments vidéo, procédez comme suit :

  • La vidéo doit pouvoir être associée à un lien profond autre que le point de départ de l'URL de la vidéo. Par exemple, https://www.example.com/example?t=30 démarre au bout de 30 secondes dans une vidéo.
  • Les données structurées VideoObject doivent être ajoutées à une page sur laquelle les internautes peuvent regarder la vidéo. Cela améliore la qualité de l'expérience utilisateur.
  • La durée totale de la vidéo doit être d'au moins 30 secondes.
  • La vidéo doit inclure les propriétés obligatoires listées dans la documentation sur les données structurées VideoObject.
  • Pour les données structurées Clip uniquement : assurez-vous qu'aucun extrait de la même vidéo sur la même page ne partage la même heure de début.
  • Pour les données structurées SeekToAction uniquement : Google doit être en mesure de récupérer vos fichiers de contenu vidéo.

Définitions des types de données structurées

Cette section décrit les types de données structurées associés aux fonctionnalités vidéo dans la recherche Google. Vous devez inclure les propriétés VideoObject obligatoires pour que votre contenu puisse être affiché sous forme de résultat vidéo enrichi. Vous pouvez également inclure les propriétés recommandées pour ajouter d'autres informations à votre contenu et ainsi offrir une meilleure expérience utilisateur. Outre VideoObject, vous pouvez ajouter les types de données suivants afin d'activer les améliorations vidéo dans la recherche Google :

  • BroadcastEvent : balisez les vidéos diffusées en direct pour pouvoir y afficher un badge EN DIRECT.
  • ItemList : balisez les pages contenant une liste de vidéos pour activer un carrousel hôte de vidéos.
  • Clip : marquez manuellement les segments importants de votre vidéo pour aider les utilisateurs à accéder rapidement à des points précis de cette vidéo.
  • SeekToAction : activez les temps forts en expliquant à Google le fonctionnement de votre structure d'URL afin de lui permettre d'identifier automatiquement les temps forts et de renvoyer les utilisateurs vers ces points précis dans la vidéo.
  • Vidéo éducative : aidez les étudiants et les enseignants à trouver vos vidéos éducatives en leur associant des données structurées.

VideoObject

La définition complète de l'élément VideoObject est disponible sur schema.org/VideoObject. Si vous n'incluez pas les propriétés requises, Google risque de ne pas pouvoir extraire les informations relatives à la vidéo. Vous pouvez également inclure les propriétés recommandées pour ajouter d'autres informations à votre contenu et ainsi offrir une meilleure expérience utilisateur.

Propriétés obligatoires
name

Text

Titre de la vidéo.
thumbnailUrl

Élément URL répété

URL renvoyant au fichier image de la vignette associée à la vidéo. Suivez les consignes relatives aux vignettes.
uploadDate

Date

Date à laquelle la vidéo a été publiée pour la première fois, au format ISO 8601.
Propriétés recommandées
contentUrl

URL

URL pointant vers le fichier multimédia vidéo réel, dans l'un des formats d'encodage compatibles. Ne créez pas de lien vers la page contenant la vidéo. Il doit s'agir de l'URL du fichier vidéo lui-même.

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

Assurez-vous de suivre nos bonnes pratiques en matière de vidéo.
description

Text

Description de la vidéo. Les balises HTML sont ignorées.
duration

Duration

Durée de la vidéo au format ISO 8601. Par exemple, PT00H30M5S représente une durée de "trente minutes et cinq secondes".
embedUrl

URL

URL qui renvoie vers le lecteur de la vidéo concernée. Ne créez pas de lien vers la page contenant la vidéo. Il doit s'agir de l'URL du lecteur vidéo lui-même. En général, cette information est indiquée dans l'attribut src d'une balise <embed>.

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

Assurez-vous de suivre nos bonnes pratiques en matière de vidéo.
expires

Date

Le cas échéant, date après laquelle la vidéo ne sera plus disponible, au format ISO 8601. N'indiquez pas cette information si la vidéo n'a pas de date d'expiration.
hasPart

Si votre vidéo comporte des segments importants, imbriquez les propriétés Clip obligatoires dans l'élément VideoObject. Exemple :

<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

Nombre de fois où la vidéo a été visionnée. Exemple :

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

Si votre vidéo est diffusée en direct et que vous souhaitez pouvoir y afficher un badge EN DIRECT, imbriquez les propriétés BroadcastEvent dans l'élément VideoObject. Exemple :

<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

Régions dans lesquelles la vidéo est autorisée. Si cette information n'est pas spécifiée, Google considère que la vidéo est autorisée partout. Spécifiez les pays au format ISO 3166. Pour séparer plusieurs valeurs, utilisez un espace ou une virgule comme délimiteur.

BroadcastEvent

Pour qu'un badge EN DIRECT puisse s'afficher, imbriquez les propriétés suivantes dans l'élément VideoObject. Bien que les propriétés BroadcastEvent ne soient pas obligatoires, vous devez ajouter les propriétés suivantes si vous souhaitez que votre vidéo puisse s'afficher avec un badge EN DIRECT.

La définition complète de l'élément BroadcastEvent est disponible sur schema.org/BroadcastEvent.

Propriétés obligatoires
publication

BroadcastEvent

Décrit quand la vidéo doit être diffusée en direct. Il peut s'agir d'une liste ou d'une seule instance.
publication.endDate

DateTime

Heure et date de fin effective ou prévue de la diffusion en direct, au format ISO 8601.

Il est nécessaire de renseigner la propriété endDate lorsque la vidéo est terminée et n'est plus en direct. Si la date de fin prévue (endDate) est inconnue avant le début de la diffusion en direct, nous recommandons de fournir une date approximative pour endDate.

Si la propriété endDate correspond aux date et heure du jour ou à une date antérieure, cela indique que la diffusion est terminée et n'est plus en direct. Si endDate correspond à une date future, la fin de la diffusion est prévue à cette heure.
publication.isLiveBroadcast

Booléen

Indiquez true si la vidéo est, a été ou sera diffusée en direct.

publication.startDate

DateTime

Heure et date du début effective ou prévue de la diffusion en direct, au format ISO 8601. Si la propriété startDate correspond aux date et heure du jour ou à une date antérieure, cela indique que la diffusion a déjà commencé. Si startDate correspond à une date future, le début de la diffusion est prévu à cette heure.

ItemList (accès limité)

Pour aider Google à interpréter les pages de votre galerie vidéo, ajoutez les propriétés ItemList suivantes en plus des propriétés VideoObject. Pour plus d'informations sur les carrousels, consultez la section Carrousel.

La définition complète de l'élément ItemList est disponible sur schema.org/ItemList.

Propriétés obligatoires
itemListElement

ListItem

Annotation désignant une page d'élément. Chaque élément ListItem doit inclure les propriétés VideoObject, ainsi que les propriétés ListItem.
ListItem.position

Integer

Position ordinale de la page d'élément dans la liste. Exemple :

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

URL

URL canonique de la page d'élément. Chaque élément doit avoir une URL unique.

Clip

Pour indiquer manuellement à Google le code temporel et le libellé à utiliser pour les temps forts, imbriquez les propriétés suivantes dans l'élément VideoObject. Bien que les propriétés Clip ne soient pas obligatoires, vous devez ajouter les propriétés suivantes si vous souhaitez que Google affiche les codes temporels et les libellés que vous spécifiez pour votre vidéo. Dans le cas contraire, Google affichera automatiquement les segments de son choix pour votre vidéo.

La définition complète de la propriété Clip est disponible sur schema.org/Clip.

Propriétés obligatoires
name

Text

Titre descriptif du contenu de l'extrait vidéo.
startOffset

Number

Heure de début de l'extrait vidéo, exprimée en nombre de secondes à partir du début de la vidéo.
url

URL

URL pointant vers l'heure de début de l'extrait vidéo.

L'URL de l'extrait vidéo doit pointer vers le même chemin d'URL que la vidéo, avec des paramètres de requête supplémentaires indiquant l'heure.

Par exemple, l'URL suivante signifie que la vidéo commence à 2 minutes et 0 seconde :

"url": "https://www.example.com/example?t=120"
Propriétés recommandées
endOffset

Number

Heure de fin du clip, exprimée en nombre de secondes à partir du début de la vidéo.

SeekToAction

Pour indiquer à Google le fonctionnement de votre structure d'URL (afin de lui permettre d'afficher les temps forts qui ont été identifiés automatiquement pour votre vidéo), imbriquez les propriétés suivantes dans l'élément VideoObject. Les propriétés SeekToAction ne sont pas obligatoires. Toutefois, vous devez ajouter les propriétés ci-dessous si vous souhaitez que Google comprenne le fonctionnement de votre structure d'URL afin que les internautes puissent accéder à un point précis de la vidéo.

La définition complète de l'élément SeekToAction est disponible sur schema.org/SeekToAction.

Propriétés obligatoires
potentialAction

SeekToAction

Indique une action potentielle. Ajoutez les propriétés imbriquées suivantes :

Exemple : 

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

Chaîne d'espace réservé que Google identifiera comme structure de code temporel et qui sera remplacée par le nombre de secondes approprié. Utilisez la valeur suivante :

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

startOffset-input est une propriété annotée. Pour en savoir plus, consultez la page Potential Actions.

potentialAction.target

EntryPoint

URL de la page qui contient cette propriété VideoObject, y compris un espace réservé dans la structure d'URL qui indique où Google peut insérer le nombre de secondes à partir desquelles l'internaute peut accéder à un moment fort. Cela permet à Google de comprendre votre structure d'URL, ainsi que la façon dont vous mettez en forme vos codes temporels. Remplacez la partie du code temporel de l'URL par la chaîne d'espace réservé suivante :

{seek_to_second_number}

Par exemple, remplacez la partie du code temporel de l'URL : 

"target": "https://video.example.com/watch/videoID?t=30"
Pour que le code temporel corresponde désormais à ceci : 
"target": "https://video.example.com/watch/videoID?t={seek_to_second_number}"

Suivre les résultats enrichis avec la Search Console

La Search Console est un outil qui vous permet de suivre les performances de vos pages dans la recherche Google. Il n'est pas nécessaire de vous inscrire à la Search Console pour figurer dans les résultats de recherche Google. Cependant, en vous inscrivant, vous comprendrez mieux la façon dont Google interprète votre site et serez plus à même de l'améliorer. Nous vous recommandons de consulter la Search Console dans les cas suivants :

  1. Après avoir déployé des données structurées pour la première fois
  2. Après avoir publié de nouveaux modèles ou après avoir mis à jour votre code
  3. Lors des analyses régulières du trafic

Après avoir déployé des données structurées pour la première fois

Une fois que Google a indexé vos pages, recherchez les problèmes à l'aide du rapport sur l'état des résultats enrichis. Idéalement, il y aura une augmentation du nombre d'articles valides et pas d'augmentation du nombre d'articles non valides. Si vous détectez des problèmes au niveau des données structurées :

  1. Corrigez les éléments non valides.
  2. Inspectez une URL active pour vérifier si le problème persiste.
  3. Demandez la validation à l'aide du rapport d'état.

Après avoir publié de nouveaux modèles ou après avoir mis à jour votre code

Lorsque vous apportez des modifications importantes à votre site Web, surveillez l'augmentation des éléments non valides dans les données structurées.
  • Si vous constatez une augmentation du nombre d'éléments non valides, vous avez peut-être déployé un nouveau modèle qui ne fonctionne pas, ou votre site interagit différemment et de façon incorrecte avec le modèle déjà disponible.
  • Si vous constatez une diminution du nombre d'éléments valides (sans augmentation du nombre d'éléments non valides), vous n'intégrez peut-être plus de données structurées dans vos pages. Utilisez l'outil d'inspection d'URL pour identifier la cause du problème.

Lors des analyses régulières du trafic

Analysez votre trafic de recherche Google à l'aide du rapport sur les performances. Les données indiquent la fréquence à laquelle votre page s'affiche en tant que résultat enrichi dans la recherche Google, ainsi que la fréquence à laquelle les internautes cliquent dessus et la position moyenne à laquelle vous apparaissez dans les résultats de recherche. Vous pouvez également extraire automatiquement ces résultats avec l'API Search Console.

Dépannage

Si vous ne parvenez pas à mettre en œuvre ou à déboguer des données structurées, voici quelques ressources susceptibles de vous aider.