Cómo lograr que tus videos aparezcan en Google con el lenguaje de marcado de Schema

La Búsqueda de Google es un canal de entrada para que los usuarios descubran y miren videos. Sin embargo, aunque Google intenta entender automáticamente los detalles de un video, puedes brindar información explícita, como descripción, URL de la miniatura, fecha de carga y duración, agregando para tu video lenguaje de marcado con VideoObject. Los videos pueden aparecer en los resultados de la Búsqueda de Google, los resultados de la búsqueda de videos, Google Imágenes y Google Descubre.

Captura de pantalla que muestra el contenido de video en los resultados de la Búsqueda de Google, la pestaña de video y Descubre

Según el lenguaje de marcado que uses en tu contenido, los videos también podrían obtener las siguientes mejoras:

Mejoras de video

Insignia de transmisión EN VIVO: Obtén una insignia de transmisión EN VIVO agregando lenguaje de marcado de BroadcastEvent en tu video. Esta insignia puede aplicarse a cualquier video público de cualquier duración que se transmita en vivo. Siguen algunos ejemplos:

  • Eventos deportivos
  • Ceremonias de premios
  • Videos de influencers
  • Transmisión en vivo de videojuegos

Asegúrate de seguir los Lineamientos para las insignias de transmisión EN VIVO y usar la API de Indexing para garantizar que Google rastree tus páginas en el momento indicado.

Video con una insignia de transmisión EN VIVO en los resultados de la búsqueda

Actividades para hacer en casa: Ayuda a las personas a encontrar actividades para hacer en casa. Cuando se buscan actividades para hacer en casa, los videos y los eventos en línea aparecen en un resultado enriquecido interactivo. Si agregas datos estructurados de Video, es posible que tus videos ya sean aptos para este resultado enriquecido, sin que debas realizar pasos adicionales.

Para obtener más información sobre la disponibilidad, los lineamientos y ejemplos de la función, consulta Actividades para hacer en casa.

Actividades para hacer en casa en los resultados de la búsqueda

Momentos clave

La función de momentos clave es una forma de que los usuarios se desplacen por los segmentos de un vídeo como si fueran capítulos de un libro. De este modo, los usuarios pueden interactuar más con tu contenido. La Búsqueda de Google trata de detectar automáticamente los diferentes segmentos de tu vídeo y mostrar a los usuarios los momentos clave sin que tengas que hacer nada. Si lo prefieres, puedes indicar manualmente a Google cuáles son los momentos importantes de tus vídeos.

  • Si el vídeo está alojado en tu página web, tienes dos formas de habilitar la función de momentos clave:
    • Datos estructurados de Clip: indica de forma precisa cuándo deben empezar y terminar los segmentos, y proporciona la etiqueta que se mostrará en cada uno de ellos.
    • Datos estructurados de SeekToAction: indica a Google en qué parte de la estructura de tus URLs suelen estar las marcas de tiempo para que pueda detectar automáticamente los momentos clave y mostrar a los usuarios enlaces a ellos.
  • Si tu vídeo está alojado en YouTube, puedes especificar las marcas de tiempo y las etiquetas exactas en la descripción del vídeo de la plataforma. Consulta las prácticas recomendadas para indicar marcas de tiempo en descripciones de YouTube.

Para inhabilitar por completo la función de momentos clave, impidiendo incluso que Google muestre automáticamente momentos clave de tu vídeo, usa la metaetiqueta nosnippet.

Video con momentos clave en los resultados de la búsqueda
Carrusel de host de video (acceso limitado): Permite que los usuarios exploren las páginas de tu galería de videos agregando datos estructurados de ItemList.

Ejemplos

Resultado enriquecido de video estándar

Ejemplo de resultados de la búsqueda de videos estándar

Este es un ejemplo de un VideoObject.

JSON-LD


      
Microdatos


      

Insignia de transmisión EN VIVO

Ejemplo de un video en los resultados de la búsqueda con una insignia de transmisión EN VIVO

Este es un ejemplo de VideoObject y BroadcastEvent.

JSON-LD


      
Microdatos


      

Este es un ejemplo de datos estructurados de VideoObject y ItemList. Actualmente, esta función está limitada a un pequeño conjunto de proveedores.

JSON-LD


      
Microdatos


      

Clip

Ejemplo de un video en los resultados de la búsqueda con momentos clave

Este es un ejemplo de VideoObject y Clip.

