Cette section décrit les paramètres de chaîne de requête utilisés pour activer la publicité à la demande sur les services de Triton Digital. Ces paramètres doivent être envoyés en plus des paramètres décrits dans la section Paramètres, dans la spécification technique de la publicité.
L’identifiant d’emplacement (stid) est la méthode privilégiée pour indiquer l’emplacement pour lequel la demande de publicité à la demande est effectuée. Triton Digital prend également en charge d’autres méthodes telles que le nom de la station ou un identifiant externe. Pour en savoir plus, consultez la rubrique Contacter l’assistance.
N’envoyez un paramètre que si vous souhaitez spécifiquement passer une valeur pour ce paramètre. Si vous ne souhaitez pas passer de valeur, vous ne devez pas envoyer le paramètre.
Les paramètres peuvent être fournis soit dans la chaîne de requête de l’URI du point de terminaison, soit, le cas échéant, sous la forme d’un champ d’en-tête HTTP. Lorsque les deux sont reçus, la chaîne de requête est évaluée en premier, et l’en-tête HTTP est évalué en second, dans l’ordre présenté sur cette page.
Les paramètres de chaîne de requête prenant en charge une liste peuvent être définis comme bruts, séparés par des virgules ou codés en URL.
Chaîne de requête | En-tête HTTP | Description | Format |
|---|---|---|---|
stid | Identifiant du placement (historiquement connu sous le nom de « identifiant de la station »). Obligatoire. Pour les alternatives, voir la note STID. | Chiffre entier | |
type | Position de la publicité. Obligatoire. | Chaîne. Valeurs valides :
| |
maxAds | Lorsque la valeur du paramètre est supérieure à 1, le serveur publicitaire à la demande renvoie un module publicitaire contenant un nombre de publicités allant jusqu’à la valeur du paramètre, et l’attribut « séquence » est utilisé dans la réponse. Ce paramètre est facultatif, la valeur par défaut est 1. Lorsque le serveur publicitaire n’a qu’un seul élément publicitaire à renvoyer, un module publicitaire n’est pas utilisé et l’attribut « séquence » n’est pas utilisé dans la réponse. Consultez également les remarques sur l’utilisation des modules publicitaires et les remarques sur l’utilisation du positionnement dans les pauses. | Chiffres entiers Valeurs valides : 1 à 10. | |
ip | X-Device-IP | Adresse IP du lecteur ou de l’appareil auditeur. Requis pour les intégrations de serveur à serveur. | Pour IPv4 : format décimal en pointillé. Exemple : Pour IPv6 : caractères hexadécimaux séparés par des deux-points. Exemple : |
ua | X-Device-User-Agent | En-tête HTTP d'agent utilisateur du lecteur/dispositif auditeur. Requis pour les intégrations de serveur à serveur. | Encodé en URL si envoyé sous forme de chaîne de requête. |
referrer | X-Device-Referer | En-tête HTTP de référence du lecteur/dispositif auditeur (URL de la page dans laquelle le lecteur est intégré). Recommandé pour les lecteurs basés sur un navigateur dans les intégrations de serveur à serveur. Note : l’utilisation d’un « r » dans cette orthographe de X-Device-Referer est correcte. | Encodé en URL si envoyé sous forme de chaîne de requête. |
langue de l'appareil | X-Device-Accept-Language ou | En-tête HTTP du lecteur/dispositif auditeur. Elle indique la langue configurée pour le client et la région géographique préférée. Nous prenons en charge les deux : la chaîne de requête ou l’en-tête HTTP. Recommandé pour les intégrations de serveur à serveur. | Chaîne. Code à deux lettres qui correspond aux codes de langue ISO-639-1. |
appareil-os | Système d’exploitation de l’appareil. | Chaîne. Exemple : iOS | |
appareil-osv | Version du système d’exploitation de l’appareil | Chaîne. Exemple : 3.1.2. | |
mindur | Durée minimale en secondes autorisée pour la publicité demandée. Si ce paramètre est utilisé, il remplace la durée des médias programmatiques TAP définie dans Qualité des publicités progressives. Pour obtenir plus d’informations sur le fonctionnement de ce paramètre avec maxAds et les modules publicitaires, consultez la section Remarques sur l’utilisation des modules publicitaires. | Chiffres entiers | |
maxdur | Durée maximale en secondes autorisée pour la publicité demandée. Si ce paramètre est utilisé, il remplace la durée des médias programmatiques TAP définie dans Qualité des publicités progressives. Pour plus d’informations sur le fonctionnement de ce paramètre avec maxAds et les modules publicitaires, consultez la section Notes sur l’utilisation des modules publicitaires | Chiffres entiers | |
iab-categories-to-exclude | Liste des catégories d’annonces non autorisées pour l’annonce demandée. Les catégories sont définies dans la specification IAB DAAST et indiquées en codes OpenRTB. Pour exclure le niveau 2 d’une catégorie, chaque catégorie du niveau 2 doit être exclue individuellement. L’exclusion d’une catégorie de niveau 1 ne bloque pas les catégories de niveau 2 qui s’y trouvent. Par exemple, le fait d’exclure uniquement IAB1 ne bloque pas IAB1-1 à IAB1-7. Bien que la spécification DAAST soit obsolète, ses catégories de publicité sont toujours utilisées régulièrement. Triton passera à la taxonomie des produits publicitaires de l’IAB une fois qu’elle aura atteint un niveau d’utilisation acceptable. | Chaîne. Liste de codes séparés par des virgules. | |
feed-type | Obligatoire pour le cas d’utilisation spécifique où l’inventaire est offert de manière programmatique et les annonces publicitaires réalisées à la demande sont insérées dans un podcast. Peut également être utilisé pour les flux en direct. Voir aussi la méthode de diffusion. | Chaîne. Valeurs valides :
| |
content-language (langue du contenu) | La langue du contenu dans lequel les publicités seront lues. Elle peut être utilisée dans le ciblage par campagne ou pour définir une règle spécifique d'échange de publicité. | String. Code à deux lettres qui correspond auxISO 639-1 codes de langue. | |
iab-v2-cat | Catégorie du contenu telle que définie par la taxonomie de contenu V2 du laboratoire technique de l’IAB (fichier XLXS). La première catégorie de la liste est considérée comme la catégorie principale. Ce paramètre est recommandé pour les contenus audio personnalisés, tels que les services de musique, où le genre est dynamique et basé sur le choix de l’auditeur. Reportez-vous aux notes d’utilisation de la catégorie IAB. | Liste de valeurs entières séparées par des virgules, chacune dans la plage 1-698. (Voir les notes d’utilisation de la catégorie IAB ci-dessous.) | |
site-url | URL of the website where the ad will be heard. Utilisée par les acheteurs programmatiques afin d'identifier l'inventaire sur lequel ils enchérissent. Il est également utilisé pour vérifier si Triton Digital est autorisé à vendre votre inventaire à l’aide du cadre ads.txt. Si elle n'est pas envoyée, Triton Digital utilisera la valeur configurée pour ce placement. Pour en savoir plus, consultez Vendeurs numériques autorisés (ads.txt). | Chaîne encodée en URL d’une URL, qui doit inclure le protocole, http ou https). Exemple :
| |
delivery-method | Comment le contenu audio sera fourni à l'auditeur. Ce paramètre est obligatoire si le contenu dans lequel la publicité apparaîtra est téléchargé et que l’inventaire publicitaire est proposé aux acheteurs programmatiques. | Chaîne. Valeurs valides :
Voir les remarques sur les méthodes de diffusion. | |
break-id | Break-ID | Identifiant unique universel (UUID) utilisé pour identifier les pauses publicitaires à la demande pour la séparation des secteurs. Doit être propre à chaque auditeur. Pour de plus amples informations, consultez Séparation des secteurs. | Chaîne |
break-context | Break-Context | Chaîne codée renvoyée par Triton Digital en réponse à un break-id ; la chaîne de break context doit être renvoyée à Triton Digital avec la prochaine demande de publicité. Pour de plus amples informations, consultez Séparation des secteurs. | Chaîne |
break-position | Oblige à ce que les annonces indiquées aient un positionnement correspondant au ciblage voulu des contenus. En cas de diffusion de plusieurs annonces publicitaires, une seule publicité ( la première ou la dernière) est censée correspondre à ce ciblage. Le paramètre est facultatif. Pour plus d’informations, reportez-vous à la section Remarques sur l’utilisation du positionnement des pauses, ci-dessous. | Chaîne. Valeurs valides :
| |
numéro de pause | Le numéro de pause dans l’épisode du podcast. | Chiffres entiers | |
series-title | Titre de la série pour le contenu de podcast. | Chaîne. | |
episode-season | Numéro de saison pour le contenu de podcast. | Chaîne. | |
episode-number | Numéro de l’épisode pour le contenu de podcast. | Chaîne. | |
episode-title | Titre de l’épisode pour le contenu de podcast. | Chaîne. | |
episode-url | URL de l’épisode pour le contenu de podcast. | Encodé en URL si envoyé sous forme de chaîne de requête. | |
durée-épisode | Durée de l’épisode. | Chiffres entiers | |
guid | Identifiant de l'épisode. | Chaîne. Au format UUID standard. |
Remarques sur le mode de diffusion
Vous trouverez ci-dessous les définitions des valeurs de la méthode de diffusion.
Streaming : pour un flux infini de contenus, comme la radio en direct. La session utilisateur ne se termine que lorsque l’appareil ferme la connexion. Le contenu est récupéré au fur et à mesure qu’il est consommé. Cela s’applique également aux services de musique à la demande. Elle ne s’applique pas aux performances à la demande « en direct », car de nouveaux contenus sont constamment ajoutés à la liste de lecture au fur et à mesure que le contenu actuel est consommé.
Télécharger : pour un contenu unique préenregistré ou fini, tel qu’un podcast. La session de l’utilisateur se termine une fois le contenu téléchargé ou avant si l’utilisateur se déconnecte à mi-chemin. La récupération et la consommation du contenu sont généralement indépendantes l'une de l'autre. C'est le cas quand un auditeur télécharge un podcast et l'écoute plus tard, par exemple avec l'appareil hors ligne. Ainsi, les impressions sont déclenchées par le téléchargement, et non par la consommation.
Progressif : Pour le même type de contenu préenregistré ou fini que le téléchargement, mais le contenu est récupéré au fur et à mesure de sa consommation. Cette règle doit être appliquée par le lecteur sur l’appareil de l’utilisateur. Il s’agit d’une implémentation client, de sorte que les implémentations côté serveur qui limitent le taux de téléchargement ne qualifient pas une session de téléchargement progressif.
les remarques sur l'utilisation des modules publicitaires
Un module publicitaire est un groupe de plusieurs publicités contenues dans une seule réponse. Plusieurs éléments <Ad> sont fournis avec des attributs <séquence> . Le résultat est une requête VAST avec plusieurs annonces classées avec des numéros de séquence. Les annonces sont sélectionnées en fonction de leur priorité et de leur poids.
Un module publicitaire peut contenir plusieurs publicités provenant de sources directes, mais seulement une seule publicité programmatique. Notez que si vous utilisez mindur ou maxdur avec une valeur maxAds supérieure à « 1 », les durées minimale et maximale spécifiées s’appliquent à chaque publicité dans le module publicitaire, et non à la durée totale du module publicitaire. Lorsqu’une demande inclut un break-id et un paramètre maxAds , le contexte break renvoyé contient toutes les catégories IAB et tous les identifiants d’annonceur contenus dans le module publicitaire.
Une logique de plafonnement est intégrée dans un module publicitaire ; un module publicitaire ne contiendra pas deux publicités ou plus de la même vague TAP, ni deux publicités ou plus de la même catégorie IAB. Notez que vous pouvez appliquer la séparation des secteurs dans les modules publicitaires.
Notes sur l’utilisation de la catégorie IAB
Tous les paramètres suivants doivent être inclus dans la demande de publicité pour pouvoir utiliser IAB v2 et ainsi générer une impression IAB v2 pour le podcast :
guidbreak-numberbreak-idipua
Si l’un des paramètres ci-dessus n’est pas inclus, IAB v1 est utilisé.
Les valeurs IAB supérieures à 698 sont acceptées, mais seront ignorées. Utilisez plutôt le paramètre content-language dédié. Par exemple, si Triton reçoit iab-v2-cat=1068 (1068 = anglais), la langue du contenu ne sera pas définie comme l’anglais.
Contrairement au contenu diffusé où le genre du programme est statique, la catégorie de contenu (iab-v2-cat) des services de musique personnalisés est dynamique et dépend de la sélection de l’auditeur. Pour tirer parti des campagnes publicitaires qui ciblent les auditeurs en fonction de leurs préférences en matière de contenu, utilisez le paramètre iab-v2-cat dans vos requêtes publicitaires. Configurez votre lecteur pour qu’il utilise la valeur iab-v2-cat qui correspond le mieux à la sélection actuelle de l’auditeur dans la catégorie de contenu. Cela permet d’alerter les campagnes ciblées à plus forte valeur ajoutée de l’inventaire pouvant être ciblé disponible.
Remarques sur l'utilisation du positionnement dans la pause
L’utilisation du numéro de pause est étroitement liée au ciblage de la position dans la pause. Si vous n'utilisez pas ce genre de ciblage, ignorez ce paramètre.
Lors de la transmission d’un break-id et d’un break-context, la première position est automatiquement déterminée par le serveur publicitaire. Si vous n’utilisez pas break-context, vous devez utiliser break-position=first pour que la première vague diffusée cible la première position, si possible.
La dernière position sur la pause ne peut pas être déterminée par le serveur publicitaire. Même lorsque vous utilisez break-context, vous devez utiliser break-position=last pour indiquer qu’il s’agira de la dernière demande de publicité concernant cette pause particulière, afin que la dernière vague diffusée cible la dernière position, si possible.
Même si maxAds est supérieur à 1, une seule publicité renvoyée ciblera la première ou la dernière position. En outre, le nombre d'annonces renvoyées doit correspondre au nombre d'annonces demandées avant que la dernière puisse être considérée comme en dernière position. Si le serveur publicitaire renvoie moins de publicités que demandé, aucune d’entre elles ne ciblera la dernière position. Par exemple : si maxAds est fixé à 3 et que seule la première position est occupée, la dernière publicité de la pause ne sera pas diffusée.