Anuncios que se pueden omitir de transmisión de VOD

En esta guía, se muestra cómo utilizar la API de DAI para solicitar una transmisión de VOD con anuncios que se pueden omitir, renderizar el botón de omisión de acuerdo con los requisitos de Google Ads y enviar los eventos de seguimiento asociados.

Requisitos previos

Cómo solicitar anuncios que se pueden omitir

Para solicitar una transmisión de VOD con anuncios que se pueden omitir, debes pasar el parámetro dai-sas en la solicitud de transmisión.

Extremo de API

POST: /ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Host: dai.google.com
Content-Type: application/x-www-form-urlencoded

Parámetros de ruta de acceso

{CMS_ID} El ID de CMS de la transmisión
{VIDEO_ID} El ID de video de la transmisión.

Parámetros corporales

dai-sas Configura dai-sas=1 para habilitar los anuncios que se pueden omitir.

Solicitud de ejemplo (cURL)

Para solicitudes de transmisión HLS:

curl -X POST \
     -d 'dai-sas=1' \
     -H 'Content-Type: application/x-www-form-urlencoded' \
https://dai.google.com/ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream

Sustituye 'dash' en la URL por transmisiones DASH:

https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream

Usa el siguiente formato para incluir varios parámetros de transmisión en el cuerpo de la solicitud:

-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \

Controla la omisión de anuncios

Para controlar la omisión de anuncios, usa la información del struct Ad o AdBreak, según si omites el anuncio actual o toda la pausa publicitaria. Toma el valor start y agrega el valor duration. Luego, busca ese punto en el flujo. El submensaje SkipMetadata también incluye el valor offset, que es un valor en segundos del tiempo antes de que se pueda omitir el anuncio. El submensaje SkipMetadata solo se incluirá en los anuncios que se pueden omitir.

ad_breaks Una lista de pausas publicitarias.
start (número) Posición en la transmisión en la que comienza la pausa, en segundos.
duration (number) Es la duración de la pausa publicitaria en segundos.
ads (object(Ad)) Es una lista de anuncios del flujo.
start (número) Posición en la transmisión en la que comienza el anuncio, en segundos.
duration (number) Duración del anuncio en segundos.
skip_metadata (object(SkipMetadata)): Metadatos opcionales para los anuncios que se pueden omitir. Si se establece, indica que el anuncio se puede omitir y, además, incluye instrucciones para controlar la IU de omisión y el evento de seguimiento.
offset (número) El desplazamiento indica la cantidad de tiempo en segundos que el reproductor debe esperar para renderizar el botón de omisión. Se omite si no se proporciona en la plantilla VAST.
tracking_url (string) Es una URL a la que se debe hacer ping en el evento de omisión.

Ejemplo de respuesta

{
  ...
  "ad_breaks":[
    {
      ...
      "start":0,
      "duration":10,
      "ads":[
        {
          ...
          "start":0,
          "duration":10,
          "skip_metadata":{
            "offset": 5,
            "tracking_url": "https://example_skip_url.com"
          }
        }
    }
}

Una vez que se omita el anuncio, haga ping a la URL del evento de omisión incluida en la respuesta de la transmisión. Se incluye en el submensaje SkipMetadata.

Requisitos del botón Omitir

En el caso de los anuncios que se pueden omitir, renderiza el botón Omitir con los siguientes requisitos de diseño. El incumplimiento de estos requisitos puede ocasionar que se apliquen restricciones en los anuncios de Google que se publican en tu sitio o app.

Temporiz. de cuenta regresiva

El anuncio no debe poder omitirse hasta el tiempo skipoffset especificado en la VAST. Durante este período que no se puede omitir, debes mostrar un aviso al usuario para informarle que el anuncio se puede omitir en X segundos. La notificación debe estar traducida al idioma del usuario.

Posición del botón Omitir

Si se trata de un idioma de izquierda a derecha, coloca el botón Omitir en la parte inferior derecha del reproductor de video. En el caso de un idioma que se escriba de derecha a izquierda, coloca el botón Omitir en la parte inferior izquierda del reproductor de video.

Tamaño del botón Omitir

El botón y el texto deben ser lo suficientemente grandes para ser claramente legibles en una experiencia relajada.

Ícono y texto

El botón Omitir debe tener tanto texto como iconografía. Puedes usar el ícono de omitir el siguiente material como tu iconografía.

Accesibilidad

El usuario debe poder navegar al botón Omitir con un teclado o un control remoto. La app debería enfocar el botón de omisión una vez que finalice la cuenta regresiva.

Internacionalización

Se recomienda traducir el texto de omisión al idioma del usuario.

Grupos de anuncios

El botón Omitir se puede usar para omitir el anuncio actual en el grupo de anuncios, o bien todo el grupo.

Traducciones del tipo "Omitir anuncio"

Usa el archivo skipAdTranslations.json para traducir el texto "Omitir anuncio" según la configuración regional del usuario.