Generar Schema de VideoObject sin escribir JSON a mano
Rellena los campos, título, descripción, URL de miniatura, fecha de subida, y construye un JSON-LD de VideoObject válido que puedes pegar directamente en tu página. Sin escribir corchetes a mano, sin olvidar una coma que rompa silenciosamente todo el bloque. Se ejecuta en el navegador, por lo que los detalles nunca salen de tu máquina.
Estos son los datos estructurados que Google lee para mostrar una miniatura de video en la búsqueda, listar tu video en la pestaña de Videos y, a veces, enlazar a momentos clave dentro de él. Sin ellos, un video incrustado en tu página a menudo es invisible para toda esa superficie.
Los campos que Google realmente requiere
La mayoría de las guías de schema enumeran veinte propiedades opcionales y ocultan las cuatro que importan. Para un resultado enriquecido de video, Google necesita exactamente estos: name, description, thumbnailUrl y uploadDate. Falta uno solo y el resultado enriquecido no aparece, punto.
Luego está el par que decide si el video puede ser indexado en absoluto: contentUrl (un enlace directo al archivo multimedia, generalmente un .mp4) o embedUrl (el src del iframe del reproductor). Uno de los dos tiene que ser accesible para Googlebot. Un contentUrl detrás de un inicio de sesión o una URL firmada que expira es la razón más común por la que un schema técnicamente válido aún no obtiene nada.
El generador marca esos campos obligatorios y te dice, en vivo, si lo que has introducido es suficiente para un resultado enriquecido o simplemente lo suficiente para ser válido.
Donde la gente se equivoca con la duración y la fecha
Dos campos confunden más a la gente que el resto.
La duración debe ser ISO 8601, lo cual no es obvio. Seis minutos y treinta segundos es PT6M30S, no 6:30 y no 390. El generador toma minutos y segundos simples y escribe la cadena PT... por ti, porque equivocarse en esto es silencioso, el schema valida pero la duración no muestra nada.
La fecha de subida requiere una fecha de publicación real en formato YYYY-MM-DD. Si no sabes la fecha exacta en que un video se publicó, el propio archivo a menudo la tiene. El analizador de metadatos de video lee la fecha de grabación directamente de un MP4 o MOV, que es la fuente honesta para ello en lugar de una suposición.
Añádelo, luego pruébalo
Copia el bloque generado y pégalo en el <head> de la página donde reside el video, o en cualquier parte del <body>, ambos funcionan. Es una etiqueta <script type="application/ld+json">, por lo que no renderiza nada visible, simplemente está ahí para que los rastreadores lo lean.
Luego pruébalo. Pega la URL de la página en la Prueba de resultados enriquecidos de Google o en el Validador de marcado de schema y confirma que se analiza sin errores y que Google ve un video. Haz esto antes de asumir que funcionó; un schema que te parece correcto aún puede fallar en un validador debido a un campo en el que no pensaste.
Un límite honesto: el schema no fuerza un resultado enriquecido. Hace que tu video sea elegible. Google aún decide si mostrar la miniatura basándose en la consulta, la calidad de la página y su propio juicio. El marcado válido es necesario, no suficiente.
Después del Marcado
El schema describe el video, pero una página se clasifica por más que solo el marcado. Para escribir la descripción y el título que lo acompañan, el generador de descripciones de video convierte el video en texto listo para la plataforma. Para comprobar ese título y descripción contra los mecanismos que deciden los clics, pásalos por el analizador SEO de videos. Y si quieres una transcripción en la página (lo que ayuda tanto a lectores como a rastreadores), el generador de transcripciones produce una a partir del archivo.
Preguntas Frecuentes
¿Qué es el esquema VideoObject?
Es un fragmento de datos estructurados, escrito como JSON-LD, que indica a los motores de búsqueda que una página contiene un video y les proporciona su título, descripción, miniatura, fecha y duración. Google lo utiliza para mostrar miniaturas de videos en los resultados de búsqueda y para listar el video en la pestaña Videos.
¿Es gratis este generador de esquemas de video?
Sí, y funciona completamente en tu navegador. No hay registro, no hay subida de archivos y no hay límite, porque el marcado se genera en tu dispositivo a partir de los campos que introduces. Nada se envía a un servidor.
¿Qué campos necesito realmente?
Para un resultado enriquecido de video, Google requiere name, description, thumbnailUrl y uploadDate. Para permitir que el video sea indexado, añade contentUrl (un enlace directo a los medios) o embedUrl (la fuente del iframe del reproductor). El generador te indica cuáles de estos te faltan.
¿Por qué mi esquema válido sigue sin mostrar un resultado enriquecido?
Normalmente, el contentUrl o embedUrl no es accesible, está detrás de un inicio de sesión o la URL expira. La otra causa común es que un marcado válido solo hace que el video sea elegible; Google todavía elige si mostrar el resultado enriquecido para una búsqueda determinada. Prueba la página en la Prueba de resultados enriquecidos para separar un problema de marcado de uno de juicio de Google.
¿Cómo escribo la duración correctamente?
Usa el formato ISO 8601: PT seguido de minutos y segundos, como PT6M30S para seis minutos y treinta segundos. Este generador lo escribe a partir de los números simples que introduces, para que no tengas que recordar el formato.
¿Dónde pego el código?
En el HTML de la página donde se encuentra el video, ya sea en la sección <head> o en el <body>. Es una etiqueta script que no muestra nada visible. Si utilizas WordPress o un CMS, la mayoría tienen un campo o un plugin para añadir JSON-LD a una página específica.