JSON-LD


      
Microdatos


      

SeekToAction

Aquí tienes un ejemplo de un VideoObject único que incluye las propiedades adicionales necesarias para el lenguaje de marcado SeekToAction.

JSON-LD


      
Microdatos


      

Página de AMP con un video

Este es un ejemplo de un VideoObject en una página de AMP.

JSON-LD


      
Microdatos


      

Lineamientos

Para ayudar a Google a comprender mejor tu video, asegúrate de seguir los lineamientos que se indican más abajo:

Lineamientos para las insignias de transmisión EN VIVO

Si quieres agregar BroadcastEvent a videos de transmisión en vivo, debes seguir estos lineamientos:

  • No uses lenguaje vulgar o potencialmente ofensivo en los datos estructurados.
  • Para asegurarte de que Google rastree tu video de transmisión en vivo en el momento oportuno, usa la API de Indexing. Llama a la API para los siguientes eventos:
    • Cuando el video se transmita en vivo
    • Cuando se detenga la transmisión del video y el lenguaje de marcado de la página se actualice para indicar la endDate
    • Cada vez que se produzca un cambio en el lenguaje de marcado y sea necesario notificar a Google

Prácticas recomendadas para incluir marcas de tiempo en YouTube

Si tu video está alojado en YouTube, la Búsqueda de Google puede habilitar momentos clave automáticamente según la descripción del video en ese servicio, y es posible que no tengas que incluir marcas de tiempo específicas en tu descripción de YouTube. Sin embargo, puedes indicarnos de manera más explícita los puntos importantes de tu video y le daremos prioridad a esa información. El siguiente diagrama muestra cómo pueden aparecer en los resultados de la búsqueda las marcas de tiempo y las etiquetas de la descripción de un video de YouTube:

Video en los resultados de la búsqueda con marcas de tiempo y etiquetas
1. Marca de tiempo: Indica cuándo comienza un clip.
2. Etiqueta: Es el nombre del clip.

Ten en cuenta los siguientes lineamientos cuando les des formato a las marcas de tiempo y etiquetas de las descripciones de YouTube:

  • Para las marcas de tiempo, usa el siguiente formato: [hour]:[minute]:[second]. Si no hay una hora definida, no es necesario que incluyas ese dato.
  • Especifica la etiqueta de la marca de tiempo en la misma línea que la propia marca de tiempo.
  • Coloca cada marca de tiempo en una nueva línea en la descripción del video.
  • Vincula la marca de tiempo con el punto especificado en el video.
  • Asegúrate de que la etiqueta contenga al menos una palabra.
  • Enumera las marcas de tiempo en orden cronológico.

Lineamientos de Clip y SeekToAction

Si quieres agregar datos estructurados de Clip o SeekToAction para marcar segmentos de video, sigue estos lineamientos:

  • El video debe tener la capacidad de establecer un vínculo directo a un punto que no sea el de inicio en la URL del video. Por ejemplo, http://www.example.com/example?t=30 comienza a los 30 segundos de un video.
  • Los datos estructurados de VideoObject se deben 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.
  • La duración total del video debe ser de al menos 30 segundos.
  • El video debe incluir las propiedades obligatorias que se enumeran en la documentación de datos estructurados de VideoObject.
  • Solo para datos estructurados de Clip: Asegúrate de que no haya dos clips en el mismo video definidos en la misma página que compartan la misma hora de inicio.
  • Solo para datos estructurados de SeekToAction: Google debe poder recuperar los archivos de contenido de video.

Definiciones de tipos de datos estructurados

En esta sección se describen los tipos de datos estructurados relacionados con las funciones de video que ofrece la Búsqueda de Google. Debes incluir las propiedades obligatorias de VideoObject para que pueda mostrarse tu contenido como resultado enriquecido de video. También puedes incluir las propiedades recomendadas para agregar más información sobre el contenido, lo que podría brindar una mejor experiencia del usuario. Además de VideoObject, puedes agregar los siguientes tipos de datos para habilitar las mejoras de video en la Búsqueda de Google:

  • BroadcastEvent: Agrega lenguaje de marcado en los videos de transmisión en vivo para habilitar una insignia de transmisión EN VIVO en tu video.
  • ItemList: Agrega lenguaje de marcado en las páginas con listas de videos para habilitar un carrusel de host de video.
  • Clip: Marca segmentos importantes en tu video de forma manual para ayudar a los usuarios a navegar rápidamente a puntos específicos de él.
  • SeekToAction: Habilita momentos clave indicando cómo funciona la estructura de la URL de modo que Google pueda identificarlos automáticamente y vincular a los usuarios con esos puntos dentro del video.

