Point de terminaison HTTP
Le service de demande de publicité de diffusion est disponible via un point d’entrée public HTTP/HTTPS :
//<broadcast-ad-server-host>/broadcast/ars?<query parameters>
Veuillez contacter l’assistance client de Triton Digital pour obtenir le nom d’hôte correct à utiliser pour les utilisations de pré-production et de production.
Un exemple complet, avec de nombreux paramètres disponibles, ressemblerait à ceci :
https://broadcast.live.streamtheworld.com/broadcast/ars?stid=12345&qty=35800&qtysourceid=1&qtysource=Nielsen
Paramètres
Cette section décrit les paramètres de chaîne de requête disponibles lors de l’utilisation du service de demande de publicité de diffusion.
Il existe deux types de demandes, comme décrit ci-dessous.
Demande d’enchère :
Ceci est fait lorsqu’une enchère doit être exécutée au niveau du marché. Triton sélectionne automatiquement les offres de marchés privés qui s’appliquent. Les catégories de publicité spécifiques qui ne peuvent pas être diffusées doivent être fournies lors de l’appel afin d’éviter que Triton ne renvoie une publicité qui sera abandonnée en raison d’une séparation des secteurs. Cette demande est déclenchée lorsque aucun identifiant de transaction n’est fourni.
Demande programmatique garantie :
Cela se fait lorsqu’une offre programmatique garantie est sur le point d’être diffusée. Triton contacte le partenaire de demande approprié (et uniquement ce partenaire) pour l’accord. Cette demande est déclenchée lorsqu’un identifiant d’offre est fourni.
Vous ne devez envoyer un paramètre de requête que si vous souhaitez spécifiquement transmettre une valeur pour ce paramètre. Si vous ne souhaitez pas transmettre de valeur, n’envoyez pas le paramètre requête.
Les paramètres doivent être fournis dans la chaîne de requête de l’URL du point de terminaison.
Name | Description | Format |
|---|---|---|
stid | Identifiant Triton de la station de placement. Ce paramètre est obligatoire. | Chiffre entier |
ext2_stid | Identifiant externe de la station. Ce paramètre est requis si | Chaîne |
qty | Nombre d’utilisateurs écoutant le contenu dans lequel la publicité sera diffusée, selon la mesure d'audience. Ce paramètre est obligatoire. | Flottant |
qté-type | Le type de source de la mesure de quantité. Ce paramètre est obligatoire. | Entier (énumération) 1 : Mesures fournies par le vendeur 2 : Fourni par l’éditeur |
qté-fournisseur | Le nom de domaine professionnel du vendeur de mesure fournissant la mesure de quantité (le domaine d’entreprise est l’étiquette de niveau supérieur après le domaine de premier niveau effectif) (p. ex., « nielsen.com ») Ce paramètre est obligatoire. | Chaîne |
identifiant-offre | Identifiant d’une offre de programmatique garantie existante pour laquelle la publicité est sollicitée. Si elle est fournie, la demande sera limitée au DSP et à l’acheteur spécifiés dans l’offre. Si elle n’est pas fournie, la demande déclenche une enchère. | Chaîne |
catégories iab exclues | Liste des catégories de publicités NON autorisées pour l'annonce demandée. La taxonomie actuellement utilisée est IAB Content Taxonomy v1. | Liste de codes de catégorie séparés par des virgules (chaîne). |