Anuncios que se pueden omitir de transmisión 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, renderiza el botón Omitir de acuerdo con Requisitos de Google Ads, y envíe 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 dai-sas parámetro 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 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 cuerpo:

-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 Ad struct o AdBreak struct en función de 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 SkipMetadata el submensaje también incluye el valor offset, que es un valor en segundos de 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 que se pueden omitir anuncios. Si se establece, indica que el anuncio se puede omitir y, además, incluye Instrucciones sobre cómo controlar la IU de omisión y el evento de seguimiento
offset (número) El desplazamiento indica la cantidad de tiempo en segundos después de que transcurra el anuncio, el reproductor debe esperar para renderizar el botón Omitir. Se omite si no se proporciona en la plantilla VAST.
tracking_url (string) Una URL a la que se debe hacer ping en la omisión para cada evento.

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

Para los anuncios que se pueden omitir, renderiza el botón Omitir con el siguiente diseño y los requisitos de cumplimiento. El incumplimiento de estos requisitos puede generar restricciones colocarse en los anuncios de Google que se publican en su sitio o aplicación.

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 al usuario un aviso en el que se le informe al que el anuncio se puede omitir en X segundos. El aviso debe traducirse a el idioma del usuario.

Posición del botón Omitir

Para un idioma que se escribe de izquierda a derecha, coloca el botón Omitir en la parte inferior derecha de el reproductor de video. Si se trata de un idioma que se escribe de derecha a izquierda, coloca el botón Omitir en el 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 como para poder leerse claramente en un espacio de visualización pasiva una experiencia fluida a los desarrolladores.

Ícono y texto

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

Accesibilidad

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

Internacionalización

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

Grupos de anuncios

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

"Omitir anuncio" traducciones

Usa el archivo skipAdTranslations.json para traducir el campo 'Omitir anuncio' texto basado en la configuración regional del usuario.