Obtén información sobre la API de DAI Ad Break

La API de pausas publicitarias de inserción de anuncios dinámicos (DAI) te permite crear y administrar los datos de segmentación de anuncios y el tiempo de las próximas pausas publicitarias en tus transmisiones en vivo.

Con la API de pausas publicitarias de DAI, puedes hacer lo siguiente:

  • Mejora la tasa de relleno de anuncios durante los momentos de mayor tráfico: Brinda más tiempo a los servicios de DAI para seleccionar los anuncios con mayor rendimiento para tus eventos en vivo. Te recomendamos la API de pausas publicitarias de DAI cuando tus eventos de transmisión en vivo tengan una 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 un mayor porcentaje de relleno para la publicación de grupos de anuncios en comparación con la toma de decisiones en tiempo real.
  • Ofrece una experiencia de visualización sin interrupciones: Minimiza los errores de reproducción relacionados con los anuncios, como los grupos de anuncios con exceso o falta de anuncios, proporcionando información precisa sobre las pausas.

En esta guía, se describen los métodos de la API de pausas publicitarias de DAI y se explica el ciclo de vida de las pausas publicitarias para los flujos de servicio completo y de publicación de grupos de anuncios de DAI.

Aprende a usar los métodos de la API de pausas publicitarias de DAI

La API expone los siguientes métodos estándar para administrar recursos AdBreak:

  • Create: Define una entidad AdBreak nueva para una entidad LiveStreamEvent. De manera opcional, establece la propiedad expectedStartTime para programar una decisión de anuncio que comience en un plazo de 60 segundos antes de que empiece la pausa publicitaria.
  • Get: Recupera los detalles de una entidad AdBreak específica, incluidos los metadatos de estado y tiempo de la pausa publicitaria.
  • List: Devuelve una lista de entidades AdBreak creadas con anterioridad con la API para una entidad LiveStreamEvent determinada, ordenadas en orden cronológico inverso. Ten en cuenta que la API no devuelve las pausas publicitarias definidas solo en el manifiesto de transmisión de contenido.
  • Update: Modifica una entidad AdBreak existente antes de que comience la decisión del anuncio.
  • Delete: Cancela la decisión de anuncios para una entidad AdBreak creada 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 de anuncios.
  • 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 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.
  • BREAK_STATE_EXPIRED: La pausa publicitaria venció antes de publicarse. Solo se aplica cuando habilitas la programación de varias pausas en el evento de transmisión en vivo. Para obtener más detalles, consulta Configuración de pausas publicitarias para anuncios durante el video. De forma predeterminada, las pausas publicitarias vencen 30 minutos después del valor del campo expectedStartTime o 30 minutos después de que comienza la toma de decisiones si no estableces el campo expectedStartTime. Puedes personalizar esta duración con el campo expireDuration.

En el siguiente diagrama, se muestra el cronograma de una entidad AdBreak, desde la creación hasta la finalización.

Es la entidad de la pausa publicitaria desde la creación hasta la finalización.

Puedes crear una entidad AdBreak de 1 a 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 prevista, ya que es posible que la DAI de Google no tenga tiempo suficiente para tomar decisiones sobre los anuncios, lo que reducirá la tasa de relleno de anuncios.
  • Evita crear una pausa publicitaria más de 6 horas antes de la hora de inicio prevista, 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 servicio completo de DAI y de publicación de grupos de anuncios.

Comprende el flujo de la DAI de servicio completo

La DAI de servicio completo de Google administra el manifiesto de contenido y los grupos de anuncios.

Para la segmentación de anuncios personalizada, usa la API de pausas publicitarias de DAI para crear una entidad AdBreak antes del marcador de anuncio correspondiente en el manifiesto de transmisión en vivo de contenido.

  • Este plazo de entrega permite que los servicios de DAI de Google usen tus datos de AdBreak para la decisión del anuncio.
  • Cuando la DAI de Google detecta el marcador de anuncio del manifiesto, el sistema usa las decisiones de anuncios con los datos de la entidad AdBreak y cambia el estado de la entidad a BREAK_STATE_COMPLETE.

Cuando habilitas la programación de varias pausas en el evento de transmisión en vivo, puedes establecer el campo matchParams en una entidad AdBreak. Este proceso permite que la DAI de Google haga coincidir los marcadores de anuncios del manifiesto detectados con las pausas publicitarias en el estado BREAK_STATE_SCHEDULED o BREAK_STATE_DECISIONED.

Entidad de pausa publicitaria desde la creación hasta la finalización en el flujo de DAI de servicio completo.

Comprende el flujo de publicación de grupos de anuncios

En este flujo, administras el manifiesto de transmisión en vivo de contenido o usas un servicio de manipulación de manifiestos de terceros para detectar los marcadores de anuncios en el manifiesto.

Llama a la API de pausas publicitarias de DAI antes de la hora de inicio prevista de la pausa publicitaria para crear una entidad AdBreak antes de que necesites solicitar los segmentos del grupo de anuncios o el manifiesto de anuncios.

Cuando tu Video Stitcher detecta el marcador de anuncios del manifiesto y realiza solicitudes de segmentos de anuncios con un ID de pausa publicitaria, la DAI de Google usa los datos de AdBreak con el mismo ID para tomar decisiones sobre los anuncios.

Después de que tu cliente solicite contenido multimedia de anuncios, la entidad AdBreak que creaste a través de la API pasará al estado BREAK_STATE_COMPLETE.

Es el estado de finalización de la entidad de pausa publicitaria.

Realiza tu primera solicitud

Para configurar el acceso a la API y realizar tu primera solicitud, consulta Usa la API de pausas publicitarias de DAI.