Esta sección describe los parámetros de cadena de consulta que se usan para habilitar la publicidad on demand en los servicios de Triton Digital. Estos parámetros deben enviarse además de los parámetros descritos en Parámetros, en la Especificación técnica de publicidad.
Solo debe enviar un parámetro si desea específicamente pasar un valor para ese parámetro. Si no desea pasar un valor, no debe enviar el parámetro.
Los parámetros se pueden proporcionar en la cadena de consulta del URI del extremo o, cuando se indique, como un campo de encabezado HTTP. Cuando se reciben ambos, la cadena de consulta se evalúa primero y el encabezado HTTP se evalúa en segundo lugar, en el orden que se presenta en esta página.
Tenga en cuenta que los parámetros de cadena de consulta que admiten una lista se pueden establecer como separados por comas sin procesar o como codificados por URL.
Cadena de consulta | Encabezado HTTP | Descripción | Formato |
|---|---|---|---|
stid | ID de la colocación (históricamente conocida como la "ID de estación"). Este parámetro es obligatorio. Consulte la nota STID a continuación, para conocer las alternativas. | Valor entero. | |
tipo | Posición del anuncio. Este parámetro es obligatorio, | Secuencia. Valores válidos:
| |
maxAds | Cuando el valor del parámetro es mayor que 1, el ad server on demand devuelve un pod de anuncios que contiene varios anuncios hasta el valor del parámetro, y se utiliza el atributo sequence en la respuesta. Cuando el ad server solo tiene un elemento ad para devolver, no se utiliza un pod de ad y el atributo sequence no se utiliza en la respuesta. (Consulte las Notas de uso de pods de anuncios a continuación para obtener más información sobre los pods de anuncios, y las Notas de uso de posicionamiento de pausas a continuación para conocer cómo maxAds puede afectar la orientación de "último en pausa"). Este parámetro es opcional; Si no se proporciona, el valor asumido es 1. | Entero. Valores válidos entre 1 y 10. | |
ip | X-Device-IP | Dirección IP del reproductor/dispositivo del oyente. Este parámetro es necesario para las integraciones de servidor a servidor. | Para IPv4: Formato decimal con puntos (p. ej., Para IPv6: Caracteres hexadecimales separados por dos puntos que se ajustan al estándar IPv6 (por ejemplo, |
ua | X-Device-User-Agent | Encabezado HTTP User-Agent del reproductor/dispositivo del oyente. Este parámetro es necesario para las integraciones de servidor a servidor. | Codificado mediante URL si se envía como cadena de consulta. |
cabecera | X-Device-Referer | Encabezado HTTP de referente del reproductor/dispositivo del oyente (URL de la página en la que está integrado el reproductor). Este parámetro se recomienda para reproductores basados en navegador en integraciones de servidor a servidor. Nota: la ortografía de X-Device-Referer es correcta para este uso (una "r"); el "HTTP referer" ha usado esa desafortunada ortografía desde el comienzo del protocolo. No se sabe si el responsable es Phillip Hallam-Baker o Tim Berners-Lee. (Hallam-Baker culpa a Berners-Lee.) | Codificado mediante URL si se envía como cadena de consulta. |
idioma-dispositivo | X-Device-Accept-Language o | Cabecera HTTP del reproductor/dispositivo del oyente. Indica para qué idiomas está configurado el cliente y la variante local preferida. Somos compatibles con ambos: cadena de consulta y/o cabecera HTTP. Este parámetro se recomienda para integraciones de servidor a servidor. | Secuencia. Código de dos letras que corresponde a los códigos de idioma ISO 639-1. |
dispositivo-so | Sistema operativo del dispositivo (por ejemplo, iOS). | Secuencia. | |
dispositivo-osv | Versión del sistema operativo del dispositivo (por ejemplo, 3.1.2) | Secuencia. | |
mindur | Duración mínima en segundos permitida para el anuncio solicitado. Si usa este parámetro, anulará TAP duración de medios programáticos establecida en Calidad de anuncio progresivo. Para obtener información sobre cómo funciona este parámetro con maxAds y pods de anuncios, consulte Notas de uso de pods de anuncios. | Entero. | |
maxdur | Duración máxima en segundos permitida para el anuncio solicitado. Si usa este parámetro, anulará TAP duración de medios programáticos establecida en Calidad de anuncio progresivo. Para obtener información sobre cómo funciona este parámetro con maxAds y pods de anuncios, consulte Notas de uso de pods de anuncios | Entero. | |
iab-categories-to-exclude | Lista de categorías de anuncios NO permitidas para el anuncio solicitado. Las categorías se definen en la especificación IAB DAAST y se enumeran con códigos en OpenRTB. (Aunque la especificación DAAST está obsoleta, sus categorías de anuncios todavía se usan regularmente. Triton se actualizará a la IAB Taxonomía de productos publicitarios una vez que haya alcanzado un nivel aceptable de uso). Nota: el bloqueo de una categoría de nivel 1 no bloquea el nivel 2 bajo ella (por ejemplo, el bloqueo de IAB1 no bloquea IAB1-1 a IAB1-7). Para bloquear el nivel 2 de una categoría, cada categoría de nivel 2 debe bloquearse individualmente. | Lista de códigos separados por comas (cadenas). | |
feed-type | Requerido para el caso de uso específico en el que el inventario se ofrece a publicidad programática y los anuncios solicitados a través de on demand se unen a un podcast. También se puede usar para transmisión en vivo (Vea también: método de entrega). | Secuencia. Valores válidos:
| |
parámetro de consulta content-language | El idioma del contenido donde se reproducirán los anuncios. Esto se puede usar en el direccionamiento de campañas o para definir una regla específica en el intercambio de anuncios. | Secuencia. Código de dos letras que corresponde a los códigos de idioma ISO 639-1. | |
iab-v2-cat | Categoría del contenido según lo definido por la taxonomía de contenido V2 de IAB Tech Lab (archivo XLXS). La primera categoría de la lista será considerada como la categoría principal. Este parámetro se recomienda para contenido de audio personalizado (p. ej., servicios de música) donde el género es dinámico y se basa en la elección del oyente. Consulte IAB notas de uso de categorías. | Lista separada por comas de valores enteros, cada uno dentro del rango de 1-698. (Consulte IAB Notas de uso de categorías a continuación). | |
site-url | URL el sitio web donde se oirá el anuncio. Los compradores programáticos lo utilizan para identificar el inventario en el que hacen ofertas. También se utiliza para verificar si Triton Digital puede vender su inventario utilizando el marco ads.txt. Si no se envía, Triton Digital usará el valor configurado para esta colocación. Para obtener más información, consulte Vendedores digitales autorizados (ads.txt). | URL codificada cadena de una URL, que debe incluir el protocolo (por ejemplo, http o https). Ejemplo:
| |
delivery-method | La forma en la que se enviará el contenido de audio al oyente. Este parámetro es obligatorio si se descarga el contenido en el que aparecerá el anuncio y se ofrece inventario de anuncios a compradores programáticos. | Secuencia. Valores válidos:
| |
break-id | ID de interrupción | Identificador único universal (UUID) que se utiliza para identificar las pausas publicitarias on demand para la separación de la industria. Debe ser único para cada oyente. Para obtener más información, consulte Separación por industria. | Secuencia |
break-context | Break-Context | Cadena codificada devuelta por Triton Digital en respuesta a una break-id; la cadena break context debe ser devuelta a Triton Digital con la siguiente solicitud de anuncio. Para obtener más información, consulte Separación por industria. | Secuencia |
break-position | Ubique break position de los anuncios solicitados de manera tal que coincidan con el direccionamiento de contenido correspondiente. En el caso de varios anuncios entregados, solo se espera que un anuncio ( ya sea el primero o el último) coincida con ese direccionamiento. El parámetro es opcional. Para obtener más información, consulte Notas de uso de Break Positioning a continuación. | Secuencia. Valores válidos:
| |
número de ruptura | El número de pausa dentro del episodio del podcast. | Entero | |
series-title | Título de la serie (contenido en podcast). | Secuencia. | |
episode-season | Número de temporada (contenido en podcast). | Secuencia. | |
episode-number | Número de episodio (contenido en podcast). | Secuencia. | |
episode-title | Título del episodio (contenido en podcast). | Secuencia. | |
episode-url | URL de origen del episodio (contenido en podcast). | Codificado mediante URL si se envía como cadena de consulta. | |
duración del episodio | Duración del episodio. | Entero. | |
Guid | ID de episodio | Entero. |
La ID de colocación (stid) es el método preferido para indicar para qué colocación se está realizando la solicitud de anuncio on demand, pero Triton Digital también admite métodos alternativos como el nombre de la estación o una ID externa. Comuníquese con su especialista en soluciones de Triton Digital si desea obtener más información al respecto.
Notas sobre el método de entrega
A continuación se muestran las definiciones de los valores del método de entrega .
Streaming: para un flujo interminable de contenido, como radio en vivo. La sesión del usuario finaliza solo cuando el dispositivo cierra la conexión. El contenido se recupera a medida que se consume. También se aplica a servicios de música on demand (aunque no reproducciones on demand "en vivo") porque todo el tiempo se agrega contenido nuevo a la lista de reproducción a medida que se va consumiendo el contenido en curso.
Descargar: para contenido individual pregrabado/finito, como un podcast. La sesión del usuario finaliza cuando se descarga todo el contenido (o antes, si el usuario se desconecta en mitad de la descarga). Por lo general, la recuperación y el consumo de contenido son independientes; un ejemplo es el caso de un oyente que descarga un podcast y lo escucha más tarde, incluso quizá cuando el dispositivo está fuera de línea. Por lo tanto, las impresiones se activan por la descarga, no por el consumo.
Progresivo: o "descarga progresiva", es para el mismo tipo de contenido pregrabado/finito que la descarga, pero el contenido se recupera a medida que se consume. Esto debe ser aplicado por el reproductor en el dispositivo del usuario. Es una implementación de cliente, por lo que las implementaciones del lado del servidor que aceleran la tasa de descarga (por ejemplo, en función de la tasa de bits del contenido) no califican una sesión como descarga progresiva.
Notas de uso de pods de anuncios
Un pod de anuncios es un grupo de múltiples anuncios contenidos en una sola respuesta. Se proporcionan múltiples elementos <Ad> con atributos <secuencia> ; el resultado es un VAST con múltiples anuncios ordenados con números de secuencia (el primer anuncio seleccionado es "1", etc.). Los anuncios se seleccionan en función de su prioridad/peso.
Un pod de anuncios puede contener varios anuncios de fuentes directas pero solo un anuncio programático. Tenga en cuenta que si usa mindur y/o maxdur junto con maxAds (con un valor maxAds superior a "1"), las duraciones mínimas/máximas especificadas se aplican a cada anuncio del pod de anuncios, no a la duración total del pod de anuncios. Cuando una solicitud incluye un parámetro break-id y un parámetro maxAds , el contexto de pausa que se devuelve contiene todas las categorías de IAB e ID de anunciante que contiene el pod de anuncio.
Hay lógica de limitación incrustada en un pod de anuncios; Un pod de anuncios no contendrá dos o más anuncios del mismo vuelo TAP, ni dos o más anuncios con la misma categoría IAB. Tenga en cuenta que puede aplicar la separación de industrias dentro de los pods de anuncios.
IAB Notas de uso de categorías
Todos los siguientes parámetros deben incluirse en la solicitud de anuncio para poder usar IAB v2 y, por lo tanto, causar una impresión IAB v2 para podcast:
guidbreak-numberbreak-idipua
Si alguno de los parámetros anteriores no está incluido, se utiliza IAB v1 .
IAB se aceptan valores superiores a 698, pero se ignorarán. Por ejemplo, si recibimos iab-v2-cat=1068 (1068 = inglés), esto no establecerá el idioma del contenido en inglés. En su lugar, use el parámetro de idioma de contenido dedicado.
A diferencia del contenido de transmisión donde el género del programa es estático, la categoría de contenido (iab-v2-cat) de los servicios de música personalizados es dinámica y depende de la selección del oyente. Para aprovechar las campañas publicitarias dirigidas a los oyentes por preferencia de contenido, use el parámetro iab-v2-cat en sus solicitudes de anuncios. Configure el reproductor para que utilice el valor iab-v2-cat que más se acerque a la selección de categoría de contenido actual del oyente. Esto alerta a las campañas dirigidas de mayor valor sobre el inventario direccionable disponible.
Notas de uso de Break Positioning
El uso de break-position está estrechamente relacionado con el targeting position-in-break. Si usted no usa este tipo de direccionamiento, simplemente ignore este parámetro.
Al pasar un ID de pausa y un contexto de pausa, el ad server determina automáticamente la primera posición . Si no usa break-context, debe usar break-position=first para que el primer vuelo entregado apunte a la primera posición, si es posible.
El ad server no puede determinar la última posición del corte. Incluso cuando use break-context, debe usar break-position=last para indicar que esta será la última solicitud de anuncio relacionada con esa pausa en particular, de modo que el último vuelo entregado apunte a la última posición, si es posible.
Incluso si maxAds está por encima de 1, solo un anuncio devuelto direccionará la primera o la última posición. Además, la cantidad de anuncios devueltos debe coincidir con la cantidad de anuncios solicitados antes de que el último se pueda considerar en la última posición. Si el ad server devuelve menos anuncios de los solicitados, ninguno de ellos apuntará a la última posición. Por ejemplo: si maxAds es 3 y solo se completa la primera posición, no se entregará el anuncio "last in break".