Extremo HTTP
El servicio de solicitud de anuncios de difusión está disponible a través de un extremo HTTP/HTTPS público:
//<broadcast-ad-server-host>/broadcast/ars?<query parameters>
Comuníquese con el Servicio al Cliente de Triton Digital para obtener el nombre de host correcto para usar en preproducción y usos de producción.
Un ejemplo completo con muchos de los parámetros disponibles se vería así:
https://broadcast.live.streamtheworld.com/broadcast/ars?stid=12345&qty=35800&qtysourceid=1&qtysource=Nielsen
Parámetros
En esta sección se describen los parámetros de cadena de consulta disponibles cuando se utiliza el servicio Broadcast Ad-Request.
Hay dos tipos de solicitud, como se describe a continuación.
Solicitud de subasta:
Esto se hace cuando se debe ejecutar una subasta en el intercambio. Triton selecciona automáticamente los acuerdos PMP (mercado privado) que correspondan. Las categorías de anuncios específicas que no se pueden reproducir deben proporcionarse en la llamada para evitar que Triton devuelva un anuncio que se eliminará debido a la separación de la industria. Esta solicitud se activa cuando no se proporciona ningún ID de acuerdo .
Solicitud PG:
Esto se hace cuando un acuerdo programático garantizado (PG) está a punto de emitirse. Triton se comunica con el socio de demanda adecuado (y solo con ese socio) para el acuerdo. Esta solicitud se activa cuando se proporciona un ID de acuerdo .
Solo debe enviar un parámetro de consulta si desea específicamente pasar un valor para ese parámetro. Si no desea pasar un valor, no envíe el parámetro de consulta.
Los parámetros deben proporcionarse en la cadena de consulta del URI del extremo.
Nombre | Descripción | Formato |
|---|---|---|
stid | ID Tritón de la estación de colocación. Este parámetro es obligatorio. | Entero |
ext2_stid | ID externo de la estación. Este parámetro es necesario si | Secuencia |
qty | Número de usuarios que escuchan el contenido donde se reproducirá el anuncio, según la medición de la audiencia. Este parámetro es obligatorio. | Flotar |
Tipo de cantidad | El tipo de fuente de la medición de la cantidad. Este parámetro es obligatorio. | Entero (enumeración) 1: proveedor de medición proporcionado 2: Proporcionado por el editor |
Proveedor de cantidades | El nombre de dominio comercial del proveedor de medición que proporciona la medición de cantidad (el dominio comercial es la etiqueta de nivel siguiente después del dominio de nivel superior efectivo) (por ejemplo, "nielsen.com") Este parámetro es obligatorio. | Secuencia |
Id. de acuerdo | ID de un acuerdo PG existente para el que se solicita el anuncio. Si se proporciona, la solicitud se limitará al DSP y al comprador especificados en el acuerdo. Si no se proporciona, la solicitud desencadena una subasta. | Secuencia |
Excluded-iab-Categories | Lista de categorías de anuncios NO permitidas para el anuncio solicitado. La taxonomía actual utilizada es la IAB Content Taxonomy v1. | Lista de códigos separados por comas (cadenas). |