Qué hace esta característica
Cuando activas esta opción, SEOPress detecta el primer vídeo de YouTube insertado en el contenido de una entrada, página o tipo de contenido personalizado, y lo utiliza para rellenar automáticamente los datos estructurados de Vídeo (VideoObject) en esa URL.
En lugar de abrir cada entrada para copiar el título del vídeo, la descripción, la URL de la miniatura, la fecha de publicación y la duración en la metabox del schema de Vídeo, SEOPress lee esos valores directamente desde el vídeo de YouTube y genera un bloque JSON-LD VideoObject válido en el código fuente de la página.
La característica solo actúa sobre el primer vídeo de YouTube encontrado en el contenido. Si una entrada contiene varias inserciones, las demás se ignoran para la generación del schema.
Por qué importa el schema de Vídeo
VideoObject es el tipo de datos estructurados que Google utiliza para entender el contenido de vídeo en una página web. Cuando el marcado es válido y completo, Google puede:
- Mostrar el vídeo como resultado enriquecido en la búsqueda.
- Mostrar una miniatura junto al enlace azul estándar.
- Posicionar la página en la pestaña Vídeos y en Discover.
- Indexar momentos clave y clips cuando las propiedades correspondientes están presentes.
Sin marcado VideoObject, una página que inserta un vídeo sigue siendo indexable, pero los motores de búsqueda tienen que deducir por sí mismos la relación entre la página y el vídeo. Unos datos estructurados explícitos eliminan esa ambigüedad.
Requisitos
Antes de activar la característica, comprueba que:
- Utilizas SEOPress PRO (>= 9.9).
- Tu contenido incluye al menos una inserción de YouTube (bloque de inserción, URL oEmbed en su propia línea o iframe que apunte a
youtube.comoyoutu.be). - Tu sitio puede realizar peticiones HTTP salientes al endpoint oEmbed de YouTube y a las URLs de miniaturas de YouTube. Los alojamientos que bloquean las peticiones salientes impedirán que SEOPress obtenga los metadatos del vídeo.
Cómo activarla
- En la administración de WordPress, ve a SEO, Pro, pestaña Tipos de datos estructurados.
- Activa Autocompletar el esquema de vídeo a partir del primer vídeo de YouTube.
- Guarda los cambios.
A partir de ese momento, cualquier entrada que coincida con esta regla y contenga una inserción de YouTube generará un bloque JSON-LD VideoObject en el front-end.
Qué propiedades se rellenan
Cuando la característica se ejecuta, SEOPress intenta rellenar las propiedades estándar de VideoObject:
name: el título del vídeo de YouTube.description: la descripción del vídeo de YouTube.thumbnailUrl: la miniatura de alta resolución servida por YouTube.uploadDate: la fecha de publicación devuelta por YouTube.duration: la duración en formato ISO 8601 (por ejemplo,PT4M13S).contentUrlyembedUrl: las URLs canónicas de YouTube.
Si YouTube no devuelve un valor concreto, SEOPress omite esa propiedad en lugar de emitir una cadena vacía.
Verificar el resultado
Después de guardar una entrada, comprueba que el schema se renderiza correctamente:
- Carga la entrada en el front-end.
- Visualiza el código fuente de la página y busca
"@type":"VideoObject". Deberías ver un bloque con las propiedades listadas más arriba. - Pasa la URL por la y confirma que el resultado de Vídeo se detecta sin errores.
- Si usas Google Search Console, supervisa el informe Vídeos durante las semanas siguientes para confirmar que las URLs son elegibles.
Si VideoObject no aparece en el front-end, verifica que la entrada contenga realmente una inserción de YouTube, que la regla del schema se aplique al tipo de contenido y que nada en el servidor esté bloqueando las peticiones a youtube.com.
Cuándo seguir rellenando los campos manualmente
La característica automática es una herramienta de productividad, no un sustituto del criterio editorial. Hay casos en los que conviene seguir escribiendo los campos a mano:
- El título de YouTube es genérico o sensacionalista y quieres una descripción alineada con el tema de la página.
- La primera inserción de YouTube en el contenido no es el vídeo principal de la página (por ejemplo, aparece en una barra lateral o en un bloque de contenido relacionado por encima del tema principal).
En estos casos, rellena los campos correspondientes en la metabox del schema de Vídeo y deja que SEOPress los combine con el resto de los datos obtenidos.
Preguntas frecuentes
¿Funciona esta característica con Vimeo, Wistia o vídeos auto-alojados?
No. La implementación actual está limitada a YouTube. Para otros proveedores, rellena la metabox del schema de Vídeo manualmente.
¿Qué ocurre si cambio el vídeo insertado más adelante?
En el siguiente guardado de la entrada, SEOPress vuelve a leer la primera inserción de YouTube y refresca los valores autocompletados. Los campos rellenados manualmente se conservan.
¿Esto ralentizará mi sitio?
La consulta se produce en el momento del guardado, no en cada petición del front-end. El JSON-LD generado se cachea junto con la entrada, por lo que los visitantes no pagan ningún coste en latencia.