VideoObject

La definición completa de VideoObject está disponible en schema.org/VideoObject. Si no incluyes las propiedades obligatorias, es posible que Google no pueda extraer información sobre el video. También puedes incluir las propiedades recomendadas para agregar más información sobre el contenido, lo que podría brindar una mejor experiencia del usuario.

Propiedades obligatorias
description

Text

Descripción del video. Se ignoran las etiquetas HTML.

name

Text

Título del video.

thumbnailUrl

Valor repetido de URL

Una URL que dirige al archivo de imagen de la miniatura de video. Sigue los lineamientos para imágenes en miniatura.

uploadDate

Date

Fecha en que se publicó el video por primera vez. Debe mostrarse en formato ISO 8601.

Propiedades recomendadas
contentUrl

URL

Una URL que dirige al archivo multimedia de video real, en uno de los formatos de codificación admitidos. No vincules a la página donde se encuentra el video. Esta debe ser la URL del archivo multimedia del video.


"contentUrl": "https://www.example.com/video/123/file.mp4"

Asegúrate de seguir nuestras Recomendaciones de video.

duration

Duration

Duración del video en formato ISO 8601. Por ejemplo, PT00H30M5S representa una duración de "treinta minutos y cinco segundos".

embedUrl

URL

Una URL que dirige a un reproductor para el video específico. No vincules a la página donde se encuentra el video. Esta debe ser la URL del reproductor de video. Por lo general, esta es la información que contiene el elemento src de una etiqueta <embed>.


"embedUrl": "https://www.example.com/embed/123"

Asegúrate de seguir nuestras Recomendaciones de video.

expires

Date

Si corresponde, indica la fecha en que dejará de estar disponible el video. Debe mostrarse en formato ISO 8601. No incluyas esa información si el video no va a caducar.

hasPart

Si tu video tiene segmentos importantes, anida las propiedades Clip obligatorias en tu VideoObject. Por ejemplo:


<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "VideoObject",
  "name": "Cat video",
  "hasPart": {
    "@type": "Clip",
    "name": "Cat jumps",
    "startOffset": 30,
    "url": "http://www.example.com/example?t=30"
  }
}
</script>
interactionStatistic

InteractionCounter

Cantidad de reproducciones del video. Por ejemplo:


"interactionStatistic":
  {
    "@type": "InteractionCounter",
    "interactionType": { "@type": "WatchAction" },
    "userInteractionCount": 12345
  }
publication

Si tu video se transmite en vivo y quieres que sea apto para obtener la insignia correspondiente, anida las propiedades de BroadcastEvent en tu VideoObject. Por ejemplo:


<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "VideoObject",
  "name": "Cat video",
  "publication": {
    "@type": "BroadcastEvent",
    "name": "First scheduled broadcast",
    "isLiveBroadcast": true,
    "startDate": "2018-10-27T14:00:00+00:00",
    "endDate": "2018-10-27T14:37:14+00:00"
  }
}
</script>
regionsAllowed

Place

Regiones en las que está permitido reproducir el video. Si no se especifican, Google asume que el video está permitido en todas partes. Especifica los países en formato ISO 3166. Si incluyes varios valores, usa un espacio o una coma como delimitador.

BroadcastEvent

Para que el video sea apto para mostrarse con una insignia de transmisión EN VIVO, anida las siguientes propiedades en tu VideoObject. Si bien las propiedades de BroadcastEvent no son obligatorias, debes agregar las que se indican a continuación si deseas que tu video se muestre con una insignia de transmisión EN VIVO.

La definición completa de BroadcastEvent está disponible en schema.org/BroadcastEvent.

Propiedades obligatorias
publication

BroadcastEvent

Indica cuándo se transmitirá en vivo el video. Puede ser una lista o una sola instancia.

publication.endDate

DateTime

Fecha y hora de finalización conocidas o previstas de la transmisión en vivo en formato ISO 8601.

Es obligatorio indicar la endDate una vez que el video haya finalizado y ya no esté en vivo. Si no conoces la endDate prevista antes de que comience la transmisión en vivo, recomendamos indicar una endDate aproximada.

