Datos estructurados de videos de aprendizaje (LearningResource
, VideoObject
y Clip
)
![Ejemplo de un resultado enriquecido de video de aprendizaje](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/learning_videos_example.png?authuser=3&hl=es-419)
La Búsqueda de Google es un punto de entrada para que alumnos y profesores descubran y miren videos educativos. Cuando proporcionas información específica del aprendizaje de forma explícita con datos estructurados, como el nivel de educación, el concepto y las habilidades que se abordan en el video, Google puede comprender mejor el contenido de tu video y brindar una experiencia optimizada para ayudar a los alumnos a encontrar el contenido adecuado.
Los datos estructurados de los videos de aprendizaje también pueden habilitar los chips de información sobre el video, como el nivel de educación y el tipo de video (por ejemplo, una descripción general o un video de solución).
![Cómo aparecen los chips de información debajo de un video de aprendizaje antes de que el usuario lo presione](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/learning_videos_pretap.png?authuser=3&hl=es-419)
![Cómo aparecen los chips de información sobre un video de aprendizaje después de que el usuario lo presione](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/learning_videos_posttap.png?authuser=3&hl=es-419)
Disponibilidad de funciones
El resultado enriquecido de videos de aprendizaje está disponible en inglés en todas las regiones en las que está disponible la Búsqueda de Google. La función solo está disponible cuando se busca contenido de aprendizaje académico en computadoras y dispositivos móviles.
Ejemplos
Video de aprendizaje único
Este es un ejemplo de un video de aprendizaje único.
<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>
Video de aprendizaje con varios clips
Este es un ejemplo de un video de aprendizaje que tiene tres clips: dos que explican el problema y uno con 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>
Video explicativo sobre problemas
En este ejemplo, se muestran todas las propiedades que se deben agregar al lenguaje de marcado de videos de aprendizaje para convertirlo en un video explicativo sobre problemas válido.
<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 explicativos sobre diferentes problemas
A continuación, se muestra un ejemplo de página web con varios clips explicativos de problemas. En este ejemplo, se muestran todas las propiedades que se deben agregar al lenguaje de marcado de videos de aprendizaje en el nivel de video y de clip para que sea un lenguaje de marcado de clip explicativo sobre problemas válido.
<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 agregar datos estructurados
Los datos estructurados son un formato estandarizado para proporcionar información sobre una página y clasificar su contenido. Si aún no estás familiarizado con los datos estructurados, obtén más información sobre su funcionamiento.
A continuación, presentamos una descripción general para aprender a compilar, probar y actualizar datos estructurados.
- Agrega las propiedades obligatorias. Según el formato que uses, obtén información sobre las ubicaciones donde puedes insertar datos estructurados en la página.
- Sigue los lineamientos.
- Valida tu código con la Prueba de resultados enriquecidos y corrige cualquier error crítico. Procura también corregir 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).
- Implementa algunas páginas que incluyan tus datos estructurados y utiliza la Herramienta de inspección de URLs para probar el modo en el que Google ve la página. Asegúrate de que Google pueda acceder a la página y que no esté bloqueada por un archivo robots.txt, una etiqueta
noindex
ni requisitos de acceso. Si la página se ve bien, puedes pedirle a Google que vuelva a rastrear tus URLs. - Para mantener informado a Google sobre los cambios futuros, te recomendamos que envíes un mapa del sitio. Puedes automatizar este proceso con la API de Search Console Sitemap.
Lineamientos
Para que tu página sea apta para los resultados enriquecidos de video de aprendizaje, debes seguir estos lineamientos:
- Lineamientos generales de datos estructurados
- Conceptos básicos sobre la Búsqueda
- Prácticas recomendadas para videos
- Lineamientos de mapas del sitio para videos
- Lineamientos técnicos
Lineamientos técnicos
- Además de lenguaje de marcado de video de aprendizaje, debes agregar las propiedades obligatorias y recomendadas de
VideoObject
. - El video debe estar disponible públicamente para reproducirse sin una suscripción.
- La duración total del video debe ser de al menos 30 segundos.
- El lenguaje de marcado de video de aprendizaje se debe agregar a una página en la que los usuarios puedan ver el video. Dirigir a los usuarios a una página en la que no pueden ver el video atenta contra la buena experiencia del usuario.
Definiciones de tipos de datos estructurados
La definición completa de VideoObject
y LearningResource
está disponible en VideoObject
y LearningResource
de schema.org.
Debes incluir las propiedades obligatorias que hacen que tu contenido sea apto para aparecer como resultado enriquecido. También puedes incluir las propiedades recomendadas para agregar más información sobre tu contenido, lo que podría brindar una mejor experiencia del usuario.
Video de aprendizaje [VideoObject
, LearningResource
]
El lenguaje de marcado de videos de aprendizaje está pensado para darle más visibilidad al contenido educativo del video. Puede incluir información sobre los diferentes conceptos y habilidades que se enseñan en el video.
Usa el tipo [VideoObject, LearningResource]
para los videos de aprendizaje.
Además de las propiedades obligatorias y recomendadas de VideoObject
, agrega las siguientes propiedades para los videos de aprendizaje.
Propiedades obligatorias | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
educationalAlignment
|
El código, la clase o el examen estándar oficial asociados con el contenido. Usa esta propiedad solo si tu contenido se alinea con un estándar o un examen específicos. De lo contrario, usa solo la propiedad
Si bien puedes proporcionar varios valores de 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 de educación objetivo del video. Establece el nivel de educación objetivo en un valor genérico o específico del país. Valores específicos del país:
Cada país tiene su propio sistema académico. Establece
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 que se muestra en el video según sus objetivos. Esta propiedad se puede usar en el nivel de video (si el este tiene un solo tipo de contenido) o en el nivel de clip (si el video tiene más de un tipo de contenido). En la siguiente lista, se proporcionan algunos ejemplos de valores aceptables. Si tu video no se ajusta a ninguno de estos valores, puedes crear uno nuevo, ya que estamos considerando nuevos valores para admitir. Ten en cuenta que si el valor no está configurado como uno de los que se indican a continuación, es posible que la información del tipo de aprendizaje no se use en ninguna de las funciones de búsqueda.
"learningResourceType": "Problem walkthrough" |
Propiedades recomendadas | |
---|---|
educationalAlignment.educationalFramework
|
Es el nombre del estándar oficial asociado con el contenido. "educationalFramework": "Common Core" |
educationalAlignment.targetName |
El código o nodo 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 a la descripción estándar. "targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/" |
hasPart |
Una lista de clips en el video. Cada clip debe enfocarse en un tema o problema específico. La lista de propiedades obligatorias y recomendadas para el objeto Este es un ejemplo de un clip explicativo sobre 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" } Este es un ejemplo de un clip en el que se proporciona la descripción general de un tema: { "@type": ["Clip","LearningResource"], "learningResourceType": "Concept Overview", "name": "ABC Law", "startOffset": 501, "url": "https://www.example.com/example?t=501" } |
text |
El texto de la pregunta que se resuelve en el video. Esta propiedad debe incluir la pregunta completa, no solo el título. Si tu video resuelve más de un problema, puedes usar la misma propiedad, pero en el nivel de "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
Clip de aprendizaje [Clip, LearningResource]
Se pueden especificar los clips de aprendizaje como parte de la propiedad hasPart
en los videos de aprendizaje. A continuación, se muestra una lista de propiedades recomendadas para los clips.
Etiqueta los clips de aprendizaje con el tipo [Clip, LearningResource]
. Además de las propiedades obligatorias y recomendadas de Clip
, agrega las siguientes propiedades para los clips de aprendizaje.
Propiedades recomendadas | |
---|---|
learningResourceType |
El tipo de contenido que se muestra en el clip según sus objetivos. Si el clip tiene una solución paso a paso para resolver un problema, se puede establecer el valor en En la siguiente lista, se proporcionan algunos ejemplos de valores aceptables. Si tu clip no se ajusta a ninguno de estos valores, puedes crear uno nuevo, ya que estamos considerando nuevos valores para admitir. Ten en cuenta que si el valor no está configurado como uno de los que se indican a continuación, es posible que la información no se use en ninguna de las funciones de búsqueda. Valores aceptables:
"learningResourceType": "Problem walkthrough" |
Video explicativo sobre problemas [VideoObject
, LearningResource
]
El tipo de video explicativo sobre problemas es un subtipo de video de aprendizaje que brinda una solución paso a paso para resolver un problema.
Usa el tipo [VideoObject, LearningResource]
para los videos explicativos sobre problemas. Además de las propiedades obligatorias y recomendadas de VideoObject
, agrega las siguientes propiedades para los videos explicativos sobre problemas.
Propiedades obligatorias | |
---|---|
learningResourceType |
El tipo de contenido que se muestra en el video según sus objetivos. En el caso de videos explicativos sobre problemas, se debe configurar en "Explicación del problema". "learningResourceType": "Problem walkthrough" |
Propiedades recomendadas | |
---|---|
hasPart |
Una lista de clips en el video. Cada clip debe enfocarse en un problema específico. La lista de propiedades obligatorias y recomendadas para el objeto Este es un ejemplo de un clip con una explicación de un problema: [ { "@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 |
El texto de la pregunta que se resuelve en el video. Si tu video resuelve más de un problema, puedes usar la misma propiedad en el nivel "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
Clip explicativo sobre problemas [Clip, LearningResource]
Se pueden especificar los clips explicativos sobre problemas como parte de la propiedad hasPart
en los videos de aprendizaje. El clip explicativo sobre problemas es un subtipo de clip de aprendizaje que contiene una solución paso a paso para solucionar un problema. A continuación, se muestra una lista de propiedades obligatorias para los clips de explicativos sobre problemas.
Usa el tipo [Clip, LearningResource]
para los clips de aprendizaje. Además de las propiedades obligatorias y recomendadas Clip
, agrega las siguientes propiedades para los clips explicativos sobre problemas.
Propiedades obligatorias | |
---|---|
learningResourceType |
Si el clip tiene una solución paso a paso para resolver un problema, se debe establecer el valor en "learningResourceType": "Problem walkthrough" |
Propiedades recomendadas | |
---|---|
text |
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." |
Cómo supervisar resultados enriquecidos con Search Console
Search Console es una herramienta que te ayuda a supervisar el rendimiento de tus páginas en la Búsqueda de Google. Si bien no es necesario que te registres en Search Console para que se incluya tu contenido en los resultados de la Búsqueda de Google, puede ayudarte a comprender y mejorar la forma en que Google ve tu sitio. Te recomendamos que revises Search Console en los siguientes casos:
- Después de implementar datos estructurados por primera vez
- Después de lanzar plantillas nuevas o actualizar código
- Para analizar tráfico periódicamente
Después de implementar datos estructurados por primera vez
Después de que Google haya indexado tus páginas, busca problemas con el informe de estado de resultados enriquecidos relevante. Lo ideal es que haya un aumento de los elementos válidos y no de los elementos no válidos. Si encuentras problemas en los datos estructurados, haz lo siguiente:
- Corrige los elementos no válidos.
- Inspecciona una URL publicada para verificar si persiste el problema.
- Solicita una validación desde el informe de estado.
Después de lanzar plantillas nuevas o actualizar código
Cuando realices cambios significativos en tu sitio web, supervisa los aumentos en los elementos no válidos de datos estructurados.- Si notas un aumento en la cantidad de elementos no válidos, tal vez se deba a que implementaste una plantilla que no funciona o a que tu sitio interactúa con la plantilla actual de una forma diferente e incorrecta.
- Si notas una disminución de los elementos válidos (que no coincide con un aumento en la cantidad de elementos no válidos), es posible que ya no estés incorporando datos estructurados en tus páginas. Usa la Herramienta de inspección de URLs para saber cuál es la causa del problema.
Cómo analizar el tráfico periódicamente
Analiza el tráfico de la Búsqueda de Google con el Informe de rendimiento. Los datos te mostrarán con qué frecuencia tu página aparece como resultado enriquecido en la Búsqueda, con qué frecuencia los usuarios hacen clic en ella y cuál es la posición promedio en la que apareces en los resultados de la búsqueda. También puedes extraer esos resultados automáticamente con la API de Search Console.Solución de problemas
Si tienes problemas para implementar o depurar datos estructurados, te brindamos algunos recursos que podrían resultarte útiles.
- Si usas un sistema de administración de contenido (CMS), o si alguien más se encarga de tu sitio, pídele que te ayude. Asegúrate de reenviarle cualquier mensaje de Search Console que detalle el problema.
- Google no garantiza que se muestren en los resultados de la búsqueda las funciones que consumen datos estructurados. Para obtener una lista de los motivos comunes por los que Google podría no mostrar tu contenido en un resultado enriquecido, consulta los Lineamientos generales de datos estructurados.
- Es posible que haya un error en los datos estructurados. Consulta la lista de errores de datos estructurados.
- Si recibiste una acción manual de datos estructurados en tu página, estos datos se ignorarán (aunque la página puede seguir apareciendo en los resultados de la Búsqueda de Google). Para solucionar los problemas con datos estructurados, usa el Informe de acciones manuales.
- Vuelve a consultar los lineamientos para determinar si tu contenido no cumple con ellos. El problema puede deberse a contenido generador de spam o a un uso fraudulento del lenguaje de marcado. Sin embargo, es posible que no sea un problema de sintaxis, por lo que la prueba de resultados enriquecidos no podrá identificar estos problemas.
- Soluciona problemas de resultados enriquecidos faltantes o disminución del total de resultados enriquecidos.
- Espera un tiempo suficiente para que se vuelvan a realizar el rastreo y la indexación. No olvides que pueden transcurrir varios días después de publicar una página para que Google la encuentre y la rastree. Si tienes preguntas generales sobre el rastreo y la indexación, consulta las Preguntas frecuentes sobre el rastreo y la indexación de la Búsqueda de Google.
- Publica una pregunta en el foro de la Central de la Búsqueda de Google.
El contenido no coincide con los datos estructurados
error Qué provocó el problema: Una página incluye contenido que no coincide con sus datos estructurados. Por ejemplo, el título de un video en la página no coincide con el valor establecido para la propiedad name
. También podría haber contenido generador de spam, como títulos y descripciones con señuelos de clics, o tal vez el lenguaje de marcado no sea representativo del video. Es posible que hayas recibido el siguiente mensaje de Search Console: "Incumplimiento de la política de datos estructurados: El contenido encontrado en las páginas difiere de los datos estructurados de la página".
done Cómo solucionarlo
- Verifica que los datos estructurados se alineen con el contenido real de la página.
- Usa la Herramienta de inspección de URL a fin de garantizar que el contenido esté visible en la página procesada (es decir, el sitio que ve Google).
- Luego de resolver el problema, envía tu sitio para su reconsideración.