TAP y TAP programático devuelven un archivo en línea VAST. Tenga en cuenta que anteriormente TAP devolvió un archivo contenedor VAST, pero se suspendió a partir del 2022-07-14.
El contenido de cada archivo VAST generado depende del contenido creativo que haya usado el administrador, de modo que debería ignorar los campos no mencionados aquí que su analizador no reconozca o no pueda manejar.
Para obtener información sobre la respuesta de anuncios con separación de industrias, consulte Separación de industrias.
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. |
También se pueden devolver otros errores HTTP estándar, como 500 Error interno del servidor o 405 Método no permitido. 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
El anuncio generado por el servicio de anuncios on demand cumple con la especificación VAST. Así, la aplicación del cliente debería ser compatible con la especificación VAST más reciente de IAB.
El subconjunto VAST que deben admitir las aplicaciones cliente es:
Anuncios en línea de audio
Tipos de contenido de audio: MP3, AAC
Título del anuncio
URL de impresión (consulte Informes de impresión)
Archivos de medios que utilizan distribución progresiva (pueden generarse múltiples archivos)
URL de seguimiento para cuartiles (consulte Cuartiles)
Banners complementarios
IFrameResource, HTMLResource y StaticResource
Tipos de contenido de banner: JPG, PNG, GIF
URL de seguimiento de clics en banners complementarios (tanto proporción de clics como URL de seguimiento de clics)
Eventos de seguimiento: creativeView
Texto alternativo de banner
Elemento <Error>
La respuesta VAST (cuando no es una oportunidad perdida) incluye un elemento <Error> con un URI para activar si no se reproduce el anuncio devuelto.
Los módulos <Error> permite al reproductor de medios enviar comentarios a los servidores de anuncios cuando un anuncio no se puede distribuir. La especificación VAST (sección 2.3.6: Error Reporting) describe el informe de error en mayor detalle. El cuadro de códigos de error VAST para reemplazar la macro [ERRORCODE] se describen en la sección 2.3.6.3.
Triton Digital recomienda encarecidamente que implemente lógica en su reproductor para activar el elemento <Error> cuando el anuncio no se reproduce, porque:
Proporcionar códigos de error más detallados permite un diagnóstico más sólido y un mejor desarrollo de la tecnología con el paso del tiempo.
La limitación se activa por la solicitud, no por la impresión. Por lo tanto, si usa la limitación y no llama al error URI cuando no se reproduce un anuncio, el ad server considera que el anuncio se ha publicado y, por lo tanto, aplica la limitación donde no es necesario.
Consulte Opciones de codificación de URL para el elemento de error, a continuación.
200 - Sin respuesta del anuncio (oportunidad perdida)
Si el servicio de anuncios on demand no tiene ningún anuncio disponible que coincida con los parámetros de la solicitud, aún devolverá un código de respuesta 200 OK 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[https://adserver.com/?dur=%5BTD_DURATION%5D]]>
</Error>
</VAST>Los módulos <Error> es opcional, pero si se incluye, el reproductor debe enviar una solicitud al URI proporcionado cuando y si se generó una impresión (por ejemplo, si se reprodujo contenido de relleno). Esto permite que Triton Digital registre la duración de relleno de esta oportunidad perdida para poder brindar una previsión exacta.
Si una
[TD_DURATION]macro está incluido en el URI, debe sustituirse con la duración real, en segundos, del contenido relleno. Si no se sustituye la macro, se supone una duración predeterminada de 30 segundos. Para una solicitud de anuncio dada, este URI puede activarse varias veces (la duración final que se registra es la suma de la duración de cada llamada individual).Si una
[ERRORCODE]macro está incluido en el URI, el reproductor debe sustituir con el valor 202.
Opciones de codificación de URL para el elemento de error
Hay dos opciones para manejar el <error> descrito anteriormente, dependiendo de si utiliza o no la sustitución de macros.
Si no utiliza la sustitución de macros:
Llame a CDATA tal cual (en forma válida codificada mediante URL) sin realizar la sustitución de macros.
Por ejemplo, recibirá: <![CDATA[http://adserver.com/?dur=%5BTD_DURATION%5D]]>
... y debería llamar a: https://adserver.com/?dur=%5BTD_DURATION%5D
Si utiliza la sustitución de macros:
URL decodifica el elemento, aplica macro transformaciones y luego codifica URL antes de enviar la solicitud.
Por ejemplo, recibirá: <![CDATA[http://adserver.com/?dur=%5BTD_DURATION%5D]]>
... que decodifica a: https://adserver.com/?dur=[TD_DURATION]
... luego reemplace [TD_DURATION] con el valor de duración real (en este ejemplo, 20)
... y debería llamar a: https://adserver.com/?dur=20