Códigos de respuesta HTTP
Código | Mensaje | Descripción |
|---|---|---|
200 | OK | Éxito. La respuesta puede o no contener un anuncio. |
400 | Bad Request | Uno de los parámetros obligatorios falta o tiene un valor no válido (p. ej., la ID de colocación no existe). |
404 | Not Found | El extremo que se intenta activar no es correcto. |
Otros errores HTTP estándar, como
500 Internal Server Error,o405 Method Not Allowed, también puede ser devuelto. Las aplicaciones deben manejar los códigos de respuesta HTTP de acuerdo con las convenciones estándar, como se describe en w3.org protocolo RFC9110.
200 - Respuesta del anuncio
Al devolver un anuncio, el cuerpo de la respuesta contendrá un archivo en línea VAST.
El anuncio devuelto por el servicio de solicitud de anuncios transmitidos cumple con la especificación VAST. (Consulte la última especificación VAST del IAB).
El contenido real de cada archivo VAST devuelto depende del administrador creativo utilizado por el comprador, por lo que el analizador debería ignorar los campos que no reconoce o no puede manejar.
El ID del socio que devolvió el anuncio, junto con el ID creativo devuelto por el socio, se proporcionan en el siguiente encabezado HTTP: x-creative-id:
Cuando se utiliza la aprobación de creatividad, se puede usar este ID en lugar de analizar el archivo VAST.
Cuando no se utiliza la aprobación de creatividad, la persona que llama debe obtener la creatividad de uno de los <MediaFile> Elementos.
En cualquier caso, el archivo VAST debe almacenarse, ya que será necesario al confirmar la reproducción (consulte la sección a continuación).
200 - Sin respuesta del anuncio
Si el servicio de solicitud de anuncios transmitidos no tiene ningún anuncio disponible que coincida con los parámetros de la solicitud, aún así devolverá un 200 OK código de respuesta y un archivo VAST, pero sin <Ad> elemento. En su lugar, una opción opcional <Error> se puede incluir en el archivo, como:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<VAST version=" 4.3">
<Error>
<![CDATA[http://adserver.com/?dur=[TD_DURATION]>
</Error>
</VAST>Los módulos
<Error>El elemento es opcional y se utiliza para pronosticar el inventario digital. La predicción no es compatible con la difusión en este momento, por lo que este elemento puede ser ignorado.