Codes de réponse HTTP
Code | Message | Description |
---|---|---|
200 | OK | Succès. La réponse peut contenir une publicité ou non. |
400 | Bad Request | Un des paramètres est absent ou contient une valeur non valide (par ex. : l'identifiant de placement n'existe pas). |
404 | Not Found | La terminaison appelée est incorrecte. |
Les autres erreurs HTTP standard, telles que
500 Internal Server Error
, ou405 Method Not Allowed
, peuvent également être retournées. Les applications doivent gérer les codes de réponse HTTP conformément aux conventions standard, telles que décrites dans le protocole w3.org RFC9110.
200 - Réponse publicitaire
Lors du retour d’une publicité, le corps de la réponse contiendra un fichier VAST Inline.
La publicité renvoyée par le service de demande de publicité de diffusion est conforme à VAST. (Voir la dernière spécification VAST de l’IAB.)
Le contenu réel de chaque fichier VAST renvoyé dépend du gestionnaire de contenu créatif utilisé par l’acheteur. Votre analyseur doit donc ignorer les champs qu’il ne reconnaît pas ou qu’il ne peut pas traiter.
L’identifiant du partenaire qui a renvoyé la publicité, ainsi que l’identifiant du contenu créatif renvoyé par le partenaire, sont fournis dans l’en-tête HTTP suivant : x-creative-id:
Lorsque l’approbation du contenu créatif est utilisée, cet identifiant peut être utilisé à la place de l’analyse du fichier VAST.
Lorsque l’approbation du contenu créatif n’est pas utilisée, l’appelant doit aller chercher le contenu auprès de l’un des <MediaFile>
éléments.
Dans les deux cas, le fichier VAST doit être stocké, car il sera nécessaire lors de la confirmation de la lecture instantanée (voir la section ci-dessous).
200 - Pas de réponse publicitaire
Si le service de demande de publicité de diffusion n’a pas de publicité disponible correspondant aux paramètres de la demande, il renverra tout de même un code de réponse 200 OK
et un fichier VAST, mais sans élément <Ad>
. Au lieu de cela, un paramètre facultatif <Error>
peut être inclus dans le fichier, comme :
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<VAST version=" 4.3">
<Error>
<![CDATA[http://adserver.com/?dur=[TD_DURATION]>
</Error>
</VAST>
Le
<Error>
est facultatif et est utilisé pour la prévision de l’inventaire numérique. La prévision n’est pas prise en charge pour la diffusion pour le moment, cet élément peut donc être ignoré.