Vidéo

Exemple de résultat vidéo enrichi et de vidéos dans la recherche d'images

Balisez votre contenu vidéo avec des données structurées pour permettre aux internautes de découvrir et de regarder des vidéos à partir de la recherche Google. Vous pouvez indiquer des informations telles que la description, l'URL de la vignette, la date de transfert et la durée en balisant votre vidéo avec VideoObject. Vous pouvez également ajouter des données structurées à l'élément VideoObject pour permettre les améliorations vidéo suivantes :

  • Carrousel vidéo : balisez les pages d'une galerie vidéo (page contenant une liste de vidéos) à l'aide de données structurées ItemList.
  • Segments vidéo : marquez les segments importants d'une vidéo à l'aide de données structurées Clip, afin de permettre aux internautes d'accéder rapidement à des points précis de cette vidéo.

Si vous structurez votre contenu conformément à ce guide, un badge vidéo peut apparaître dans les résultats de recherche d'images pour mobile.

Exemples

Résultat enrichi standard pour une vidéo

Voici un exemple de balisage vidéo standard utilisant JSON-LD. Il utilise uniquement VideoObject et n'est pas éligible à l'affichage d'un carrousel vidéo ni de segments vidéo.

Voici un exemple de page comportant une liste de vidéos. Pour activer le carrousel vidéo, cette page comporte des données structurées VideoObject et ItemList supplémentaires.

JSON-LD
Microdonnées

Segments vidéo (accès limité)

Voici un exemple JSON-LD de propriété VideoObject avec des données structurées Clip supplémentaires utilisées pour marquer les segments vidéo. Les segments vidéo sont actuellement limités à un groupe restreint de fournisseurs. Si vous souhaitez participer, remplissez ce formulaire afin de témoigner votre intérêt.

Page AMP avec une vidéo

Voici un exemple de propriété VideoObject sur une page AMP.

Consignes

Pour que votre vidéo puisse figurer sous forme de résultat vidéo enrichi, vous devez respecter les consignes suivantes :

Consignes relatives aux segments vidéo (accès limité)

Si vous ajoutez Clip pour marquer des segments vidéo, procédez comme suit :

  • La vidéo doit être accessible au public. En d'autres termes, tout le monde doit pouvoir la visionner sans nécessiter d'abonnement.
  • 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, http://www.example.com/example?t=30 démarre au bout de 30 secondes dans une vidéo.
  • Les données structurées relatives aux segments vidéo 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.
  • Assurez-vous que deux clips de la même vidéo définie sur la même page ne partagent pas d'heure de début.
  • La vidéo doit comporter des données structurées VideoObject.

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 :

  • ItemList : balisez les pages contenant une liste de vidéos pour activer un carrousel vidéo.
  • Clip : marquez les segments importants de votre vidéo pour aider les utilisateurs à accéder rapidement à des points précis de cette vidéo.

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
description

Text

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

name

Text

Titre de la vidéo.

thumbnailUrl

Élément ImageObject ou URL répété

URL renvoyant au fichier image de la vignette associée à la vidéo.

  • Les URL des images doivent être explorables et indexables.
  • Les images doivent représenter le contenu balisé.
  • Les images doivent être au format .jpg, .png ou .gif.
  • La taille minimale des images doit être de 60 pixels de long sur 30 pixels de large.
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 renvoyant au fichier vidéo multimédia.

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

duration

Duration

Durée de la vidéo au format ISO 8601. Par exemple, T00H30M5S 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. En général, cette information est indiquée dans l'élément src d'une balise <embed>.

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.

interactionStatistic

InteractionCounter

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


"interactionStatistic":
  {
    "@type": "InteractionCounter",
    "interactionType": { "@type": "http://schema.org/WatchAction" },
    "userInteractionCount": 12345
  }

ItemList

Pour activer l'affichage de votre vidéo dans un carrousel vidéo, ajoutez les propriétés ItemList suivantes en plus des propriétés VideoObject. Bien que les propriétés ItemList ne soient pas obligatoires, vous devez ajouter les propriétés ci-dessous si vous souhaitez que votre vidéo puisse s'afficher dans un carrousel vidéo. 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 relative à un seul élément. Chaque élément ListItem doit inclure des propriétés VideoObject ainsi que des propriétés ListItem.

ListItem.position

Integer

Position ordinale de la page relative à un é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 relative à un élément. Chaque élément doit avoir une URL unique.

Clip (accès limité)

Pour activer les segments d'une vidéo, 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 ci-dessous si vous souhaitez que votre vidéo puisse s'afficher avec des segments.

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 du clip.

startOffset

Number

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

url

URL

URL pointant vers l'heure de début du clip.

L'URL du clip 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.