Aller au contenu

Révision éditoriale :

Comprendre et vérifier un VideoObject sur WordPress ​

VideoObject décrit une vidéo dans les données structurées. Il relie l’enregistrement, sa miniature, ses informations de publication et la page qui le présente. Il ne remplace pas une transcription visible. Un JSON syntaxiquement valide ne prouve pas non plus que Google indexera la vidéo ou affichera un résultat enrichi.

Distinguer trois adresses ​

L’URL de page mène à l’article ou à la page de visionnement. L’URL de lecteur charge un lecteur intégrable. L’URL de média retourne le fichier vidéo lui-même. Copier la même adresse de page dans toutes les propriétés peut produire un JSON valide qui décrit mal les ressources.

PropriétéSens à vérifierErreur fréquente
nameTitre fidèle à cette vidéoTitre générique du site
thumbnailUrlMiniature stable et accessible de cette vidéoImage absente ou sans rapport
uploadDatePremière publication de la vidéo, au format de date et d’heure appropriéDate de révision de l’article
descriptionRésumé précis de l’enregistrementParagraphe commercial recopié
durationDurée réelle au format ISO 8601Durée prévue lors de la production
contentUrlFichier média directement accessible, lorsqu’il est connuPage contenant un lecteur
embedUrlAdresse d’un lecteur intégrable, si elle s’appliqueFichier vidéo ou page sans rapport

Google exige name, thumbnailUrl et uploadDate dans ses consignes d’admissibilité VideoObject. Les autres propriétés du tableau sont recommandées. Le vocabulaire Schema.org est plus large que les propriétés utilisées par Google : une définition de vocabulaire et une condition d’un résultat de recherche sont deux références distinctes.

Examiner une sortie réelle ​

L’export JSON-LD de notre démonstration WordPress est fourni en texte pour permettre son étude sans ajouter ses entités vidéo aux métadonnées de ce guide. Son origine locale a été remplacée par l’adresse réservée https://example.invalid. Ces URL volontairement non fonctionnelles ne sont pas des métadonnées de production à recopier.

Sortie observée, avec une limite : un VideoObject et trois objets Clip sont présents pour chaque version publiée. Dans ce cas HTML5, le plugin donne à embedUrl la même adresse MP4 qu’à contentUrl; cela ne distingue pas une adresse de lecteur d’un fichier média et mérite une révision séparée. L’export est conservé, sans être présenté comme modèle idéal ni résultat validé par Google. La durée anglaise déclarée est PT30S, arrondie vers le haut à partir de 29.645867 secondes décodées; la durée française est PT41S pour 40.571233 secondes. Ces arrondis n’établissent pas l’admissibilité aux moments clés. Voir l’environnement et les mesures.

Examiner ces propriétés exactes de l’objet exporté (extrait)
json
{
  "@type": "VideoObject",
  "name": "Regardez. Lisez. Retrouvez.",
  "uploadDate": "2026-11-16T16:59:22+00:00",
  "duration": "PT41S",
  "contentUrl": "https://example.invalid/wp-content/uploads/2026/11/demo-fr.mp4",
  "embedUrl": "https://example.invalid/wp-content/uploads/2026/11/demo-fr.mp4"
}

Sur votre propre page, ouvrez le code source et cherchez application/ld+json, puis VideoObject. Examinez chaque objet correspondant. Le thème, une extension SEO et une extension vidéo peuvent chacun contribuer au balisage. Compter les objets ne suffit pas : déterminez s’ils décrivent plusieurs vidéos ou s’ils se contredisent au sujet de la même.

Valider le sens, puis l’accès ​

Utilisez un outil de validation de données structurées pour repérer les erreurs de syntaxe et les champs manquants. Comparez ensuite le titre, l’image, la durée et la date avec la page visible et l’enregistrement. Ouvrez les adresses de miniature, de média et de lecteur en étant déconnecté. Un test réussi sur du code collé ne prouve pas qu’un robot peut récupérer ces ressources sur le site réel.

Si des chapitres sont décrits, essayez leurs liens pendant la lecture. Clip représente un passage nommé avec un vrai début et une URL qui permet de l’atteindre. N’inventez pas de chapitres pour satisfaire un contrôle. Google impose d’autres conditions aux moments clés; une liste de repères ne promet pas cet affichage.

Contrôler la transcription séparément ​

Schema.org définit une propriété texte transcript pour les objets audio et vidéo. Une chaîne JSON-LD n’est pas une expérience de lecture visible, et cette propriété ne fait pas partie des champs VideoObject exigés par Google. Cherchez une phrase distinctive de la narration dans le HTML ordinaire, comme dans la comparaison avant/après.

Si le balisage est cohérent, mais que la vidéo reste non indexée, poursuivez avec la distinction entre indexation de page et de vidéo. Si les adresses de page et de média sont absentes des signaux de découverte, examinez le sitemap vidéo. Pour les réglages VidSEO, consultez la documentation.

Références ​

Voir toutes les ressources.