Habilita los anuncios que se pueden omitir en las transmisiones de VOD

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

Requisitos previos

Cómo realizar una solicitud de 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 tu 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

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

Parámetros del cuerpo

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

Ejemplo de solicitud (cURL)

Para las solicitudes de transmisión HLS, haz lo siguiente:

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 de las 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 de la estructura 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 la transmisión. 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) Es la posición en la transmisión en la que comienza la pausa, en segundos.
duration (número) Es la duración de la pausa publicitaria, en segundos.
ads (object(Ad)) Es una lista de anuncios en la transmisión.
start (número) Es la posición en la transmisión en la que comienza el anuncio, en segundos.
duration (número) Es la duración del anuncio, en segundos.
skip_metadata (object(SkipMetadata)) Metadatos opcionales para 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 El desplazamiento (número) indica la cantidad de tiempo en segundos dentro del anuncio que el reproductor debe esperar para renderizar el botón de omisión. Se omite si no se proporciona en el VAST.
tracking_url (cadena) 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, envía un 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 de omisión con los siguientes requisitos de diseño. Si no cumples con estos requisitos, es posible que se apliquen restricciones a los anuncios de Google que se publican en tu sitio o aplicación.

Temporiz. de cuenta regresiva

El anuncio no debe poder omitirse hasta el tiempo skipoffset especificado en el VAST. Durante este período, debes mostrarle un aviso al usuario en el que se le informe que el anuncio se puede omitir en X segundos. El aviso debe estar traducido al idioma del usuario.

Posición del botón Omitir

Para un idioma de izquierda a derecha, coloca el botón de omisión en la parte inferior derecha del reproductor de video. Para un idioma de derecha a izquierda, coloca el botón de omisión 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 que se puedan leer con claridad en una experiencia de visualización relajada.

Texto y ícono

El botón para omitir debe tener texto y elementos iconográficos. Puedes usar el ícono de omitir siguiente material como tu iconografía.

Accesibilidad

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

Internacionalización

Se recomienda traducir el texto para omitir al idioma del usuario.

Grupos de anuncios

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

Traducción de "Omitir anuncio"

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