Prebid.js et header bidding : fonctionnement et points à connaître pour un éditeur AdSense
L'essentiel
- Prebid.js est une bibliothèque libre et gratuite (Apache-2.0) qui exécute une enchère de header bidding dans le navigateur avant l'appel au serveur publicitaire ; la version 11.51.0 était la dernière sur npm en novembre 2026.
- Dans la configuration habituelle, Prebid.js transmet les offres gagnantes à un serveur publicitaire comme Google Ad Manager sous forme de paires clé-valeur (hb_pb et clés associées), et le serveur publicitaire prend la décision finale.
- Cette configuration exige des line items du serveur publicitaire ciblés sur des tranches de prix, ce qui explique que la documentation de Prebid soit écrite autour des serveurs publicitaires et ne mentionne pas AdSense.
- Prebid existe aussi côté serveur sous le nom de Prebid Server, disponible en versions Go et Java.
- Savoir si et comment le header bidding peut fonctionner à côté d'AdSense sur une même page relève des règles de Google ; consultez le Centre d'aide AdSense et votre contrat plutôt que des conseils de tiers.

Prebid.js est une bibliothèque JavaScript libre et gratuite qui exécute une enchère de header bidding dans le navigateur de votre visiteur : plusieurs partenaires de demande enchérissent en même temps, avant l’appel au serveur publicitaire, et les meilleures offres sont transmises à ce dernier pour concourir avec le reste de votre demande. Elle est conçue autour de serveurs publicitaires comme Google Ad Manager, pas autour d’AdSense seul.
Quel problème le header bidding résout-il ?
Sans header bidding, un serveur publicitaire appelle les partenaires de demande l’un après l’autre, dans un ordre de priorité fixe (la « cascade », ou waterfall). Un partenaire situé plus bas dans la chaîne n’a jamais l’occasion de surenchérir sur un partenaire placé plus haut. Le header bidding interroge plusieurs partenaires à la fois et met leurs offres en concurrence en temps réel.
L’introduction de Prebid décrit Prebid comme un ensemble d’outils libres et gratuits qui collecte les offres avant l’appel au serveur publicitaire, après quoi ce dernier prend la décision finale ; Prebid peut aussi constituer la couche de décision complète. Prebid existe sous deux formes principales :
- Prebid.js, qui s’exécute dans le navigateur.
- Prebid Server, qui exécute l’enchère sur un serveur, disponible en versions Go et Java. Il sert pour les applications, AMP, la vidéo et pour déporter le travail d’enchère hors de la page.
Le projet est maintenu par Prebid.org, et le code de Prebid.js est sur GitHub sous licence Apache 2.0. La version 11.51.0 était la dernière publiée sur npm au moment de la rédaction de ce guide.
Comment Prebid.js fonctionne-t-il sur une page ?
La présentation de Prebid.js et la page d’intégration aux serveurs publicitaires décrivent le déroulement habituel :
- La page définit des blocs publicitaires (ad units) : un code d’emplacement, ses tailles ou son type de média, et une liste d’enchérisseurs (bidders) avec leurs paramètres (fournis par chaque partenaire).
- Prebid.js envoie des demandes d’offres à tous les enchérisseurs en parallèle et attend leur réponse ou l’expiration d’un délai d’attente (timeout).
- Prebid.js définit des paires clé-valeur sur la requête au serveur publicitaire, par exemple la tranche de prix de la meilleure offre (
hb_pb) et le code de l’enchérisseur. - Le serveur publicitaire exécute sa propre décision. Les line items ciblés sur ces paires clé-valeur sont en concurrence avec les accords directs et la demande restante.
- Si un line item Prebid l’emporte, le serveur publicitaire renvoie un signal indiquant à Prebid.js d’écrire la création gagnante dans la page.
La présentation décrit aussi les trois composantes de la bibliothèque : un noyau léger, des adaptateurs (plus de 300 adaptateurs d’enchérisseurs, chacun maintenu par l’entreprise à laquelle il se connecte, plus des adaptateurs d’analyse) et des modules facultatifs.
La page d’intégration aux serveurs publicitaires présente deux schémas : le serveur publicitaire décide à partir des paires clé-valeur de Prebid (le cas courant), ou le serveur publicitaire enchérit lui-même dans Prebid. Elle qualifie Google Ad Manager de serveur publicitaire « actuellement le plus utilisé ». Le premier schéma exige un ciblage par clé-valeur et un grand nombre de line items, un par tranche de prix, que les équipes d’ad ops créent généralement avec des outils.
Une page minimale, tirée de l’exemple officiel
L’exemple de base de Prebid.js relie un emplacement Google Ad Manager à un enchérisseur. Voici sa logique centrale, abrégée ; le chemin d’emplacement et les paramètres de l’enchérisseur sont des valeurs de test de l’exemple et ne fonctionneront pas sur votre site :
var PREBID_TIMEOUT = 700;
var adUnits = [{
code: '/19968336/header-bid-tag-1',
mediaTypes: { banner: { sizes: [[300, 250]] } },
bids: [{ bidder: 'msft', params: { placement_id: 'XXXXXXX' } }]
}];
var googletag = googletag || {};
googletag.cmd = googletag.cmd || [];
googletag.cmd.push(function () { googletag.pubads().disableInitialLoad(); });
var pbjs = pbjs || {};
pbjs.que = pbjs.que || [];
pbjs.que.push(function () {
pbjs.addAdUnits(adUnits);
pbjs.requestBids({ bidsBackHandler: initAdserver });
});
function initAdserver() {
if (pbjs.initAdserverSet) return;
pbjs.initAdserverSet = true;
googletag.cmd.push(function () {
pbjs.que.push(function () {
pbjs.setTargetingForGPTAsync();
googletag.pubads().refresh();
});
});
}
setTimeout(initAdserver, PREBID_TIMEOUT);
Rôle de chaque partie :
disableInitialLoad()empêche Google Publisher Tag de demander des annonces avant la fin de l’enchère.pbjs.quemet des commandes en file d’attente jusqu’au chargement de la bibliothèque, commegoogletag.cmd.requestBids()lance l’enchère. Selon la référence de requestBids,bidsBackHandlers’exécute quand toutes les offres sont revenues ou que le délai expire, et untimeoutfacultatif peut être défini par appel.setTargetingForGPTAsync()copie les paires clé-valeur de Prebid sur les emplacements GPT, puisrefresh()appelle le serveur publicitaire.- Le
setTimeoutest une sécurité : le serveur publicitaire est appelé même si Prebid ne répond jamais.
L’exemple précise qu’il charge depuis le CDN de Prebid une version de test de Prebid.js qui n’est pas destinée à la production. En production, vous compilez votre propre fichier contenant uniquement les adaptateurs d’enchérisseurs et les modules dont vous avez besoin, depuis la page de téléchargement de Prebid ou depuis les sources.
Ce qu’il faut avant que cela ait un sens
Le header bidding n’est pas un script que l’on colle puis que l’on oublie. Le guide de démarrage de Prebid invite les développeurs à planifier avec leur équipe d’ad ops : envoyer toutes les offres ou seulement la meilleure, quelle granularité de prix retenir, et quelles paires clé-valeur le serveur publicitaire exige. En pratique, il faut :
| Prérequis | Raison |
|---|---|
| Un serveur publicitaire (par exemple Google Ad Manager) | quelque chose doit comparer les offres Prebid au reste de la demande |
| Des line items par tranche de prix | c’est ainsi que le serveur publicitaire « voit » une offre Prebid |
| Des comptes chez chaque enchérisseur (SSP) | chacun fournit les params de son adaptateur |
| Une configuration du consentement | Prebid.js prend en charge le RGPD (GDPR) par des modules de gestion du consentement (par exemple consentManagementTcf), et les enchérisseurs lisent ces signaux |
| Des entrées ads.txt et sellers.json pour chaque partenaire | les acheteurs vérifient la chaîne d’approvisionnement |
| Une maintenance continue | adaptateurs, modules et noyau évoluent souvent |
Si vous n’utilisez qu’AdSense aujourd’hui, l’étape qui précède Prebid est généralement un serveur publicitaire. Voir AdSense ou Ad Manager pour ce qui change en passant à Ad Manager.
Et le header bidding avec AdSense sur la même page ?
C’est la question que se posent la plupart des éditeurs AdSense, et c’est une question de règles de Google, pas de Prebid. Le Centre d’aide AdSense n’a pas pu être consulté lors de la rédaction de ce guide : les règles actuelles de Google sur l’affichage d’AdSense à côté d’autres régies ou de demande en header bidding ne peuvent donc pas être citées, et elles ne sont pas énoncées ici.
Ce que montre la documentation de Prebid est plus restreint :
- Ses pages d’intégration aux serveurs publicitaires couvrent Google Ad Manager, Xandr, Freewheel et Smart, avec une configuration pas à pas pour chacun.
- AdSense n’y est pas mentionné, et AdSense n’a ni line items ni ciblage par clé-valeur que Prebid pourrait utiliser.
Avant de diffuser une autre demande sur des pages contenant AdSense, lisez les règles du programme AdSense et les articles du Centre d’aide de Google sur les autres régies publicitaires et sur le placement des annonces, et conservez une trace de ce que vous avez lu et de la date. Vérifiez aussi que chaque partenaire ajouté figure dans votre fichier ads.txt avec le bon compte vendeur, et que vous comprenez comment sellers.json vous référence.
Comment déboguer une installation Prebid.js ?
Le guide de dépannage donne l’essentiel :
- Version : saisissez
pbjs.versiondans la console du navigateur. - Messages de débogage : ajoutez
pbjs_debug=trueà l’URL de la page, par exemple/article.html?pbjs_debug=true. Prebid.js supprime normalement les erreurs JavaScript pour ne pas casser la page ; le mode débogage les expose et ajoute des messages que vous pouvez filtrer parMESSAGE:. - Offres reçues : l’API éditeur comprend
pbjs.getBidResponses(),pbjs.getHighestCpmBids()etpbjs.getAllWinningBids()pour inspecter ce qui est revenu et ce qui a gagné.
Limitez le débogage à vos propres sessions de navigation. Ne cliquez pas sur les annonces pendant les tests.
Performances et contreparties sur les données
Le header bidding ajoute du travail avant l’affichage des annonces : du JavaScript supplémentaire, des requêtes parallèles vers chaque enchérisseur, des modules d’identifiants utilisateur si vous les activez, et un délai d’attente. L’exemple ci-dessus utilise 700 ms ; quelle que soit votre valeur, elle retarde l’appel au serveur publicitaire d’autant au maximum.
Règles pratiques :
- Commencez avec peu d’enchérisseurs et n’en ajoutez que s’ils gagnent assez souvent pour justifier leurs requêtes.
- Mesurez le coût en laboratoire avec des exécutions Lighthouse avec et sans annonces et l’impact en conditions réelles avec vos propres données d’utilisateurs réels.
- Réservez l’espace de chaque emplacement, car une enchère tardive rend un décalage de mise en page plus probable.
- Passez en revue les modules d’identité et d’analyse inclus dans votre compilation, car chacun peut exiger une information et un consentement.
L’ampleur de l’utilisation de Prebid se constate avec des données publiques : l’exploration de HTTP Archive détecte une technologie « Prebid », que vous pouvez interroger comme décrit dans étudier l’ad tech avec HTTP Archive.
Erreurs fréquentes
- Livrer la version de test du CDN. Compilez votre propre fichier avec les seuls adaptateurs que vous utilisez.
- Aucun délai de sécurité. Si Prebid échoue, le serveur publicitaire doit tout de même être appelé.
- Lignes ads.txt manquantes pour les nouveaux partenaires : les acheteurs traitent alors l’inventaire comme non autorisé.
- Trop d’enchérisseurs. Davantage de requêtes ne signifie pas davantage de revenus au-delà d’un certain point ; mesurez.
- Se fier aux règles lues dans des articles de blog. Consultez la documentation de Google pour tout ce qui touche aux règles AdSense ou Ad Manager.
Outils open source cités
| Outil | Licence |
|---|---|
| Prebid.js | Apache-2.0 |
Questions fréquentes
Peut-on utiliser Prebid.js avec AdSense seul, sans serveur publicitaire ?
La documentation de Prebid décrit des intégrations avec des serveurs publicitaires comme Google Ad Manager, Xandr, Freewheel et Smart, où des line items sont mis en concurrence avec les offres Prebid. AdSense n'est pas un serveur publicitaire et n'est pas couvert par ces pages. Prebid peut aussi servir de couche de décision complète, mais c'est une configuration avancée. Vérifiez les règles de Google sur la diffusion d'autres annonces à côté d'AdSense avant d'essayer.
Le header bidding augmente-t-il les revenus ?
Il le peut, car davantage d'acheteurs se font concurrence pour chaque impression, mais personne ne peut promettre un chiffre pour votre site. Il ajoute aussi du JavaScript, des requêtes réseau et un délai d'attente avant l'affichage des annonces, ce qui peut coûter en vitesse de page et en visibilité. Mesurez les revenus pour mille pages vues et les Core Web Vitals avant et après, sur un trafic comparable, plutôt que de vous fier aux études de cas des fournisseurs.
Qu'est-ce que la clé-valeur hb_pb ?
C'est la tranche de prix de l'offre Prebid gagnante, transmise au serveur publicitaire comme ciblage. Le serveur publicitaire a des line items configurés pour chaque tranche de prix, et celui dont la tranche correspond peut remporter l'impression. Prebid envoie aussi des clés par enchérisseur, comme hb_pb_BIDDERCODE, quand vous transmettez toutes les offres au lieu de la seule meilleure.
Prebid.js est-il gratuit ?
Oui. Prebid.js est un logiciel libre sous licence Apache 2.0, d'utilisation gratuite. Ce qui coûte de l'argent ou du temps, c'est tout ce qui l'entoure : le serveur publicitaire, les contrats avec chaque enchérisseur (SSP), le travail d'ad ops pour créer les line items, et l'ingénierie nécessaire pour maintenir à jour la compilation, les modules de consentement et les adaptateurs d'enchérisseurs.
Sources
- What is Prebid.js? · Prebid.org
- Introduction to Prebid · Prebid.org
- Ad Server Integration · Prebid.org
- Basic Prebid.js Example · Prebid.org
- Prebid.js Troubleshooting Guide · Prebid.org
Guides liés
- AdSense ou Google Ad Manager : quand un éditeur dépasse AdSense, et ce qui change s'il passe à l'autre
AdSense ou Google Ad Manager ? Rôle de chaque produit, éligibilité, ventes directes, tags, enchères, et signes que AdSense ne vous suffit plus.
- Spécifications IAB Tech Lab et IAB Europe : ce qu'un éditeur AdSense doit savoir
Quelles normes comptent pour un éditeur AdSense : ads.txt 1.1, sellers.json, SupplyChain, OpenRTB, TCF et GPP, avec les versions actuelles et ce qu'elles exigent.
- Le sellers.json de Google pour les éditeurs AdSense : visibilité des informations vendeur et ce que voient les acheteurs
Ce que le sellers.json de Google dit de votre compte AdSense, le réglage de visibilité des informations vendeur et comment retrouver votre entrée.
- HTTP Archive et Web Almanac : données ouvertes sur les scripts publicitaires, ads.txt et le poids des pages
Mesurez l'adoption d'ads.txt, l'usage de l'ad tech et le poids des scripts tiers sur des millions de sites avec HTTP Archive, le Web Almanac et du SQL adaptable.