Cómo enviar notificaciones de pausas publicitarias anticipadas

La inserción de anuncios dinámicos (DAI) de Google admite transmisiones en vivo con un alto nivel de simultaneidad. Las notificaciones de pausas publicitarias anticipadas (EABN) son solicitudes para que Google DAI programe una próxima pausa publicitaria o inicie de inmediato las decisiones publicitarias, lo que optimiza el porcentaje de anuncios publicados y el tiempo de carga.

Para comenzar a recibir notificaciones de pausas publicitarias anticipadas para el servicio completo, la publicación de grupos o la inserción de anuncios guiada por el servidor, usa el recurso AdBreaks. Con este recurso, puedes crear y administrar pausas publicitarias para todas las transmisiones en vivo que crees a través de la IU de Google Ad Manager o la API de SOAP de Google Ad Manager LiveStreamEventService.

En esta página, se explica cómo programar una pausa publicitaria como una notificación de pausa publicitaria anticipada.

Nota: Si usas la versión anterior de la API de Early Ad Break Notification, actualiza al recurso AdBreaks para obtener paridad y funciones avanzadas, como programar una pausa publicitaria y consultar los estados de las pausas publicitarias.

Requisitos previos

Para crear o administrar las pausas publicitarias, necesitas una clave del activo generada por el sistema de transmisión en vivo o una clave del activo personalizada. También puedes encontrar estas claves en la página de detalles de la transmisión en vivo. Consulta Cómo configurar una transmisión en vivo para la DAI con la IU de Google Ad Manager.

Programa una pausa publicitaria

Puedes programar una pausa publicitaria mientras aumenta la cantidad de usuarios que miran tu transmisión. Para cada evento de transmisión en vivo, programa una pausa publicitaria de forma individual con hasta seis horas de anticipación mediante el método de servicio Create. Incluye la hora de inicio esperada y el ID de la pausa publicitaria. La DAI comienza a tomar decisiones sobre los anuncios cerca de la hora programada. Para tomar decisiones inmediatas sobre las pausas publicitarias, omite la hora de inicio esperada de la pausa.

Para que Google DAI comience a tomar decisiones de anuncios de inmediato, puedes omitir la hora de inicio esperada de la pausa publicitaria cuando llames a Create.

En el siguiente ejemplo, se programa una pausa publicitaria para un evento de transmisión en vivo de tipo Linear que comenzará el 6 de marzo de 2025 a las 4:00 p.m. (hora universal coordinada):

cURL Node.js

curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN' \
  -H 'content-type: application/json' \
  --data-raw '{"adBreakId":"mid-roll-1","assetKey":"ASSET_KEY","duration":"30s","expectedStartTime":"2025-03-06T16:00:00Z"}'

fetch("https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks", {
    "headers": {
      "authorization":
        "Bearer ACCESS_TOKEN",
        "Content-Type": "application/json",
    },
  "body": JSON.stringify({
    "adBreakId": "mid-roll-1",
    "duration": "30s",
    "expectedStartTime": "2025-03-06T16:00:00Z"
  }),
  "method": "POST"
});

Si se ejecuta correctamente, verás la siguiente respuesta JSON:

{
  "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
  "adBreakId": "mid-roll-1",
  "assetKey": "...",
  "expectedStartTime": "2025-03-06T16:00:00Z",
  "duration": "30s",
  "breakState": "SCHEDULED"
}

Sugerencia: Verifica la propiedad DynamicAdInsertionType del evento de transmisión en vivo. Si es POD_SERVING_REDIRECT o POD_SERVING_MANIFEST, te recomendamos que pases un ID de pausa publicitaria personalizado que proporcione tu manipulador de manifiesto de transmisión. De lo contrario, la API generará una cadena de UUID para el ID de la pausa publicitaria.

Para consultar las pausas publicitarias, usa el método List. Para inspeccionar los detalles de una pausa publicitaria, usa el método Get.

En el siguiente ejemplo, se enumeran todas las pausas publicitarias de un evento de transmisión en vivo:

cURL Node.js

curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN'

fetch(
  "https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks",
  {
    "headers": {
      "authorization": "Bearer ACCESS_TOKEN",
    },
    "method": "GET"
  }
);

Si se ejecuta correctamente, verás la siguiente respuesta JSON:

{
  "adBreaks": [
    {
      "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
      "adBreakId": "mid-roll-1",
      "assetKey": "...",
      "expectedStartTime": "2025-03-06T16:00:00Z",
      "duration": "30s",
      "breakState": "DECISIONED",
      "breakSequence": "1"
    }
  ]
}

Si deseas reprogramar la pausa publicitaria actual para que sea más temprano, usa el método Patch para cambiar la hora de inicio esperada. Si deseas cancelar la pausa publicitaria actual, usa el método Delete antes de que su estado sea COMPLETED.

Para crear otra pausa publicitaria, espera hasta que el estado de la pausa publicitaria actual sea COMPLETED.