Esta sección se aplica a SSAI (inserción de anuncios desde el servidor) solo en los servicios de streaming en vivo .
Formatos de puntos de referencia
Los puntos de referencia contienen una lista de propiedades de valores clave que los reproductores pueden decodificar y usar para activar diversas acciones. Los puntos de referencia se usan para marcar eventos significativos en un stream, tales como el comienzo de canciones (con información de título/artista/álbum) y anuncios (con información de banner complementaria). Los reproductores por lo general escuchan estos puntos de referencia para presentar información de lo que se está reproduciendo a los oyentes, tales como la portada o banners complementarios sincronizados. Algunos reproductores también pueden modificar su UI dinámicamente para adaptarse al contenido del stream (por ejemplo mostrar un reproductor de video cuando se muestran anuncios de video).
Este documento solo describe los puntos de referencia de tipo de anuncio . Los puntos de referencia para estos y otros usos se documentan con mayor detalle en los siguientes documentos:
Guía detallada de metadatos de STWCue
Mapeo de metadatos Shoutcast V2 de Triton Digital
Pídale acceso a esos documentos a su gestor de Éxito del Cliente de Triton Digital.
Atributo de puntos de referencia | STWCue | AndoXML | Shoutcast V2 | Obligatorio | Comentario |
|---|---|---|---|---|---|
Tipo de punto de referencia | ad (anuncio) | Anuncio | TXXX cue_type="ad" | ✅ | |
ID única de anuncio | ad_id | BREAKADID | TXXX ad_id="..." | ||
Subtipo de anuncio | ad_type (break, | Tipo (BREAK, | TXXX | ✅ | |
Título del anuncio | cue_title | Título | TIT2 | Se puede mostrar al oyente durante el anuncio. | |
Duración del anuncio | cue_time_duration | Tiempo (en segundos) | TLEN | ||
Banners complementarios (anteriores) | ad_url | IMGURL | TXXX ad_url="..." | ||
Banners complementarios (VAST 2.0 - remoto) | ad_vast_url | – | TXXX ad_vast_url="..." | Contiene un URL de VAST XML que el reproductor debe recuperar. VAST puede contener un anuncio de video - ver más abajo | |
Banners complementarios (VAST 2.0 - en línea) | ad_vast | – | TXXX ad_vast="..." | Contiene el VAST XML (no un URL). También puede contener un anuncio de video - ver más abajo |
AndoXML es un tipo de punto de referencia obsoleto, y ha sido reemplazado por STWCue, pero todavía es utilizado por muchas estaciones (principalmente debido a configuraciones heredadas en la estación o reproductores existentes), y se documenta aquí en aras de la integridad. Se alienta encarecidamente que los reproductores y las estaciones nuevos usen STWCue, ya que proporciona más características, consistencia y compatibilidad.
Precedencia de formato de banner complementario
El punto de referencia de un anuncio puede contener referencias a banner complementarios en múltiples formatos (es decir, VAST 2.0 anterior, remoto y/o en línea) al mismo tiempo. El reproductor debe ver los atributos en este orden de precedencia:
ad_vast
ad_vast_url
ad_url (IMGURL para AndoXML)
El primer formato compatible (en el orden que se muestra arriba) debe usarse para exhibición de banner complementario, y los otros atributos (de menor prioridad) deben ser ignorados. Esto garantiza que los reproductores usen siempre primero el formato con más características, y pueden recurrir a formatos más antiguos si, por ejemplo, VAST no está disponible (ya sea para el anuncio o en el reproductor). También garantiza que podamos preservar la compatibilidad con reproductores existentes, y a la vez introducir mejores formatos en el futuro.
Se sugiere que los reproductores siempre implementen la compatibilidad con VAST 2.0 y, preferiblemente, también la compatibilidad con formatos heredados. Si bien la mayoría de las fuentes de anuncios en la Plataforma de anuncios de Triton Digital admiten VAST, algunas no han sido adaptadas con la compatibilidad con VAST. Al implementar la compatibilidad con formatos anteriores como plan b, garantiza que el reproductor siempre mostrará los banners complementarios para acompañar el anuncio de audio in-stream.
Banners complementarios anteriores
Los URL de banners complementarios anteriores (es decir, los atributos ad_url/IMGURL) admiten dos tamaños de banner, y siempre se proporcionan en formato HTML (apropiado como el contenido de un IFrame). Los URL son separados por el símbolo de tubo ("|"), según la siguiente sintáxis:
[<leaderboard-url>][|<bigbox-url>]
Es posible recibir solo uno de los tamaños. Si solo se proporciona una casilla grande, el URL comenzará con el símbolo de tubo. Alternativamente, si solo el marcador está presente, el URL no cuenta con el símbolo de tubo precedente, pero podría tener el símbolo de tubo al final.
Cuando no hay banners complementarios presentes, el atributo ad_url/IMGURL puede estar completamente ausente, o puede ser una cadena vacía, o puede tener un símbolo de barra vertical única, sin URL anteriores o finales.
Los reproductores deberían tolerar la presencia de símbolos de tubo externos. Sin embarho, las dos posiciones siempre estarán en el mismo orden, y se garantiza que el símbolo de tubo estará presente si solo se proporciona una casilla grande.
El reproductor debe usar las URL proporcionadas como fuente para el HTML interno de una etiqueta iFrame.