La API de Ad Break de Inserción de Anuncios Dinámicos (DAI) te permite crear y administrar los datos de segmentación de anuncios y la sincronización de las próximas pausas publicitarias en tus transmisiones en vivo.
Con la API de DAI Ad Break, puedes hacer lo siguiente:
- Mejora el porcentaje de relleno de anuncios durante los períodos de mayor tráfico: Brinda a los servicios de inserción de anuncios dinámicos (DAI) más tiempo para seleccionar los anuncios con el mayor rendimiento para tus eventos en vivo. Te recomendamos que uses la API de Ad Break de DAI cuando tus eventos de transmisión en vivo tengan alta simultaneidad, etiquetas de anuncios dinámicas o anuncios de alta latencia.
- Toma el control total de tus pausas publicitarias: Crea, actualiza y borra pausas publicitarias con anticipación, lo que ofrece más flexibilidad que la señalización de anuncios en el manifiesto y una mayor tasa de relleno para la publicación de pods en comparación con la toma de decisiones justo a tiempo.
- Ofrece una experiencia ininterrumpida para los usuarios: Minimiza los errores de reproducción relacionados con los anuncios, como los pods de anuncios con relleno insuficiente o excesivo, proporcionando información precisa sobre las pausas.
En esta guía, se describen los métodos de la API de DAI Ad Break y se explica el ciclo de vida de las pausas publicitarias para los flujos de DAI Full Service y Pod Serving.
Aprende sobre los métodos de la API de Ad Break de DAI
La API expone los siguientes métodos estándar para administrar recursos AdBreak:
Create: Define una nueva entidadAdBreakpara una entidadLiveStreamEvent. De manera opcional, establece la propiedadexpectedStartTimepara programar una decisión sobre el anuncio que comience 60 segundos antes de que comience la pausa publicitaria.Get: Recupera los detalles de una entidadAdBreakespecífica, incluidos los metadatos de estado y sincronización de la pausa publicitaria.List: Devuelve una lista de entidadesAdBreakcreadas anteriormente con la API para una entidadLiveStreamEventdeterminada, ordenadas en orden cronológico inverso. Ten en cuenta que la API no devuelve las pausas publicitarias definidas solo en el manifiesto de la transmisión de contenido.Update: Modifica una entidadAdBreakexistente antes de que comience la decisión del anuncio.Delete: Cancela la decisión del anuncio para una entidadAdBreakcreada anteriormente.
Comprende el ciclo de vida de las pausas publicitarias
Una entidad AdBreak tiene los siguientes estados:
BREAK_STATE_UNSPECIFIED: Es el estado predeterminado.BREAK_STATE_SCHEDULED: La pausa publicitaria se creó correctamente y se programó para la decisión del anuncio.BREAK_STATE_DECISIONED: Los servicios de DAI iniciaron el proceso de selección de anuncios para la pausa publicitaria. No puedes modificar la pausa publicitaria, pero sí puedes cancelarla, lo que podría tener efectos adversos en los servidores de anuncios.
BREAK_STATE_COMPLETE: Se publicó la pausa publicitaria para los usuarios.
En el siguiente diagrama, se muestra la línea de tiempo de una entidad AdBreak, desde su creación hasta su finalización.
Puedes crear una entidad AdBreak entre 1 y 300 minutos antes de que se espere que comience la pausa publicitaria.
- Evita crear una pausa publicitaria menos de un minuto antes de la hora de inicio esperada de la pausa, ya que es posible que la DAI de Google no tenga tiempo suficiente para tomar decisiones sobre los anuncios, lo que generará un menor porcentaje de relleno de anuncios.
- Evita crear una pausa publicitaria más de 6 horas antes de la hora de inicio esperada de la pausa, ya que los servidores de anuncios podrían invalidar los anuncios solicitados.
En las siguientes secciones, se describen las transiciones de estado de las pausas publicitarias en los flujos de DAI Full Service y Pod Serving.
Información sobre el flujo de DAI de servicio completo
La DAI de servicio completo de Google administra tanto el manifiesto de contenido como los grupos de anuncios.
Para la segmentación de anuncios personalizada, usa la API de DAI Ad Break para crear una entidad AdBreak antes del marcador de anuncio correspondiente en el manifiesto de la transmisión en vivo del contenido.
- Este plazo de entrega permite que los servicios de la DAI de Google usen tus datos de
AdBreakpara la decisión del anuncio. - Cuando la DAI de Google detecta el marcador de anuncio del manifiesto, el sistema usa decisiones de anuncios con los datos de la entidad
AdBreaky hace que el estado de la entidad cambie aBREAK_STATE_COMPLETE.
Información sobre el flujo de publicación de Pods
En este flujo, administras el manifiesto de la transmisión en vivo de contenido o usas un servicio externo de manipulación de manifiestos para detectar los marcadores de anuncios en el manifiesto.
Llama a la API de DAI Ad Break antes de la hora de inicio esperada de la pausa publicitaria para crear una entidad AdBreak antes de que necesites solicitar los segmentos del pod de anuncios o el manifiesto del anuncio.
Cuando el concatenador de videos detecta el marcador de anuncio del manifiesto y realiza solicitudes de segmentos de anuncios con un ID de corte publicitario, la DAI de Google utiliza los datos de AdBreak con el mismo ID para tomar decisiones sobre los anuncios.
Después de que tu cliente solicite medios publicitarios, la entidad AdBreak que creaste a través de la API pasará al estado BREAK_STATE_COMPLETE.
Realiza tu primera solicitud
Para configurar el acceso a la API y realizar tu primera solicitud, consulta Cómo usar la API de Ad Break de DAI.