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
- Una aplicación que implementa llamadas a la API de DAI para transmisiones de VOD. Consulta la guía de transmisión de VOD de la API de DAI para obtener más información.
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.
|
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.