En esta guía se describe la función de metadatos de anuncios admitida de la API 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 la sesión. Para obtener más información, consulta los artículos Gestionar una sesión en directo y Gestionar una sesión de vídeo bajo demanda.
Antes de empezar
Familiarízate con los conceptos y la terminología introductorios de la API Video Stitcher. Para obtener más información, consulta el resumen técnico.
Introducción
Los metadatos de los anuncios contienen eventos de seguimiento de anuncios y anuncios complementarios asociados a un anuncio combinado. Un evento de seguimiento de anuncios contiene un ping de retrollamada que se usa para hacer un seguimiento del anuncio VAST y de la interacción del usuario. Un anuncio complementario es un anuncio que complementa al anuncio de VAST principal. En el modo de seguimiento del lado del cliente, usted es el responsable de activar eventos en función del comportamiento del usuario.
Seguimiento de anuncios del lado del servidor
En el modo de seguimiento del lado del servidor, cada URI de segmento de anuncio se envuelve en un URI de redirección y la API Video Stitcher gestionará el procesamiento de los eventos de progreso cada vez que el reproductor solicite esos segmentos. Sin embargo, la API Video Stitcher no gestiona los eventos de actividad, como pause.
Seguimiento de anuncios del lado del cliente
En el modo de seguimiento del lado del cliente, el cliente es el responsable de activar los eventos. Para obtener más información, consulta la documentación de eventos.
Los eventos de progreso son eventos que deben activarse cuando haya transcurrido el tiempo especificado durante el anuncio. Por ejemplo, el evento Start debe activarse al principio del anuncio. Para obtener más información sobre los eventos de progreso, consulta el objeto de evento de progreso.
Los eventos de actividad son eventos que deben activarse cuando un usuario realiza una actividad específica. Por ejemplo, el evento pause debe activarse cuando el usuario pausa el vídeo del anuncio. Para obtener más información sobre los eventos de actividad, consulta el objeto de evento de actividad.
Seguimiento de anuncios del lado del cliente en VOD
Un objeto interstitials se devuelve 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.
Interstitials contiene los metadatos de cada anuncio insertado. Cuando el modo de seguimiento de anuncios del cliente está habilitado, el cliente es responsable de activar los eventos de seguimiento cuando sea necesario. Para obtener más información, consulta el objeto de intersticiales.
Seguimiento de anuncios del cliente en directo
La API Video Stitcher inserta anuncios continuamente en una emisión en directo. La información de los metadatos de los anuncios se genera cada vez que se inserta un anuncio nuevo.
En el caso de HLS, la AdMetadataURI para obtener los metadatos de los anuncios se encuentra en la etiqueta #EXT-X-DATERANGE.
En DASH, el AdMetadataURI para obtener los metadatos de los anuncios se encuentra en el elemento <EventStream> de cada elemento <Period>.
Para obtener más información, consulta cómo gestionar el seguimiento del lado del cliente en tiempo real.
Anuncios complementarios
Los anuncios complementarios son anuncios adicionales que pueden aparecer junto con anuncios lineales insertados. Para obtener más información, consulta el objeto companionAds.
Siguientes pasos
- Consulta cómo completar tareas específicas de la API Video Stitcher.