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.

Conçu et maintenu par Udit Agarwal

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

  1. Collez le JSON renvoyé par votre bidder
  2. Choisissez la version du protocole de la place de marché
  3. Traitez d’abord les erreurs, puis les avertissements
  4. 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.

Plus d’outils Publicité Programmatique

  • Validateur VAST — Vérifie un tag VAST XML par rapport aux règles IAB dans votre navigateur.
  • Inspecteur VAST — Analyse un tag VAST XML et détaille structure, fichiers média et URL de suivi.
  • Codes d’erreur VAST — Recherche le sens et la correction de chaque code d’erreur IAB VAST et VPAID.
  • Macros VAST — Développe les macros IAB VAST 4.x d’une URL de suivi et prévisualise la requête.
  • Validateur VMAP — Valide les coupures VMAP et les place sur une chronologie pre/mid/post-roll.
  • 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.
  • Décodeur TCF — Décode une chaîne de consentement IAB TCF v2.2 en champs lisibles.
  • Décodeur GPP — Décode une chaîne IAB GPP : en-tête, gpp_sid et chaque section intégrée.
  • Décodeur US Privacy — Décode la chaîne US Privacy (CCPA) de 4 caractères en langage clair.
  • Encodeur TCF — Construit une chaîne de consentement IAB TCF v2.2 depuis les réglages CMP.

Voir tous les outils Publicité Programmatique (23) · Tous les outils