Données structurées des vidéos éducatives (LearningResource
, VideoObject
, Clip
)
![Exemple de résultat enrichi pour une vidéo éducative](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/learning_videos_example.png?authuser=6&hl=fr)
La recherche Google est une plate-forme permettant aux étudiants et enseignants de découvrir et regarder des vidéos éducatives. Lorsque vous spécifiez explicitement des informations éducatives avec des données structurées, telles que le niveau d'enseignement, le concept et les compétences abordés dans la vidéo, Google est en mesure de mieux interpréter le contenu de la vidéo et d'améliorer l'expérience de recherche de contenu pour les étudiants.
Les données structurées d'une vidéo éducative peuvent également permettre d'afficher des chips d'information sur la vidéo, comme le niveau d'enseignement et le type de vidéo (par exemple, une présentation ou une vidéo de solution).
![Affichage des chips d'information sous une vidéo éducative avant que l'utilisateur n'appuie dessus](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/learning_videos_pretap.png?authuser=6&hl=fr)
![Affichage des chips d'information au-dessus d'une vidéo éducative après que l'utilisateur a appuyé dessus](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/learning_videos_posttap.png?authuser=6&hl=fr)
Disponibilité de cette fonctionnalité
L'affichage des vidéos éducatives sous forme de résultats enrichis est disponible en anglais dans toutes les régions dans lesquelles la recherche Google est disponible. Cette fonctionnalité n'est disponible que lorsque vous recherchez des contenus pédagogiques sur ordinateur et sur mobile.
Exemples
Vidéo éducative unique
Voici un exemple de vidéo éducative unique.
<html> <head> <title>Learning video markup example</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": ["VideoObject", "LearningResource"], "name": "An introduction to Genetics", "description": "Explanation of the basics of Genetics for beginners.", "learningResourceType": "Concept Overview", "educationalLevel": "High school (US)", "contentUrl": "https://www.example.com/video/123/file.mp4", "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" } </script> </head> <body> </body> </html>
Vidéo éducative avec plusieurs extraits
Voici un exemple de vidéo comportant trois extraits : les deux premiers expliquent en détail le problème, et le troisième présente le concept.
<html> <head> <title>Learning video and clips markup example</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": ["VideoObject", "LearningResource"], "name": "An introduction to XYZ", "description": "Solving equations using exponent properties", "educationalLevel": "High school (US)", "educationalAlignment": { "@type": "AlignmentObject", "educationalFramework": "Common Core", "targetName": "HSA-SSE.B.3", "targetUrl": "https://www.corestandards.org/Math/Content/HSA/SSE/#CCSS.Math.Content.HSA.SSE.B.3" }, "contentUrl": "https://www.example.com/video/123/file.mp4", "thumbnailUrl": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ], "hasPart": [{ "@type": ["Clip", "LearningResource"], "learningResourceType": "Concept Overview", "name": "Understanding exponents", "startOffset": 40, "endOffset": 120, "url": "https://www.example.com/example?t=501" },{ "@type": ["Clip", "LearningResource"], "learningResourceType": "Problem Walkthrough", "name": "Example problem 1: suspended wires", "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire.", "startOffset": 150, "endOffset": 225, "url": "https://www.example.com/example?t=30" },{ "@type": ["Clip", "LearningResource"], "learningResourceType": "Problem Walkthrough", "name": "Example problem 2: exponents", "text": "Consider a weight suspended from five wires as shown in Figure. Find the tension in one wire.", "startOffset": 275, "endOffset": 500, "url": "https://www.example.com/example?t=201" }], "uploadDate": "2024-03-31T08:00:00+08:00" } </script> </head> <body> </body> </html>
Tutoriel vidéo de présentation d'un problème
Cet exemple illustre toutes les propriétés à ajouter au balisage des vidéos éducatives pour qu'elles soient considérées comme des tutoriels vidéo valides de présentation d'un problème.
<html> <head> <title>Problem Walkthrough Learning Video example</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": ["VideoObject", "LearningResource"], "name": "Mechanics problem for Grade 10", "description": "Video walks through solution for problems in mechanics.", "learningResourceType": "Problem Walkthrough", "text": "Three balls have a mass of 2kg, 4kg and 6kg each. Find the relative velocity after collision.", "contentUrl": "https://www.example.com/video/123/file.mp4", "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" } </script> </head> <body> </body> </html>
Extraits vidéo de tutoriels de présentation de plusieurs problèmes
Voici un exemple de page Web avec plusieurs extraits vidéo de tutoriels de présentation de plusieurs problèmes. Cet exemple illustre toutes les propriétés à ajouter au balisage des vidéos éducatives au niveau de la vidéo et des extraits pour que le balisage corresponde à des extraits de tutoriels de présentation de problèmes.
<html> <head> <title>Problem Walkthrough in clips in Learning Videos markup</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": ["VideoObject", "LearningResource"], "name": "An introduction to XYZ", "description": "Solving equations using exponent properties", "learningResourceType": "Problem Walkthrough", "contentUrl": "https://www.example.com/video/123/file.mp4", "text": "Three balls have a mass of 2kg, 4kg and 6kg each. Find the relative velocity after collision.", "thumbnailUrl": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ], "hasPart": [{ "@type": ["Clip", "LearningResource"], "learningResourceType": "Problem Walkthrough", "name": "Example problem 1: suspended wires", "text": "Consider a weight suspended from two wires. Find the tension in each wire.", "startOffset": 150, "endOffset": 225, "url": "https://www.example.com/example?t=150" },{ "@type": ["Clip", "LearningResource"], "learningResourceType": "Problem Walkthrough", "name": "Example problem 2: exponents", "text": "Consider a weight suspended from five wires. Find the tension in one wire.", "startOffset": 275, "endOffset": 500, "url": "https://www.example.com/example?t=275" }], "uploadDate": "2024-03-31T08:00:00+08:00" } </script> </head> <body> </body> </html>
Comment ajouter des données structurées
Ces données structurées représentent un format normalisé permettant de fournir des informations sur une page et de classer son contenu. En savoir plus sur le fonctionnement des données structurées
Voici, dans les grandes lignes, comment créer, tester et publier des données structurées. Pour consulter un guide détaillé sur l'ajout de données structurées à une page Web, accédez à cet atelier de programmation.
- Ajoutez les propriétés obligatoires. En fonction du format que vous utilisez, découvrez où insérer des données structurées sur la page.
- Suivez les consignes.
- Validez votre code à l'aide de l'outil de test des résultats enrichis et corrigez les erreurs critiques, le cas échéant. Envisagez également de résoudre les problèmes non critiques que l'outil a pu signaler, car cela peut contribuer à améliorer la qualité de vos données structurées. Toutefois, ce n'est pas nécessaire pour pouvoir bénéficier des résultats enrichis.
- Déployez quelques pages où figurent vos données structurées et utilisez l'outil d'inspection d'URL pour découvrir comment Google voit la page. Assurez-vous que Google peut accéder à votre page et qu'elle n'est pas bloquée par un fichier robots.txt, la balise
noindex
ni par des identifiants de connexion. Si tout semble être en ordre, vous pouvez demander à Google d'explorer de nouveau vos URL. - Pour informer Google des modifications futures de vos pages, nous vous recommandons de nous envoyer un sitemap. Vous pouvez automatiser cette opération à l'aide de l'API Sitemap de la Search Console.
Consignes
Pour que les vidéos éducatives proposées par votre page puissent apparaître sous forme de résultats enrichis, vous devez respecter les consignes suivantes :
- Consignes générales pour les données structurées
- Essentiels de la recherche
- Bonnes pratiques concernant les vidéos
- Consignes concernant les sitemaps pour vidéos
- Consignes techniques
Consignes techniques
- Outre le balisage des vidéos éducatives, vous devez ajouter les propriétés
VideoObject
obligatoires et recommandées. - 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 durée totale de la vidéo doit être d'au moins 30 secondes.
- Le balisage relatif aux vidéos éducatives doit être ajouté à une page sur laquelle les internautes peuvent regarder la vidéo. Cela améliore la qualité de l'expérience utilisateur.
Définitions des types de données structurées
La définition complète de VideoObject
et LearningResource
est disponible sur schema.org VideoObject
et LearningResource
.
Vous devez inclure les propriétés obligatoires pour que vos vidéos éducatives puissent être affichées sous forme de résultats enrichis. 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.
Vidéo éducative [VideoObject
, LearningResource
]
Le balisage d'une vidéo éducative vise à améliorer la visibilité des contenus éducatifs présents dans la vidéo. Le balisage contient des informations sur les différents concepts et compétences enseignés dans la vidéo.
Utilisez le type [VideoObject, LearningResource]
pour les vidéos éducatives.
Outre les propriétés VideoObject
obligatoires et recommandées, ajoutez les propriétés suivantes aux vidéos éducatives.
Propriétés obligatoires | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
educationalAlignment
|
Code, cours ou examen standard officiel associé au contenu. N'utilisez cette propriété que si votre contenu est conforme à une norme ou un examen spécifique. Si ce n'est pas le cas, utilisez uniquement la propriété
Bien que vous puissiez fournir plusieurs valeurs Exemples : "educationalAlignment": { "@type": "AlignmentObject", "educationalFramework": "Common Core", "targetName": "CCSS.MATH.CONTENT.7.SP.B.4", "targetUrl": "https://www.corestandards.org/Math/Content/7/SP/B/4/" } "educationalAlignment": { "@type": "AlignmentObject", "educationalFramework": "NCERT", "targetUrl": "https://ncert.nic.in/" } |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
educationalLevel |
Niveau d'enseignement cible de la vidéo. Définissez le niveau d'enseignement cible sur une valeur spécifique à un pays ou une valeur générique. Valeurs spécifiques à un pays :
Chaque pays a son propre système académique. Définissez
Exemple : "educationalLevel": "10th Grade (AR)" Valeurs génériques :
Vous ne pouvez spécifier qu'une seule de ces valeurs génériques en tant que
"educationalLevel": "Beginner" |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
learningResourceType |
Type de contenu de la vidéo en fonction de son objectif. Cette propriété peut être utilisée au niveau de la vidéo (si elle ne comporte qu'un seul type de contenu) ou au niveau de l'extrait (si la vidéo en possède plusieurs). La liste ci-dessous présente des exemples de valeurs possibles. Si votre vidéo ne correspond à aucune de ces valeurs, vous pouvez en créer une, car nous envisageons d'ajouter de nouvelles valeurs. Notez que si vous ne définissez pas la propriété sur l'une des valeurs ci-dessous, les informations relatives au type d'apprentissage ne pourront être utilisées dans aucune fonctionnalité de recherche.
"learningResourceType": "Problem walkthrough" |
Propriétés recommandées | |
---|---|
educationalAlignment.educationalFramework
|
Nom de la norme officielle associée au contenu. "educationalFramework": "Common Core" |
educationalAlignment.targetName |
Code ou nœud standard (par exemple, CCSS.MATH.CONTENT.7.SP.B.4, physique AP A, CCSS.MATH). "targetName": "CCSS.MATH.CONTENT.7.SP.B.4" |
educationalAlignment.targetUrl |
URL de la description standard. "targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/" |
hasPart |
Liste des extraits vidéo présents dans la vidéo. Chaque extrait doit être axé sur un sujet ou un problème spécifique.
La liste des propriétés obligatoires et recommandées pour l'objet éducatif Voici un exemple d'extrait d'un tutoriel de présentation d'un problème : { "@type": ["Clip","LearningResource"], "learningResourceType": "Problem Walkthrough", "name": "Example 1", "text": "Consider a weight suspended from five wires as shown in Figure. Find the tension in one wire.", "startOffset": 201, "url": "https://www.example.com/example?t=201" } Voici un exemple d'extrait qui donne un aperçu d'un concept : { "@type": ["Clip","LearningResource"], "learningResourceType": "Concept Overview", "name": "ABC Law", "startOffset": 501, "url": "https://www.example.com/example?t=501" } |
text |
Texte de la question résolue dans la vidéo. Cette propriété doit inclure la question complète, et pas seulement le titre.
Si votre vidéo résout plusieurs problèmes, vous pouvez utiliser la même propriété, mais au niveau "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
Extrait vidéo éducatif [Clip, LearningResource]
Vous pouvez spécifier des extraits éducatifs dans la propriété hasPart
des vidéos éducatives. Voici la liste des propriétés recommandées pour les extraits.
Ajoutez les tags de type [Clip, LearningResource]
aux tags d'apprentissage. Outre les propriétés Clip
obligatoires et recommandées, ajoutez les propriétés suivantes aux vidéos éducatives.
Propriétés recommandées | |
---|---|
learningResourceType |
Type de contenu de l'extrait en fonction de son objectif. Si l'extrait vidéo propose une solution détaillée à un problème, sa valeur peut être définie sur La liste ci-dessous présente des exemples de valeurs possibles. Si votre extrait ne correspond à aucune de ces valeurs, vous pouvez en créer une, car nous envisageons d'ajouter de nouvelles valeurs. Notez que si vous ne définissez pas la propriété sur l'une des valeurs ci-dessous, les informations ne pourront être utilisées dans aucune fonctionnalité de recherche. Valeurs possibles :
"learningResourceType": "Problem walkthrough" |
Tutoriel vidéo de présentation d'un problème [VideoObject
, LearningResource
]
La fonctionnalité de tutoriels vidéo est un sous-type de vidéo éducative qui fournit une solution détaillée à un problème.
Utilisez le type [VideoObject, LearningResource]
pour les tutoriels vidéo de présentation d'un problème.
Outre les propriétés VideoObject
obligatoires et recommandées, ajoutez les propriétés suivantes pour les tutoriels vidéo de présentation d'un problème.
Propriétés obligatoires | |
---|---|
learningResourceType |
Type de contenu de la vidéo en fonction de son objectif. Pour les vidéos de présentation d'un problème, choisissez "Tutoriel de présentation d'un problème". "learningResourceType": "Problem walkthrough" |
Propriétés recommandées | |
---|---|
hasPart |
Liste des extraits vidéo présents dans la vidéo. Chaque extrait doit être axé sur un problème spécifique.
La liste des propriétés obligatoires et recommandées pour l'objet éducatif Voici un exemple d'extrait avec un tutoriel de présentation d'un problème : [ { "@type": ["Clip","LearningResource"], "learningResourceType": "Problem Walkthrough", "name": "Example 1", "text": "Consider a weight suspended from five wires as shown in Figure. Find the tension in one wire.", "startOffset": 201, "url": "https://www.example.com/example?t=201" }, { "@type": ["Clip","LearningResource"], "learningResourceType": "Problem Walkthrough", "name": "Example 2", "text": "Consider two weights suspended from five wires as shown in Figure. Find the tension in all wires.", "startOffset": 501, "url": "https://www.example.com/example?t=501" } ] |
text |
Texte de la question résolue dans la vidéo.
Si votre vidéo résout plusieurs problèmes, vous pouvez utiliser la même propriété au niveau "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
Extrait vidéo de tutoriel de présentation d'un problème [Clip, LearningResource]
Vous pouvez spécifier des extraits de tutoriels de présentation d'un problème dans la propriété hasPart
des vidéos éducatives. Un extrait de tutoriel de présentation d'un problème est un sous-type d'extrait vidéo éducatif qui comprend une solution détaillée à un problème. Voici la liste des propriétés obligatoires pour les extraits vidéo.
Utilisez le type [Clip, LearningResource]
pour les extraits éducatifs. Outre les propriétés Clip
obligatoires et recommandées, ajoutez les propriétés suivantes pour les tutoriels vidéo de présentation d'un problème.
Propriétés obligatoires | |
---|---|
learningResourceType |
Si l'extrait vidéo propose une solution détaillée à un problème, sa valeur doit être définie sur "learningResourceType": "Problem walkthrough" |
Propriétés recommandées | |
---|---|
text |
Texte de la question résolue dans l'extrait. "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
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 :
- Après avoir déployé des données structurées pour la première fois
- Après avoir publié de nouveaux modèles ou après avoir mis à jour votre code
- 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 :
- Corrigez les éléments non valides.
- Inspectez une URL active pour vérifier si le problème persiste.
- 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.
- Si vous utilisez un système de gestion de contenu (CMS) ou si une autre personne s'occupe de votre site, demandez à la personne en charge de vous aider. Veillez à lui transmettre tous les messages de la Search Console qui détaillent le problème.
- Google ne garantit pas que les fonctionnalités basées sur les données structurées apparaîtront dans les résultats de recherche. Pour consulter la liste des raisons courantes pour lesquelles Google n'affiche pas toujours votre contenu dans un résultat enrichi, reportez-vous aux consignes générales relatives aux données structurées.
- Vos données structurées comportent peut-être une erreur. Consultez la liste des erreurs de données structurées.
- Si vous avez reçu une action manuelle de données structurées concernant votre page, ces données seront ignorées (mais la page concernée apparaîtra peut-être toujours dans les résultats de recherche Google). Pour résoudre les problèmes de données structurées, utilisez le rapport sur les actions manuelles.
- Consultez à nouveau les consignes pour déterminer si votre contenu est bien conforme. Le problème peut être dû à une page contenant du spam ou à l'utilisation de balises qui en contiennent. Toutefois, il est possible qu'il ne s'agisse pas d'un problème de syntaxe et que le test des résultats enrichis ne puisse pas identifier le problème.
- Découvrez comment résoudre les problèmes liés aux résultats enrichis manquants ou à une baisse du nombre total de résultats enrichis.
- Prévoyez un certain temps avant que la réexploration et la réindexation soient effectuées. Gardez à l'esprit qu'il faut souvent compter plusieurs jours après la publication d'une page pour que Google puisse la trouver et l'explorer. Pour toute question d'ordre général sur l'exploration et l'indexation, consultez les FAQ sur l'exploration et l'indexation dans la recherche Google.
- Posez une question sur le forum Google Search Central.
Le contenu ne correspond pas aux données structurées
error Cause du problème : le contenu d'une page ne correspond pas aux données structurées de la page. Par exemple, l'intitulé d'une vidéo sur la page ne correspond pas à la valeur de la propriété name
. Il se peut également que la vidéo contienne du spam, comme des titres et des descriptions de type pièges à clics, ou que le balisage ne soit pas représentatif de la vidéo. Vous avez peut-être reçu le message suivant dans la Search Console : "Non-respect des règles relatives aux données structurées – Il a été constaté que le contenu de la page ne correspond pas aux données structurées de la page".
done Résolution du problème
- Vérifiez que les données structurées sont conformes au contenu réel de la page.
- Utilisez l'outil d'inspection d'URL afin de vous assurer que le contenu est visible sur la page rendue (qui affiche la page telle que Google la voit).
- Une fois que vous avez résolu le problème, envoyez une demande de réexamen.