Quels champs sont obligatoires dans une réponse d’enchère OpenRTB ?

La réponse a besoin d’un id qui renvoie celui de la requête. Chaque enchère a besoin d’un id, d’un impid correspondant à une impression, d’un prix et d’une création via adm ou nurl.

Que signifie le champ nbr ?

Motif de non-enchère. Un code entier qui explique pourquoi aucune enchère n’a été renvoyée — 2 pour requête invalide, 8 pour utilisateur inconnu — afin que la place de marché puisse en rendre compte.

Pourquoi nurl a-t-il besoin de la macro AUCTION_PRICE ?

Parce que la place de marché y substitue le prix de clôture en cas de gain. Sans la macro, la notification part sans prix et vos journaux enregistrent l’enchère au lieu du montant payé.

Quelle différence entre adm et nurl ?

adm porte la création en ligne dans la réponse ; nurl est une URL que la place de marché appelle pour la récupérer en cas de gain. L’inline domine aujourd’hui car il supprime un aller-retour.

mtype remplace-t-il quelque chose de la 2.5 ?

Il rend explicite ce qui était déduit. En 2.5 le type de média venait de l’objet porté par l’impression, ce qui échouait pour les impressions multiformats.

Validateur de réponse d’enchère OpenRTB

Contrôlez une réponse d’enchère : champs manquants, prix mal typés et macros oubliées.

Le validateur de réponse d’enchère fonctionne entièrement dans votre navigateur : les réponses portant de vrais identifiants de deal restent sur votre appareil.

Valider une requête d’enchère

À propos de Validateur de réponse d’enchère OpenRTB

La réponse d’enchère est la moitié courte du dialogue OpenRTB, et presque tout ce qui y cloche est structurel plutôt que subtil : une enchère sans impid pour la relier à une impression, un prix envoyé en chaîne, une création qui ne déclare jamais son domaine annonceur, ou une notification de gain qui oublie la macro de prix et rapporte donc un prix de clôture erroné. Ce validateur parcourt la réponse comme le ferait une place de marché, en séparant les champs exigés par la spécification de ceux que refusent en pratique acheteurs et éditeurs. Chaque constat porte un chemin JSON.

Fonctionnalités

Contrôle les champs obligatoires au niveau réponse, seatbid et enchère
Erreurs, avertissements et remarques séparés, chacun avec son chemin JSON
Vérification de type sur le prix, les dimensions, adomain et les identifiants
Traitement de mtype selon la version, apparu avec OpenRTB 2.6
Signale les notifications de gain sans macro de prix et les URL non sécurisées
Valide les réponses sans enchère et leurs codes nbr
Repère les identifiants d’enchère en double et plusieurs enchères sur la même impression
Tables de référence des motifs de non-enchère et des types de média

Comment utiliser Validateur de réponse d’enchère OpenRTB

Collez le JSON renvoyé par votre bidder
Choisissez la version du protocole de la place de marché
Traitez d’abord les erreurs, puis les avertissements
Utilisez le chemin JSON de chaque constat pour localiser l’enchère

Exemple

Entrée

{ "id": "1", "seatbid": [{ "bid": [{ "id": "b1", "impid": "1", "price": "2.15" }] }] }

Sortie

error seatbid[0].bid[0].price — price has to be a number, not a string

Un prix entre guillemets est la raison la plus fréquente d’une enchère silencieusement écartée.

Erreurs courantes et dépannage

L’enchère est valide ici mais la place de marché l’écarte quand même. — Les places de marché ajoutent leurs propres exigences : un identifiant de seat reconnu, des catégories d’une taxonomie précise ou une création déjà validée.
Un avertissement sur adomain pour une publicité maison. — Renseignez-le quand même. Les éditeurs bloquent par domaine annonceur, et une enchère sans lui est souvent écartée avant tout autre examen.
mtype est signalé sur une intégration 2.5. — Il est arrivé avec OpenRTB 2.6 et une place de marché 2.5 l’ignore. Réglez le sélecteur de version sur le protocole réellement utilisé.
Un tableau seatbid vide ne donne qu’un avertissement. — Parce que c’est légal mais peu utile. La façon propre de décliner est un HTTP 204, ou une réponse portant un code nbr.

Foire aux questions

Quels champs sont obligatoires dans une réponse d’enchère OpenRTB ?: La réponse a besoin d’un id qui renvoie celui de la requête. Chaque enchère a besoin d’un id, d’un impid correspondant à une impression, d’un prix et d’une création via adm ou nurl.
Que signifie le champ nbr ?: Motif de non-enchère. Un code entier qui explique pourquoi aucune enchère n’a été renvoyée — 2 pour requête invalide, 8 pour utilisateur inconnu — afin que la place de marché puisse en rendre compte.
Pourquoi nurl a-t-il besoin de la macro AUCTION_PRICE ?: Parce que la place de marché y substitue le prix de clôture en cas de gain. Sans la macro, la notification part sans prix et vos journaux enregistrent l’enchère au lieu du montant payé.
Quelle différence entre adm et nurl ?: adm porte la création en ligne dans la réponse ; nurl est une URL que la place de marché appelle pour la récupérer en cas de gain. L’inline domine aujourd’hui car il supprime un aller-retour.
mtype remplace-t-il quelque chose de la 2.5 ?: Il rend explicite ce qui était déduit. En 2.5 le type de média venait de l’objet porté par l’impression, ce qui échouait pour les impressions multiformats.

Outils associés

Validateur OpenRTB — Valide une bid request OpenRTB 2.5 ou 2.6 par rapport aux règles IAB.
Générateur OpenRTB — Construit une bid request OpenRTB 2.5 ou 2.6 valide depuis un formulaire.
Enums OpenRTB — Consulte chaque liste énumérée OpenRTB 2.x, code entier et signification.
Validateur VAST — Vérifie un tag VAST XML par rapport aux règles IAB dans votre navigateur.
Ad unit Prebid — Construit une config d’ad unit Prebid.js et un extrait pbjs.addAdUnits().
Générateur schain — Construit et valide l’objet IAB SupplyChain (schain) pour OpenRTB.