Cette section s’applique uniquement à l’insertion publicitaire côté serveur (SSAI) dans les services live streaming.
Formats des marqueurs
Les marqueurs contiennent une liste de propriétés de valeur clé que les lecteurs peuvent décoder et utiliser pour déclencher diverses actions. Les marqueurs sont utilisés pour marquer les événements importants d'un flux, tels que le début des chansons (avec titre/artistes/album) et les publicités (avec bannière d'accompagnement). Les lecteurs écoutent généralement ces marqueurs pour présenter aux auditeurs des informations « en cours de lecture », telles que des pochettes ou des bannières d'accompagnement synchronisées. Certains lecteurs peuvent également modifier leur interface utilisateur de manière dynamique, de façon à s'adapter au contenu du flux (par exemple : afficher un lecteur vidéo lors de l'affichage de publicités vidéo).
Ce document décrit uniquement les marqueurs de type de publicité. Les marqueurs temporels pour ces utilisations et d’autres sont documentés plus en détail dans les documents suivants :
Guide détaillé des métadonnées STWCue
Mappage des métadonnées Shoutcast V2 Triton Digital
Parlez à votre responsable de la réussite client Triton Digital pour accéder à ces documents.
Attribut de marqueur | STWCue | AndoXML | Shoutcast V2 | Requis | Commentaire |
|---|---|---|---|---|---|
Cue Type | l'annonce | Publicité | TXXX cue_type="ad" | ✅ | |
Identifiant publicitaire unique | ad_id | BREAKADID | TXXX ad_id="..." | ||
Sous-type de publicité | ad_type (break | Type (BREAK, | TXXX | ✅ | |
Titre de publicité | cue_title | Titre | TIT2 | Peut être affiché à l'auditeur pendant la publicité. | |
Durée de publicité | cue_time_duration | Durée (en secondes) | TLEN | ||
Bannières d'accompagnement (existantes) | ad_url | IMGURL | TXXX ad_url="..." | ||
Bannières d'accompagnement (VAST 2.0 - à distance) | ad_vast_url | – | TXXX ad_vast_url="..." | Contient une URL vers le XML VAST que le lecteur doit récupérer. VAST peut contenir une publicité vidéo - voir ci-dessous | |
Bannières d'accompagnement (VAST 2.0 - intégrées) | ad_vast | – | TXXX ad_vast="..." | Contient le XML VAST (pas une URL). Peut également contenir une publicité vidéo - voir ci-dessous |
AndoXML est un type de marqueur temporel obsolète, et a été remplacé par STWCue, mais il est toujours utilisé par de nombreuses stations (principalement en raison de configurations internes héritées ou de lecteurs existants), il et est documenté ici par souci d’exhaustivité. Il est fortement conseillé aux nouveaux lecteurs et stations d'utiliser STWCue, car il offre plus de fonctionnalités, de cohérence et d'assistance.
Priorité de format de bannière d'accompagnement
Le marqueur d'une publicité peut contenir des références à des bannières d'accompagnement dans plusieurs formats (c'est-à-dire, format existant, VAST 2,0 à distance ou intégrées) en même temps. Le lecteurs doit évaluer les attributs dans cet ordre de priorité :
ad_vast
ad_vast_url
ad_url (IMGURL pour AndoXML)
Le premier format pris en charge (dans l'ordre indiqué ci-dessus) doit être utilisé pour l'affichage de la bannière d'accompagnement et les autres attributs (de priorité plus faible) doivent être ignorés. Ceci garantit que les lecteurs utilisent toujours en premier lieu le format le plus riche en fonctionnalités et qu'ils peuvent revenir aux anciens formats si, par exemple, VAST n'est pas disponible (que ce soit pour la publicité ou dans le lecteur lui-même). Ceci nous permet également de garantir la rétrocompatibilité avec les lecteurs existants, tout en introduisant de meilleurs formats à l'avenir.
Il est suggéré que les lecteurs acceptent toujours la prise en charge de VAST 2.0 et de préférence, la prise en charge du format hérité. Même si la plupart des sources de publicités de la plate-forme publicitaire Triton Digital prennent en charge VAST, certaines n'ont pas encore été réadaptées en vue de la prise en charge de VAST. Grâce à la prise en charge du format existant comme méthode de secours, le lecteur affichera toujours des bannières d'accompagnement pour accompagner la publicité audio en cours de diffusion.
Bannières d'accompagnement existantes
Les URL de bannières d'accompagnement existantes (c'est-à-dire, les attributs ad_url/IMGURL) prennent en charge deux tailles de bannières et sont toujours restituées au format HTML (adapté au contenu d'un IFrame). Les URL sont séparées par le symbole de la barre verticale (« | »), selon la syntaxe suivante :
[<leaderboard-url>][|<bigbox-url>]
Il est possible de ne recevoir qu'une seule des tailles. Si seule une bannière au format « grande boîte » est fournie, l'URL commencera par le symbole de la barre verticale. Sinon, si seule une bannière au format « tableau de classement » est présente, l'URL n'est pas précédée par un symbole de barre verticale, mais elle peut être suivie par un tel symbole.
Lorsque aucune bannière d’accompagnement n’est présente, l’attribut ad_url/IMGURL peut être complètement absent, ou il peut s’agir d’une chaîne vide, ou il peut avoir un seul symbole de barre verticale, sans URL précédente ou de fin.
Les lecteurs devraient tolérer la présence de barres verticales superflues. Cependant, les deux positions seront toujours dans le même ordre. La présence d'une barre verticale est garantie uniquement si une bannière au format « grande boîte » l'est également.
Le lecteur doit utiliser les URL fournies comme source pour le HTML interne d’une balise iFrame.