Códigos de error comunes de VAST y cómo resolverlos
Publicado: 2022-09-04La mayoría de los anuncios de video en Internet deben cumplir con las especificaciones descritas por el estándar de plantilla de publicación de anuncios de video (VAST) para garantizar la funcionalidad y la compatibilidad con los reproductores de video. Uno de los problemas más comunes que encuentran los editores que producen publicidad en video a través de las plataformas de Google, como YouTube y Google AdSense, son los códigos de error de VAST.
Aprenda qué son los códigos de error de VAST, qué códigos de error son los más comunes y cómo resolverlos.
¿Qué es un error VAST?
Un código de error de plantilla de servicio de anuncios de video es uno de los muchos estados de error posibles definidos por la Oficina de publicidad interactiva (IAB) . Un error de VAST indica un problema entre el servidor que aloja el contenido del anuncio y el reproductor de video del consumidor objetivo, lo que puede dificultar o impedir la visualización adecuada del anuncio .
La naturaleza exacta del error depende del código mostrado; cada código corresponde a un problema identificado.
Desafíos comunes para mostrar anuncios VAST en tecnología publicitaria
Aunque la visualización de anuncios VAST tiende a ser más sencilla de implementar y más rentable a largo plazo que las soluciones alternativas como la definición de interfaz de anuncio de reproductor de video (VPAID), el principal desafío para los editores es garantizar la visibilidad de los anuncios .
Muchos tipos de problemas técnicos interrumpen con frecuencia la visibilidad y la funcionalidad de los anuncios de VAST. En muchos casos, las interrupciones ocurren debido a ajustes de configuración incorrectos , ya sea por parte del comprador o del editor. Estas interrupciones se manifiestan en forma de códigos de error VAST .
Los códigos de error de VAST se clasifican en dos niveles de gravedad: errores fatales y potencialmente no fatales .
Códigos de error fatal VAST comunes y cómo resolverlos
Un código de error fatal de VAST es el más grave porque es más probable que haya detenido la solicitud de anuncio , lo que provocó una interrupción de la visualización. Algunos errores fatales comunes de VAST incluyen:
Error 100 de VAST: error de análisis de XML
VAST Error 100 es uno de los errores fatales más comunes. Las posibles causas detrás del error 100 de VAST incluyen una respuesta del comprador mal formada o un documento XML no válido, dañado o con formato incorrecto . Otra posibilidad es un problema de redirección de URL de VAST, por ejemplo, cuando la redirección no se resuelve correctamente.
Los editores que noten un código de error 100 deben alertar al comprador . A su vez, los compradores deben verificar que la URL de VAST esté configurada correctamente y luego asegurarse de que todos los documentos XML de VAST funcionen y tengan el formato correcto con los atributos adecuados.
Error 101 de VAST: error de validación de esquema
Por lo general, se produce un error de validación de esquema cuando a la respuesta del comprador le faltan los elementos o atributos XML requeridos o contiene elementos no reconocidos.
La mejor forma de solucionar un código de error 101 es que el comprador consulte la documentación de la IAB , verifique las especificaciones XML de VAST y se asegure de que todos los elementos requeridos y con el formato correcto estén presentes .
Error 102 de VAST: Versión de respuesta no admitida
Este código de error que ocurre con frecuencia se activa cuando un reproductor de video de destino no es compatible con la versión VAST de la solicitud de oferta. Esto también puede suceder si el intercambio envió la versión incorrecta de VAST .
En raras ocasiones, es posible que el anuncio de VAST no especifique un número de versión. En ese caso, también puede considerarse un error de validación de esquema .
Para corregir el error 102, el comprador debe asegurarse de que las respuestas solo incluyan versiones de VAST compatibles .
VAST Error 300: Error de envoltorio
El error 300 de VAST es un error de contenedor general. Se activa cuando se alcanza el límite del contenedor .
Este código de error no es accionable; no hay métodos de resolución . Sin embargo, existen algunos pasos correctivos que potencialmente pueden evitar que se muestre un Error 300, como revisar periódicamente los URI de VAST y asegurarse de que ninguno de ellos esté agotando el tiempo de espera.
Error 301 de VAST: se alcanzó el tiempo de espera de redirección
El IAB definió inicialmente el código de error 301 para indicar un URI de VAST defectuoso, que no responde o que agotó el tiempo de espera. Sin embargo, los especialistas en tecnología publicitaria suelen asociar los errores 301 con una alta latencia (conocido coloquialmente como "retraso") y conexiones a Internet deficientes o inestables .
Las posibles causas directas de un error 301 incluyen:
- La configuración de tiempo de espera del reproductor es demasiado baja (la configuración predeterminada es 5)
- Dimensión de creatividad incorrecta (tamaño de anuncio)
- URI no válido
- Tiempo de espera de VAST URI
- Alta latencia
- HTTP a HTTPS
- Sitio web mal optimizado
Error 302 de VAST: se alcanzó el límite del envoltorio
El reproductor de video que recibe un anuncio generalmente está configurado con su propio límite de envoltorio predefinido. Alcanzar este límite es la causa más común de un código de error 302.
Los errores 302 generalmente ocurren debido a una cantidad excesiva de respuestas de contenedor recibidas sin una respuesta en línea. La acción correctiva es que el editor aumente el límite de envoltorio del reproductor de video .
En raras ocasiones, los errores 302 ocurren debido a la conexión en cadena: un bucle o una cantidad excesiva de redireccionamientos de VAST antes de devolver un archivo multimedia, lo que hace que el reproductor de video cancele la solicitud de anuncio. En ese caso, el comprador debe asegurarse de que ningún redireccionamiento de VAST apunte a otro redireccionamiento.
Error 303 de VAST: se devolvió una respuesta de VAST vacía
El código de error 303 indica una respuesta de VAST vacía, generalmente debido a una solicitud de anuncio contenida dentro de un contenedor de terceros .
Los compradores y editores que trabajan con redes de terceros deben comprobar la tasa de relleno , que suele ser inferior al 100 %. Por ejemplo, una tasa de relleno del 86 % significa que hay un 14 % de posibilidades de que se produzca este error.
Para resolver un error VAST 303, los editores deben habilitar la función de respaldo en Google Ad Manager . Sigue estos pasos:
- Inicie sesión en su cuenta de Google Ad Manager y abra el panel.
- Haga clic en el botón Administrador en el panel de la izquierda, vaya a Video y luego a Configuración de video.
- Habilite Video Fallback, luego haga clic en Guardar.
VAST Error 400: Error lineal general
Un error 404 de VAST suele deberse a que un reproductor de video no puede mostrar un anuncio lineal .
Las causas más comunes por las que no se muestran anuncios lineales incluyen:
- El navegador web restringe la reproducción automática (autoplay) con sonido
- El formato de MediaFile no es válido (p. ej., no es un archivo de video válido o el formato se especificó incorrectamente)
- Fuente desconocida o no especificada
Los editores que noten un error 400 deben buscar problemas con el reproductor de video y configurar el reproductor para detectar navegadores con reproducción automática restringida . Si estas medidas no solucionan el problema, los compradores deben comprobar la respuesta de VAST y asegurarse de que devuelve una creatividad válida .
Error 401 de VAST: archivo multimedia no encontrado
Si ve un Código de error 401, indica que el URI de MediaFile no devuelve una creatividad de video válida o no puede encontrar un archivo de video válido.
Los editores que encuentren este código de error deben alertar a los compradores lo antes posible y los compradores deben asegurarse de que todos sus URI de MediaFile devuelvan una creatividad de video válida.
Error 402 de VAST: no se puede descargar o se agotó el tiempo de espera del URI de MediaFile
Un error VAST 402 puede tener varias causas posibles. Los siguientes cuatro problemas son los más probables:
- El valor (en milisegundos) de la variable loadVideoTimeout en el SDK de IMA del archivo es demasiado bajo. Si el tiempo de carga de la página supera este valor, se cancelará la reproducción del anuncio, lo que podría generar un error.
- Bajo rendimiento u optimización del sitio web, lo que provoca suficientes retrasos en el tiempo de carga para cancelar la reproducción de anuncios
- El archivo de video se reproduce automáticamente o se intentó reproducir automáticamente en un entorno móvil en el que no se pretende que se comporte de esta manera (la mayoría de los anuncios de video en dispositivos móviles deben reproducirse con un clic, excepto en instancias seleccionadas)
- En los navegadores Google Chrome, mostrar un anuncio de video en un entorno de reproducción automática a pesar de que la ventana no está enfocada (por ejemplo, ventana minimizada, pestaña diferente seleccionada u otro programa en otra pantalla actualmente activo)
Aunque no todas estas causas tienen soluciones correspondientes, la solución recomendada para los editores es inspeccionar el límite de tiempo de espera del reproductor de video y establecer la variable loadVideoTimeout en un valor más alto. El valor predeterminado es -1, correspondiente a 8 segundos (8000 ms).
Otras posibles soluciones incluyen la optimización del sitio web para lograr velocidades de carga más rápidas o el ajuste de la tasa de bits del video para un mejor rendimiento de la publicación de anuncios en dispositivos móviles.
Error 403 de VAST: respuesta declarada tipos MIME no admitidos para todos los archivos multimedia
Este código de error se encuentra entre los más frecuentes y es más común en dispositivos móviles.
El código de error 403 indica que una respuesta de VAST ha declarado uno o varios tipos de extensiones multipropósito de correo de Internet (MIME) no compatibles para todos los archivos multimedia disponibles (por ejemplo, al intentar reproducir contenido Flash en un dispositivo móvil). Este código de error también puede aparecer cuando se ha intentado reproducir el tipo de creatividad incorrecto .
Al experimentar este código de error, los editores deben asegurarse de que el formato de archivo y la tecnología de los anuncios sean compatibles con el dispositivo y el sistema operativo del reproductor. Los compradores también deben verificar que todas las creatividades devueltas respeten los formatos de video de la solicitud de oferta (por ejemplo, las aplicaciones móviles no deben solicitar creatividades VPAID).
Error 405 de VAST: error de visualización de archivo multimedia
Por lo general, se produce un error de visualización de MediaFile (VAST 405) debido a una creatividad defectuosa . Los tipos de fallas comunes incluyen:
- El tipo MIME y el tipo de archivo de video no coinciden
- Configuración incorrecta de uso compartido de recursos de origen cruzado (CORS) en la CDN creativa
- Problema de transcodificación
Para solucionar este problema, los compradores deben verificar que todos los tipos MIME creativos y las opciones de configuración de CDN sean precisos .
Error 406 de VAST: falta el archivo intermedio requerido
La causa más común de un código de error 406 es una respuesta VAST devuelta sin un archivo mezzanine requerido . Un archivo mezzanine es un archivo de video de alta resolución y alta calidad, a menudo sin formato (sin comprimir) o comprimido para que no se distinga del archivo sin formato.
Los archivos intermedios suelen ser necesarios en entornos que dependen de implementaciones de anuncios del lado del servidor . Estos archivos se emplean para generar archivos de video de calidad adecuada para la plataforma de destino, como para entornos móviles o para realizar la unión de anuncios.
Los compradores que vean un código de error 406 deben asegurarse de que se incluya un archivo mezzanine adecuado en la respuesta de VAST .
Error 407 de VAST: archivo intermedio descargado por primera vez
El código de error 407 indica que el archivo intermedio se está descargando y transcodificando por primera vez , lo que provoca un error al publicar un anuncio. Este código de error es esperado y no procesable; la única acción correctiva es esperar a que se complete el proceso de transcodificación .
Según el tamaño del archivo intermedio, este proceso puede tardar varias horas.
Error 408 de VAST: anuncio rechazado en la respuesta de VAST
Si ve el código de error de VAST 408, indica que el archivo de anuncios devuelto en la respuesta de VAST ha sido rechazado .
Los editores deben alertar a los compradores sobre los errores 408 lo antes posible y los compradores deben asegurarse de que las respuestas de VAST solo contengan creatividades aprobadas . Las entidades que actúan como anfitriones creativos de anuncios (por ejemplo, la agencia de publicidad o publicación) también deben estar al tanto de cualquier rechazo de anuncios para tomar las medidas adecuadas.
Error 409 de VAST: la creatividad interactiva definida en el nodo InteractiveCreativeFile no se ejecutó
La causa más probable de un error 409 de VAST es que no se reproduzca la creatividad definida por el nodo Los compradores deben asegurarse de que todas las creatividades interactivas (p. ej., una demostración jugable para un juego móvil) que se devuelvan en la respuesta de VAST se reproduzcan correctamente cuando se soliciten.
Error 410 de VAST: el código al que se hace referencia en el nodo de verificación no se ejecutó
Los errores VAST 410 generalmente ocurren debido a una falla al ejecutar el código definido en el nodo Los compradores deben asegurarse de que el código de Verificación de anuncios funcione y esté correctamente implementado.
Error 500 de VAST: error general de anuncios no lineales
Si se devuelve este código de error, generalmente indica que el reproductor de video no pudo mostrar un anuncio no lineal por razones desconocidas .
Los editores pueden intentar remediar el código de error verificando los problemas del reproductor de video , y los compradores deben verificar todas las respuestas de VAST para asegurarse de que devuelvan creatividades válidas.
Error 501 de VAST: las dimensiones de la creatividad del anuncio no lineal no se alinean con el área de visualización de la creatividad
Un error VAST 501 suele ser el resultado de un error al reproducir un anuncio no lineal debido a una discrepancia entre las dimensiones de la creatividad (tamaño del anuncio) y el área de visualización de la creatividad (espacio de pantalla). Específicamente, los errores 501 ocurren cuando las dimensiones de la creatividad son demasiado grandes para el área de visualización (en otras palabras, el anuncio es demasiado grande para la pantalla).
En casos más raros, un CSS configurado incorrectamente puede desencadenar un error 501, como estilos CSS que corrigen la altura y el ancho del elemento de contenido de video.
Los editores pueden corregir este código de error cambiando la altura y el ancho establecidos de la creatividad para que coincidan con el área de visualización. Si el editor ha establecido el tamaño del elemento de contenido de video usando estilos CSS, la acción recomendada es usar atributos HTML en su lugar.
Error 502 de VAST: no se pueden obtener anuncios no lineales/recurso no lineal
La causa más común de un código VAST 502 es la respuesta de un comprador que devuelve un anuncio no lineal que no pudo devolver una creatividad válida . Los compradores deben asegurarse de que todas las respuestas de anuncios no lineales devuelvan creatividades válidas.
Error 503 de VAST: no se pudo encontrar un recurso no lineal con el tipo admitido
Los editores que solicitan un tamaño de creatividad mayor que las dimensiones del reproductor de video pueden encontrar un código de error 503. Un tipo de medio no válido puede generar este código de error en casos más raros.
La acción correctiva recomendada es que el editor se asegure de que todos los tamaños de creatividades y tipos de medios solicitados sean compatibles con el reproductor de video.
Error 901 de VAST: error general de VPAID
Un error 901 es un código de error fatal genérico que puede causar cualquier error de VPAID. Las posibles causas incluyen:
- Se agotó el tiempo de espera del envoltorio VPAID de SSP
- El envoltorio VPAID de SSP no compra
- Las creatividades VPAID requieren un modo inseguro
- Uso de una etiqueta "Adaptador de IMA" con el SDK de IMA (la etiqueta VAST correcta que se debe usar es "SDK directo")
Los editores deben asegurarse de que todas las solicitudes de VPAID sean compatibles con los dispositivos y reproductores de video de destino. La función de perfil de creatividades de video de Google puede ayudarlo a administrar sus creatividades y evitar este código de error.
Los compradores pueden examinar las respuestas de VAST que devuelven envoltorios HTML5 VPAID y asegurarse de que incluyan un recurso MP4 y no cancelen la reproducción.
Códigos de error VAST comunes potencialmente no fatales y cómo resolverlos
Un error no fatal indica un problema que puede no haber impedido que se muestre el anuncio. Sin embargo, abordar la causa del error lo antes posible es fundamental para garantizar un rendimiento óptimo y evitar errores más graves. Estos son algunos errores comunes de VAST no fatales:
Error 200 de VAST: el reproductor de video esperaba un tipo de anuncio diferente
Un error VAST 200 generalmente ocurre cuando el reproductor de video no admite o no espera el tipo de anuncio solicitado en una solicitud de oferta.
Un ejemplo de un tipo de anuncio no admitido son los anuncios saltables enviados a reproductores que solo admiten anuncios lineales.
Los editores pueden solucionar este código de error comprobando los errores de tráfico . Si el editor no puede resolver el problema, el comprador debe asegurarse de que las respuestas de VAST solo envíen tipos de anuncios específicos .
Error 201 de VAST: el reproductor de video esperaba una linealidad diferente
Este código de error generalmente se debe a una discrepancia de linealidad entre la solicitud del reproductor de video y la respuesta del comprador . Un ejemplo de discrepancia de linealidad es una respuesta de VAST que envía un anuncio no lineal cuando la solicitud especifica un anuncio lineal.
Los editores deben asegurarse de que las solicitudes de anuncios especifiquen la linealidad correcta y los compradores deben verificar que las respuestas de VAST solo incluyan la linealidad especificada en la solicitud de anuncios.
Error 202 de VAST: el reproductor de video esperaba una duración diferente
El código de error de VAST 202 se produce cuando la respuesta devuelve una creatividad con una duración diferente a la especificada . Por ejemplo, si la duración especificada es de 30 segundos, pero la duración real de MediaFile es de 45 segundos, puede generar un error 202.
Los editores deben configurar correctamente la duración de la creatividad en Google Ad Manager y los compradores deben asegurarse de que la respuesta respete la duración máxima especificada de la solicitud.
Error 203 de VAST: el reproductor de video esperaba un tamaño diferente
Este código de error suele deberse a una incompatibilidad entre los MediaFiles devueltos y el dispositivo de destino . Por ejemplo, enviar una creatividad con una tasa de bits alta a dispositivos móviles, aunque estos dispositivos sean más adecuados para tasas de bits más bajas.
Los compradores pueden solucionar un error 203 asegurándose de que todas las respuestas de VAST incluyan MediaFiles compatibles con varios tipos de dispositivos y tecnologías , incluida la compatibilidad con la tasa de bits.
VAST Error 600: Error general de anuncios complementarios
El error 600 es un error genérico no fatal causado normalmente por un problema no especificado con los anuncios complementarios. Suele ocurrir cuando el editor no puede mostrar un anuncio complementario sin ningún motivo específico.
Para abordar este código de error, los editores pueden intentar verificar posibles problemas de publicación de anuncios y los compradores deben asegurarse de que las respuestas de VAST devuelvan archivos de creatividades válidos.
Error 601 de VAST: las dimensiones de la creatividad complementaria no se alinearon con el área de visualización complementaria
Este código de error suele ocurrir cuando el tamaño de una creatividad complementaria es demasiado grande para caber en el área de visualización del anuncio complementario.
Los editores deben asegurarse de que el tamaño del anuncio complementario solicitado (alto y largo) se ajuste a las dimensiones del bloque de anuncios.
Error 602 de VAST: no se puede mostrar el complemento requerido
Un error 602 de VAST significa que el editor no pudo mostrar la creatividad complementaria devuelta en la respuesta de VAST correspondiente .
Este código de error suele ser el síntoma de un problema de publicación de anuncios , que los editores deben comprobar y solucionar. Los compradores también deben asegurarse de que la respuesta de VAST devuelva una creatividad válida.
Error 603 de VAST: no se pueden obtener anuncios complementarios/recurso complementario
Los grandes errores 603 suelen ocurrir cuando la respuesta del comprador devuelve un elemento complementario que no pudo devolver una creatividad válida . El comprador debe verificar y asegurarse de que todas las respuestas de anuncios complementarios devuelvan creatividades válidas.
Error 604 de VAST: no se pudo encontrar el recurso complementario con el tipo admitido
Un gran error 604 suele ser el resultado de que un editor solicita un tipo de creatividad no compatible para un espacio publicitario complementario.
Para resolver este código de error, los editores deben asegurarse de que el espacio publicitario complementario admita los tipos de creatividades especificados.
Códigos de error VAST potencialmente fatales y no fatales
Estos códigos de error pueden o no corresponder a errores fatales.
VAST Error 900: VAST 2 Error (Posiblemente no fatal)
Este código de error específico se debe a un error de VAST 2 de cualquier tipo , incluso si se solicitan versiones posteriores de VAST (por ejemplo, VAST 3) o si la versión predeterminada de su red es VAST 3 o posterior.
Para abordar este código de error, los editores deben comenzar a solicitar VAST 3 o activar VAST 3 en su red . Se recomienda a los compradores que trabajen con el editor para solucionar problemas más específicos.
VAST Fatal Error 900: Error VAST 3 indefinido
Este código de error se devuelve cuando se produce un error VAST 3 desconocido y se detiene la solicitud de anuncio. Debido a la naturaleza no específica de este código de error, se recomienda a los editores y compradores que trabajen juntos para identificar el problema exacto .
Mejores prácticas para que los editores manejen errores
Aunque la mejor manera de evitar códigos de error de cualquier tipo es prevenir las condiciones necesarias para que ocurra un código de error, a veces son inevitables. Estas son algunas de las mejores prácticas que deben seguir los editores:
- Preste mucha atención al número de código de error . Muchos errores se pueden resolver o mitigar sin contactar al comprador, ahorrando una cantidad significativa de tiempo.
- Asegúrese de que las plataformas del lado de la demanda (DSP) tengan la oportunidad de escanear cada creatividad y resolver posibles problemas que causen errores antes de publicar el anuncio.
- Comuníquese y asóciese con sus DSP, plataformas del lado de la oferta (SSP), redes publicitarias y servidores publicitarios para mejorar el rendimiento de sus creatividades.
Resuelva los códigos de error de VAST con CodeFuel
Comprender la naturaleza de cada error de VAST es fundamental para abordar todos los posibles problemas de publicación de anuncios y optimizar el rendimiento de sus anuncios de video .
Si necesita ayuda para resolver errores de VAST , CodeFuel puede ayudarlo. Nuestro equipo de expertos en anuncios de video y especialistas en monetización puede ayudarlo y resolver cualquier código de error de VAST que pueda ocurrir. Contáctanos hoy para más información.