Si la endDate es en el pasado o en el presente, indica que finalizó la transmisión y ya no está en vivo. Si endDate es en el futuro, indica que la transmisión está programada para finalizar en ese momento.

publication.isLiveBroadcast

Booleano

Configúrala en true si el video se transmitió en vivo, se está transmitiendo en vivo o se transmitirá en vivo.

publication.startDate

DateTime

Fecha y hora conocidas o previstas de inicio de la transmisión en vivo en formato ISO 8601. Si startDate es en el pasado o en el presente, indica que la trasmisión ya comenzó. Si startDate es en el futuro, indica que la transmisión está programada para comenzar en ese momento.

ItemList (acceso limitado)

Para ayudar a Google a comprender mejor las páginas de tu galería de videos, agrega las siguientes propiedades de ItemList, además de las propiedades de VideoObject. Para obtener más información, consulta Carrusel.

La definición completa de ItemList está disponible en schema.org/ItemList.

Propiedades obligatorias
itemListElement

ListItem

Anotación de una página de un solo elemento. Cada elemento ListItem debe incluir propiedades VideoObject y ListItem.

ListItem.position

Integer

Posición ordinal de la página del elemento en la lista. Por ejemplo:


"itemListElement": [
  {
    "@type": "VideoObject",
    "position": 1,
    ... other VideoObject properties ...
  }, {
    "@type": "VideoObject",
    "position": 2,
    ... other VideoObject properties ...
  }
]
ListItem.url

URL

URL canónica de la página del elemento. Cada elemento debe tener una URL única.

Clip

Para indicarle a Google manualmente la marca de tiempo y la etiqueta que debe usar en la función de momentos clave, anida las siguientes propiedades en el objeto VideoObject. Si bien no son obligatorias las propiedades en el objeto Clip, debes agregar las siguientes propiedades si deseas que Google muestre las marcas de tiempo y las etiquetas que especifiques para tu video, en lugar de los segmentos de video que Google podría mostrar automáticamente para tu video.

La definición completa de Clip está disponible en schema.org/Clip.

Propiedades obligatorias
name

Text

Título descriptivo para el contenido del clip.

startOffset

Number

Hora de inicio del clip expresada como el número de segundos desde el principio del contenido.

url

URL

Una URL que dirige a la hora de inicio del clip.

La URL del clip debe dirigir a la misma ruta de URL que el video con parámetros de consulta adicionales que especifiquen la hora.

Por ejemplo, la siguiente URL significa que el video comienza en el minuto 2:00:


"url": "https://www.example.com/example?t=120"
Propiedades recomendadas
endOffset

Number

Hora de finalización del clip expresada como el número de segundos desde el principio del contenido.

SeekToAction

Para indicarle a Google cómo funciona la estructura de la URL (de modo que pueda mostrar los momentos clave que se identifican automáticamente en tu video), anida las siguientes propiedades en tu VideoObject. Si bien las propiedades de SeekToAction no son obligatorias, debes agregar las siguientes propiedades si deseas que Google comprenda cómo funciona la estructura de la URL, de modo que pueda vincular a los usuarios a un punto dentro del video.

La definición completa de SeekToAction está disponible en schema.org/SeekToAction.

Propiedades obligatorias
potentialAction

SeekToAction

Indica una acción potencial. Incluye las siguientes propiedades anidadas:

Por ejemplo:


{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "potentialAction" : {
    "@type": "SeekToAction",
    "target": "https://video.example.com/watch/videoID?t={seek_to_second_number}",
    "startOffset-input": "required name=seek_to_second_number"
  }
)
potentialAction.startOffset-input

Text

La string del marcador de posición que Google identificará como la estructura de marca de tiempo y, luego, reemplazará por el número de segundos al que se debe ir. Usa el siguiente valor:


"startOffset-input": "required name=seek_to_second_number"
potentialAction.target

EntryPoint

La URL de la página que contiene este VideoObject, incluido un marcador de posición en la estructura de la URL que indica dónde debe insertar Google el número de segundos al que se debe ir en el video. De esta manera, Google interpreta la estructura de la URL y el formato de las marcas de tiempo. Reemplaza la parte de la marca de tiempo de la URL por la siguiente string de marcador de posición:


{seek_to_second_number}

Por ejemplo, reemplaza la parte de la marca de tiempo de la URL:


"target": "https://video.example.com/watch/videoID?t=30"
La marca de tiempo se verá así:

"target": "https://video.example.com/watch/videoID?t={seek_to_second_number}"