En esta guía, se describe la función de metadatos de anuncios compatibles de la API de Video Stitcher. Los metadatos de los anuncios se extraen de un anuncio VAST en una respuesta de etiqueta de anuncio, que contiene eventos de seguimiento de anuncios y anuncios complementarios. La URL de la etiqueta de anuncio se configura en la solicitud de creación de sesión. Para obtener más información, consulta Administra una sesión en vivo y Administra una sesión de VOD.
Antes de comenzar
Asegúrate de conocer los conceptos introductorios y la terminología de la API de Video Stitcher. Para obtener más información, consulta la descripción general técnica.
Introducción
Los metadatos de los anuncios contienen eventos de seguimiento de anuncios y anuncios complementarios asociados con un anuncio compuesto. Un evento de seguimiento de anuncios contiene un ping de devolución de llamada que se usa para hacer un seguimiento del anuncio VAST y la interacción del usuario. Un anuncio complementario es un anuncio que complementa el anuncio principal de VAST. En el modo de seguimiento del cliente, eres responsable de activar eventos en función del comportamiento del usuario.
Seguimiento de anuncios del servidor
En el modo de seguimiento del servidor, cada URI de segmento de anuncio se une a un URI de redireccionamiento, y la API de Video Stitcher controlará el procesamiento de los eventos de progreso cada vez que el reproductor solicite esos segmentos. Sin embargo, la API de Video Stitcher no controla los eventos de actividad, como pause.
Seguimiento de anuncios del cliente
En el modo de seguimiento del cliente, el cliente es responsable de activar los eventos. Para obtener más detalles, consulta la documentación de eventos.
Los eventos de progreso son eventos que deben activarse cuando transcurre el tiempo especificado durante el anuncio. Por ejemplo, el evento Start debe activarse al comienzo del anuncio. Para obtener más detalles sobre los eventos de progreso, consulta el objeto de evento de progreso.
Los eventos de actividad son aquellos que deben activarse cuando un usuario realiza una actividad
específica. Por ejemplo, el evento pause debe activarse cuando el usuario pausa el video del anuncio. Para obtener más detalles sobre los eventos de actividad, consulta el
objeto de evento de actividad.
Seguimiento de anuncios del cliente de VOD
Se muestra un objeto de anuncios intersticiales en la respuesta de una solicitud de creación de sesión de VOD. Para obtener instrucciones sobre cómo crear una sesión de VOD, consulta Cómo crear una sesión de VOD.
Los anuncios intersticiales contienen los metadatos de cada anuncio insertado. Cuando se habilita el modo de seguimiento de anuncios del cliente, este es responsable de activar los eventos de seguimiento cuando sea necesario. Para obtener más detalles, consulta el objeto de anuncios intersticiales.
Seguimiento de anuncios del cliente en vivo
La API de Video Stitcher inserta anuncios de forma continua en una transmisión en vivo. La información de los metadatos del anuncio se genera cada vez que se inserta un anuncio nuevo.
En el caso de HLS, el AdMetadataURI para recuperar los metadatos de los anuncios se puede encontrar en la etiqueta #EXT-X-DATERANGE.
En el caso de DASH, el AdMetadataURI para recuperar los metadatos de los anuncios se puede encontrar en el elemento <EventStream> de cada elemento <Period>.
Para obtener más detalles, consulta cómo controlar el seguimiento del cliente en vivo.
Anuncios complementarios
Los anuncios complementarios son anuncios complementarios que pueden aparecer junto con los anuncios lineales insertados. Para obtener más información, consulta el objeto de anuncios complementarios.
¿Qué sigue?
- Aprende a completar las tareas de la API de Video Stitcher específicas.