Datos estructurados de vídeo formativo (LearningResource
, VideoObject
y Clip
)
![Ejemplo de un resultado enriquecido de vídeo formativo](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/learning_videos_example.png?authuser=6&hl=es)
La Búsqueda de Google es la puerta de entrada para que alumnos y profesores descubran y vean vídeos educativos. Cuando proporcionas información específica de aprendizaje con datos estructurados, como el nivel educativo, el concepto y las habilidades que se tratan en el vídeo, Google puede entender mejor el contenido de tu vídeo y proporcionar una experiencia mejorada que ayude a los usuarios a encontrar el contenido adecuado.
Los datos estructurados de vídeo formativo también pueden habilitar los chips de información sobre el vídeo, como el nivel educativo y el tipo de vídeo (por ejemplo, un vídeo de introducción o de solución).
![Cómo pueden aparecer los chips de información debajo de un vídeo formativo antes de que el usuario lo toque](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/learning_videos_pretap.png?authuser=6&hl=es)
![Cómo pueden aparecer los chips de información encima de un vídeo formativo después de que el usuario lo toque](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/learning_videos_posttap.png?authuser=6&hl=es)
Disponibilidad de la función
Los resultados enriquecidos de vídeo formativo están disponibles en inglés en todos los países en los que se puede usar la Búsqueda de Google. Esta función solo está disponible cuando buscas contenido educativo en ordenadores y en dispositivos móviles.
Ejemplos
Vídeo formativo individual
A continuación, se muestra un ejemplo de un vídeo formativo individual.
<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>
Vídeo formativo con varios clips
A continuación, se muestra un ejemplo de un vídeo formativo con tres clips: dos clips para explicar el problema y otro para ver una descripción general del concepto.
<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>
Vídeo de guía para solucionar problemas
En este ejemplo se muestran todas las propiedades que deben añadirse a las etiquetas de un vídeo formativo para que se considere una guía para solucionar problemas válida.
<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>
Varios clips de guía para solucionar problemas
A continuación se muestra un ejemplo de una página web con varios clips de guía para solucionar problemas. En el ejemplo se indican todas las propiedades que se deben añadir a las etiquetas de vídeos formativos a nivel de vídeo y de clip para que los datos estructurados sean válidos.
<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>
Cómo añadir datos estructurados
Los datos estructurados son un formato estandarizado con el que se puede proporcionar información sobre una página y clasificar su contenido. Consulta cómo funcionan los datos estructurados si aún no te has familiarizado con ellos.
A continuación se explica a grandes rasgos cómo crear, probar y publicar datos estructurados. Si necesitas una guía detallada para añadir datos estructurados a una página web, consulta el codelab de datos estructurados.
- Añade las propiedades obligatorias. Consulta más información sobre dónde insertar datos estructurados en una página en función del formato que estés utilizando.
- Sigue las directrices.
- Valida tu código con la prueba de resultados enriquecidos y corrige los errores críticos. Te recomendamos que también corrijas los problemas no críticos que puedan marcarse en la herramienta, ya que pueden ayudar a mejorar la calidad de los datos estructurados (sin embargo, esto no es necesario para que se muestren los resultados enriquecidos).
- Crea varias páginas que incluyan tus datos estructurados y comprueba cómo las ve Google con la herramienta de inspección de URLs. Asegúrate de que Google pueda acceder a tu página y de que no esté bloqueada por un archivo robots.txt, por la etiqueta
noindex
ni por requisitos de inicio de sesión. Si la página se ve bien, puedes solicitar que Google vuelva a rastrear tus URLs. - Para que Google siempre tenga la versión actualizada de tus páginas, te recomendamos que envíes un sitemap. Puedes automatizar este envío con la API Sitemap de Search Console.
Directrices
Para que tu página pueda aparecer en resultados enriquecidos de vídeos formativos, debes seguir estas directrices:
- Directrices generales de datos estructurados
- Directrices básicas de la Búsqueda
- Prácticas recomendadas para vídeos
- Directrices sobre sitemaps de vídeo
- Directrices técnicas
Directrices técnicas
- Además de las etiquetas de vídeo formativo, debes añadir las propiedades obligatorias y recomendadas de
VideoObject
. - El vídeo debe ser público y tiene que poder verse sin suscripción.
- El vídeo debe durar al menos 30 segundos.
- Las etiquetas de vídeo formativo deben añadirse a una página en la que los usuarios puedan ver el vídeo. Dirigir a los usuarios a una página en la que no pueden ver el vídeo ofrece una mala experiencia de usuario.
Definiciones de tipos de datos estructurados
Puedes consultar la definición completa de VideoObject
y LearningResource
en VideoObject
y LearningResource
de schema.org.
Debes incluir las propiedades obligatorias para que tu contenido pueda mostrarse como un resultado enriquecido de vídeo formativo. También puedes incluir las propiedades recomendadas para añadir más información sobre tu contenido, lo que puede ayudar a mejorar la experiencia de usuario.
Vídeo formativo [VideoObject
, LearningResource
]
El objetivo de las etiquetas de vídeo formativo es ofrecer más visibilidad sobre el contenido educativo del vídeo, ya que contienen información sobre los diferentes conceptos y habilidades que se enseñan en el vídeo.
Utiliza el tipo [VideoObject, LearningResource]
para vídeos formativos.
Además de las propiedades obligatorias y recomendadas de VideoObject
, añade las siguientes propiedades de vídeos formativos.
Propiedades obligatorias | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
educationalAlignment
|
Indica el código estándar, la clase o el examen asociados al contenido. Usa esta propiedad solo si tu contenido cumple una normativa o un examen específicos. En caso contrario, usa solo la propiedad
Aunque puedes proporcionar varios valores Ejemplos: "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 |
Es el nivel educativo objetivo del vídeo. Indica el nivel educativo objetivo como un valor específico o genérico del país. Valores específicos del país:
Cada país tiene su propio sistema académico. Define
Ejemplo: "educationalLevel": "10th Grade (AR)" Valores genéricos:
Solo se puede especificar uno de estos valores genéricos como
"educationalLevel": "Beginner" |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
learningResourceType |
El tipo de contenido del vídeo, en función de lo que se intente conseguir. Esta propiedad se puede usar a nivel de vídeo (si el vídeo solo incluye un tipo de contenido) o a nivel de clip (si el vídeo incluye más de un tipo de contenido). En la siguiente lista se muestran algunos ejemplos de valores aceptables. Si tu vídeo no se ajusta a ninguno de estos valores, puedes crear uno, ya que estamos pensando en admitir nuevos valores. Pero ten en cuenta que, si no se indica ninguno de los valores de esta lista, puede que la información sobre el tipo de aprendizaje no se utilice en ninguna función de búsqueda.
"learningResourceType": "Problem walkthrough" |
Propiedades recomendadas | |
---|---|
educationalAlignment.educationalFramework
|
El nombre del estándar oficial asociado al contenido. "educationalFramework": "Common Core" |
educationalAlignment.targetName |
El código o nodo del estándar (por ejemplo, CCSS.MATH.CONTENT.7.SP.B.4, AP physics A, CCSS.MATH). "targetName": "CCSS.MATH.CONTENT.7.SP.B.4" |
educationalAlignment.targetUrl |
La URL que dirige a la descripción del estándar. "targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/" |
hasPart |
Indica una lista de clips del vídeo. Cada clip debe centrarse en un tema o problema concreto.
La lista de propiedades obligatorias y recomendadas del objeto educativo Este es un ejemplo de un clip de guía para solucionar problemas: { "@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" } A continuación, se muestra un ejemplo de un clip donde se ofrece una descripción general de un concepto: { "@type": ["Clip","LearningResource"], "learningResourceType": "Concept Overview", "name": "ABC Law", "startOffset": 501, "url": "https://www.example.com/example?t=501" } |
text |
Indica el texto de la pregunta que se resuelve en el vídeo. En esta propiedad debe incluirse la pregunta completa, no solo el título de la pregunta.
Si tu vídeo soluciona más de un problema, puedes usar la misma propiedad, pero a nivel de "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
Clip formativo [Clip, LearningResource]
Los clips formativos se pueden incluir como parte de la propiedad hasPart
en vídeos formativos. A continuación, se muestra la lista de propiedades recomendadas para clips.
Etiqueta los clips formativos con el tipo [Clip, LearningResource]
. Además de las propiedades obligatorias y recomendadas de Clip
, añade las siguientes propiedades de clips formativos.
Propiedades recomendadas | |
---|---|
learningResourceType |
El tipo de contenido del clip, en función de lo que se intente conseguir. Si el clip incluye la solución paso a paso de un problema, el valor puede ser En la lista de abajo se muestran algunos ejemplos de valores aceptables. Si tu clip no se ajusta a ninguno de estos valores, puedes crear uno, ya que estamos pensando en admitir nuevos valores. Pero ten en cuenta que, si no se indica ninguno de los valores de esta lista, puede que la información no se utilice en ninguna función de búsqueda. Valores aceptables:
"learningResourceType": "Problem walkthrough" |
Vídeo de guía para solucionar problemas [VideoObject
, LearningResource
]
Se trata de un subtipo de vídeo formativo que proporciona una solución paso a paso para un problema.
Usa el tipo [VideoObject, LearningResource]
con los vídeos que sean guías para solucionar problemas. Además de las propiedades obligatorias y recomendadas de VideoObject
, añade las siguientes propiedades de este tipo de vídeos.
Propiedades obligatorias | |
---|---|
learningResourceType |
El tipo de contenido del vídeo, en función de lo que se intente conseguir. En el caso de los videos que sean guías para solucionar problemas, se debe configurar como "Guía para solucionar problemas". "learningResourceType": "Problem walkthrough" |
Propiedades recomendadas | |
---|---|
hasPart |
Indica una lista de clips del vídeo. Cada clip debe centrarse en un problema concreto.
La lista de propiedades obligatorias y recomendadas del objeto educativo A continuación, te mostramos un ejemplo de un clip de guía para solucionar problemas: [ { "@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 |
Indica el texto de la pregunta que se resuelve en el vídeo.
Si tu vídeo resuelve más de un problema, puedes usar la misma propiedad a nivel de "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
Clip de guía para solucionar problemas [Clip, LearningResource]
Los clips de guías para solucionar problemas pueden especificarse como parte de la propiedad hasPart
en vídeos formativos. Una guía para solucionar problemas es un subtipo de clip formativo, en el que se explica paso a paso cómo resolver un problema. A continuación, te ofrecemos una lista de propiedades obligatorias para este tipo de clips.
Usa el tipo [Clip, LearningResource]
para clips formativos. Además de las propiedades obligatorias y recomendadas de Clip
, añade las siguientes propiedades a los clips de guías para solucionar problemas.
Propiedades obligatorias | |
---|---|
learningResourceType |
Si el clip incluye la solución paso a paso de un problema, el valor debe ser "learningResourceType": "Problem walkthrough" |
Propiedades recomendadas | |
---|---|
text |
Indica el texto de la pregunta que se resuelve en el clip. "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
Monitorizar resultados enriquecidos con Search Console
Search Console es una herramienta que te ayuda a monitorizar el rendimiento de tus páginas en la Búsqueda de Google. No hace falta que te registres en Search Console para que tu sitio web aparezca en los resultados de la Búsqueda de Google, pero, si lo haces, sabrás cómo lo ve Google y qué puedes hacer para mejorarlo. Te recomendamos que consultes Search Console en los siguientes casos:
- Después de implementar datos estructurados por primera vez
- Después de publicar plantillas nuevas o modificar el código
- Al hacer el análisis periódico del tráfico
Después de implementar datos estructurados por primera vez
Una vez que Google haya indexado tus páginas, puedes comprobar si hay algún problema en el informe de estado de resultados enriquecidos correspondiente. Lo ideal es que haya un aumento en el número de elementos válidos y que no lo haya en el número de elementos no válidos. Si detectas problemas en tus datos estructurados, haz lo siguiente:
- Corrige los elementos no válidos.
- Inspecciona la URL en tiempo real para ver si el problema continúa.
- Solicita que se valide la corrección desde el informe de estado.
Después de publicar plantillas nuevas o modificar el código
Cuando hagas cambios significativos en tu sitio web, observa si se incrementa la cantidad de elementos no válidos de datos estructurados.- Si notas que hay más elementos no válidos, quizá sea porque has implementado una plantilla que no funciona, o puede que tu sitio esté interactuando con la plantilla que utilizas de un modo diferente que no es adecuado.
- Si notas que hay menos elementos válidos, pero no hay un incremento de elementos no válidos, es posible que hayas dejado de insertar datos estructurados en tus páginas. Para saber cuál es la causa del problema, utiliza la herramienta de inspección de URLs.
Al hacer el análisis periódico del tráfico
Consulta el informe de rendimiento para analizar el tráfico de tus páginas en la Búsqueda de Google. En él, verás con qué frecuencia aparece tu página como resultado enriquecido en la Búsqueda, cada cuánto hacen clic en ella los usuarios y cuál es la posición media que ocupa tu sitio web en los resultados de búsqueda. También puedes obtener automáticamente estos resultados con la API de Search Console.Solucionar problemas
Si tienes problemas para implementar o depurar datos estructurados, a continuación se incluyen algunos recursos que pueden serte útiles.
- Si usas un sistema de gestión de contenido (CMS) o alguien se encarga de gestionar tu sitio, pídele ayuda. No olvides reenviarle cualquier mensaje de Search Console que incluya información sobre el problema en cuestión.
- Google no garantiza que las funciones que utilizan datos estructurados aparezcan en los resultados de búsqueda. Para ver una lista con motivos habituales por los que Google no muestra tu contenido en resultados enriquecidos, consulta las directrices generales de datos estructurados.
- Es posible que haya un error en tus datos estructurados. Consulta la lista de errores de datos estructurados.
- Si se ha aplicado una acción manual de datos estructurados a tu página, se ignorarán sus datos estructurados, aunque la página puede seguir apareciendo en los resultados de la Búsqueda de Google. Para corregir problemas de datos estructurados, usa el informe "Acciones manuales".
- Revisa las directrices para comprobar si tu contenido no las cumple. El problema podría deberse a que la página incluye contenido engañoso o etiquetas con contenido fraudulento. No obstante, es posible que el problema no se deba a la sintaxis, por lo que la prueba de resultados enriquecidos no podrá ayudarte a identificarlo.
- Soluciona problemas si faltan resultados enriquecidos o si se ha reducido su número total.
- Dale tiempo a Google para que vuelva a rastrear e indexar tu página. Recuerda que Google puede tardar varios días en encontrar y rastrear una página después de publicarse. Consulta las preguntas frecuentes sobre el rastreo y la indexación de la Búsqueda de Google.
- Publica una pregunta en el foro del Centro de la Búsqueda de Google.
El contenido no coincide con los datos estructurados
error Causa del problema: una página incluye contenido que no coincide con el de sus datos estructurados. Por ejemplo, el título de un vídeo de la página no coincide con el valor indicado en la propiedad name
. También puede haber contenido fraudulento, como títulos y descripciones cebo o etiquetas que no son representativas del vídeo real. Es posible que hayas recibido este mensaje de Search Console: "Infracción de la política de datos estructurados: Se ha encontrado contenido en algunas páginas que no se corresponde con sus datos estructurados".
done Corrige el problema
- Verifica que los datos estructurados se correspondan con el contenido real de la página.
- Usa la herramienta de inspección de URLs para asegurarte de que el contenido sea visible en la página renderizada (es decir, tal como Google la ve).
- Una vez resuelto el problema, envía tu sitio para que se vuelva a revisar.