Emplacements publicitaires AdSense vides : lire data-ad-status et traiter proprement les espaces blancs
L'essentiel
- Une fois la requête publicitaire terminée, AdSense ajoute data-ad-status à l'élément ins avec la valeur "filled", "unfilled" ou "unfill-optimized".
- AdSense ne replie les blocs non remplis que lorsqu'ils sont hors de la fenêtre d'affichage ; les blocs non remplis visibles gardent leur taille et affichent un espace blanc.
- Google documente le sélecteur CSS ins.adsbygoogle[data-ad-status="unfilled"] avec display: none !important pour masquer les blocs non remplis.
- data-ad-status n'est ajouté qu'aux blocs présents dans la fenêtre principale, pas à ceux diffusés dans un cadre sur un autre domaine.
- Google déconseille de charger des blocs masqués pour les révéler lors d'un changement de statut, car un bloc masqué peut ne jamais envoyer de requête publicitaire.

Un emplacement AdSense non rempli est un élément <ins> dont la requête publicitaire n’a renvoyé aucune annonce. AdSense le marque avec data-ad-status="unfilled" (ou "unfill-optimized" quand le réglage “Fill empty in-page ads” est activé), ne le replie que s’il est hors de la fenêtre d’affichage, et laisse sinon une boîte vide. Vous pouvez masquer ces emplacements avec une règle CSS documentée par Google, ou afficher votre propre contenu de remplacement, à condition de ne jamais masquer des blocs qui ont diffusé une annonce.
Que vous apprend data-ad-status ?
L’article de Google Use the data-ad-status parameter to hide unfilled ad units explique qu’une fois qu’un bloc a terminé sa requête publicitaire, AdSense ajoute data-ad-status à l’élément <ins> :
| Valeur | Signification |
|---|---|
filled |
« Une annonce a été renvoyée au bloc et s’affiche maintenant. » |
unfilled |
« Aucune annonce n’a été renvoyée et le bloc est vide. » |
unfill-optimized |
Aucune annonce n’a été renvoyée et AdSense a optimisé le bloc (uniquement quand le réglage “Fill empty in-page ads” est activé) |
Ne le confondez pas avec data-adsbygoogle-status, que Google décrit comme « utilisé par notre code publicitaire pour le traitement des annonces ». Cet attribut indique que la bibliothèque a traité l’emplacement, pas si une annonce est revenue.
Vous pouvez voir la fréquence des emplacements non remplis dans vos rapports : Google renvoie à la métrique de couverture moyenne dans les rapports AdSense.
Que fait AdSense des blocs non remplis par défaut ?
D’après le même article, AdSense essaie « soit de replier le bloc, soit d’afficher un espace blanc ». Il ne replie que les blocs qui ne provoqueront pas de réagencement de la page, « c’est-à-dire uniquement les blocs situés hors de la fenêtre d’affichage ». Les blocs visibles gardent leur taille et restent vides.
Ce comportement par défaut protège la stabilité de votre mise en page. Le guide CLS de web.dev le dit de l’autre côté : « Supprimer l’espace réservé à des éléments peut causer autant de CLS qu’insérer du contenu. »
Comment masquer les blocs non remplis avec du CSS ?
La règle documentée par Google :
ins.adsbygoogle[data-ad-status="unfilled"] {
display: none !important;
}
Elle masque le <ins>, mais pas un conteneur que vous auriez ajouté pour réserver de l’espace. Si vos blocs sont dans un conteneur avec min-height, repliez aussi le conteneur :
.ad-slot:has(ins.adsbygoogle[data-ad-status="unfilled"]) {
display: none;
}
Utilisez cela avec précaution sur les emplacements visibles au chargement. Replier un emplacement que l’utilisateur regarde déplace le contenu situé en dessous, ce qui compte comme un décalage de mise en page. Une répartition plus sûre :
- Emplacements du haut de page : conservez l’espace, et affichez éventuellement un contenu neutre ou une annonce maison.
- Emplacements plus bas : repliez-les quand ils sont vides ; la requête est généralement terminée avant que l’utilisateur n’y arrive.
Le guide sur le CLS explique comment dimensionner l’espace réservé dès le départ.
Comment afficher une annonce maison à la place ?
Le second exemple de Google place votre propre lien et votre image dans le <ins>, les masque par défaut et ne les affiche que si l’emplacement est vide :
<ins class="adsbygoogle"
style="display:inline-block;width:300px;height:250px"
data-ad-client="ca-pub-0000000000000000"
data-ad-slot="1234567890">
<a href="/newsletter/"><img src="/img/newsletter-300x250.png" width="300" height="250" alt="Subscribe to our newsletter"></a>
</ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>
ins.adsbygoogle a {
display: none !important;
}
ins.adsbygoogle[data-ad-status="unfilled"] a {
display: block;
}
Faites pointer le contenu de remplacement vers vos propres contenus (lettre d’information, guide associé, produit vous appartenant). Gardez-le clairement identifié comme le vôtre : une bannière maison stylée pour ressembler à une annonce Google, ou étiquetée de façon à brouiller la frontière, se heurte aux règles de placement des annonces sur les contenus qui imitent des annonces.
Comment réagir au statut en JavaScript ?
Google cite MutationObserver comme moyen de détecter les changements de data-ad-status. Un observateur minimal qui marque le conteneur, pour que vous puissiez le styler ou le consigner :
const observer = new MutationObserver((mutations) => {
for (const m of mutations) {
const ins = m.target;
const status = ins.getAttribute("data-ad-status");
const wrapper = ins.closest(".ad-slot");
if (wrapper && status) wrapper.dataset.adStatus = status;
}
});
document.querySelectorAll("ins.adsbygoogle").forEach((ins) => {
observer.observe(ins, { attributes: true, attributeFilter: ["data-ad-status"] });
});
Utile pour l’analyse (compter les emplacements non remplis par modèle) ou pour des audits automatisés ; voir les audits de placement publicitaire avec Playwright pour contrôler le statut des emplacements à grande échelle.
Quelles sont les limites de data-ad-status ?
Google en liste deux :
- Fenêtre principale uniquement. L’attribut « n’est ajouté qu’aux blocs présents dans la fenêtre principale ». Les blocs diffusés dans un cadre sur un autre domaine ne le reçoivent pas.
- Ne chargez pas de blocs masqués. Google ne recommande pas de charger des blocs masqués pour les révéler quand le statut change : « Si des blocs ne sont pas visibles au départ sur la page, la requête publicitaire de ce bloc peut ne pas être exécutée. » Les blocs adaptatifs ont aussi besoin d’un conteneur visible pour calculer leur taille (article sur le comportement adaptatif).
Pourquoi des emplacements restent-ils non remplis ?
Google ne publie pas de répartition des causes d’emplacements non remplis, emplacement par emplacement. Passez en revue dans l’ordre les causes habituelles :
| Contrôle | À rechercher |
|---|---|
| Statut du site | Le site est-il “Ready” dans la page Sites ? Voir la signification des statuts de site. |
| Centre des règles | Diffusion restreinte ou désactivée sur le site ou la page |
| Limites de diffusion | Les comptes récents ou signalés peuvent avoir une diffusion publicitaire limitée |
| Code | data-ad-client ou data-ad-slot erroné, ou extrait du head manquant |
| Conteneur | Largeur nulle (“No slot size for availableWidth=0” dans la console) ou parent masqué |
| Contrôles de blocage | De nombreuses catégories ou annonceurs bloqués réduisent la demande |
| Demande | Certaines requêtes ne reçoivent simplement aucune annonce, plus souvent selon les pays, les appareils ou les sujets |
Quelques requêtes non remplies sont normales. Un saut soudain sur tout le site indique un changement de statut, de règles ou de code ; un schéma sur un seul modèle de page indique un problème de conteneur ou de placement.
La taille de l’annonce peut-elle elle-même causer des emplacements vides ?
Oui, de deux façons documentées.
Les tailles fixes hors des limites de Google ne s’affichent jamais. Les Guidelines for fixed-sized display ad units de Google indiquent que « toutes les annonces de taille fixe qui sortent des restrictions ci-dessous ne s’afficheront pas quand elles sont placées sur une page » :
| Restriction | Limite |
|---|---|
| Dimensions supérieures à 450 px | Une seule dimension peut dépasser 450 pixels |
| Largeur minimale | 120 pixels |
| Hauteur minimale | 50 pixels |
| Maximum | Aucune dimension ne peut dépasser 1200 pixels |
La même page avertit que « certaines tailles fixes, comme 120x60, peuvent n’avoir aucun inventaire d’annonces display disponible ». Une taille rare peut laisser un emplacement vide même si elle est valide. Si vous avez besoin d’une taille fixe, utilisez une taille courante, ou passez à un bloc adaptatif, que Google recommande de toute façon pour les designs adaptatifs.
Les blocs adaptatifs sans largeur ne reçoivent aucune annonce. Quand le code adaptatif mesure l’emplacement à une largeur nulle, la console affiche adsbygoogle.push() error: No slot size for availableWidth=0. La FAQ sur les formats publicitaires de Google explique que le code se trouve « dans un conteneur parent sans largeur explicite », et que la solution consiste à « définir la largeur du conteneur parent ou à rendre le bloc de taille fixe ». Cela arrive souvent dans les mises en page flex ou grid, les accordéons fermés, les onglets et les menus hors écran. L’article de Google sur le comportement adaptatif liste les autres problèmes de conteneur.
Notez la différence avec un statut non rempli : un emplacement de largeur nulle échoue avant toute requête publicitaire et peut donc ne jamais recevoir de valeur data-ad-status. Contrôlez la console autant que l’attribut.
Comment suivre les emplacements non remplis dans le temps ?
Deux vues complémentaires :
- Les rapports AdSense. L’article de Google sur data-ad-status renvoie à la métrique de couverture moyenne, qui reflète la fréquence à laquelle les requêtes publicitaires renvoient des annonces. Ventilez-la par bloc pour trouver ceux qui se remplissent le moins, et par pays ou plateforme pour voir si la demande varie.
- Vos propres journaux. Le
MutationObserverci-dessus peut envoyer un événement par emplacement avec le modèle, l’identifiant du bloc et le statut. Vous voyez ainsi quels types de pages et quelles positions restent vides, ce que les rapports par bloc ne montrent pas si un même bloc est réutilisé sur plusieurs modèles.
Cherchez des tendances plutôt que des événements isolés. Un emplacement parfois non rempli demande un style de repli ; un emplacement non rempli sur la plupart des affichages demande une autre position, une autre taille ou un autre bloc.
Erreurs courantes
- Cibler
data-adsbygoogle-statuspour masquer les emplacements vides. Il marque le traitement, pas le remplissage. Utilisezdata-ad-status. - Attendre de la règle CSS qu’elle masque les blocs
unfill-optimized. Google indique que la technique ne fonctionne que sur les blocs qu’AdSense n’a pas optimisés. - Masquer des blocs qui ont diffusé. La règle sur la modification du code n’autorise pas à masquer des blocs, hors de la méthode documentée des media queries pour les blocs adaptatifs.
- Replier des emplacements au-dessus de la ligne de flottaison. Cela remplace une boîte vide par un décalage de mise en page.
- Cliquer ou recharger pour « tester » le remplissage. Utilisez les outils d’aperçu et les rapports plutôt que d’interagir avec vos propres annonces.
Questions fréquentes
Que signifie data-ad-status="unfill-optimized" ?
Cela signifie qu'aucune annonce n'a été renvoyée pour le bloc et qu'AdSense a ensuite optimisé l'emplacement vide. Cette valeur n'apparaît que lorsque le réglage "Fill empty in-page ads" est activé. Google note que la technique CSS pour masquer les blocs non remplis ne fonctionne que sur les blocs qu'AdSense n'a pas optimisés : une règle ciblant "unfilled" ne les masquera donc pas.
Masquer les blocs non remplis est-il contraire aux règles d'AdSense ?
Non. L'article d'aide de Google montre lui-même du CSS qui applique display: none !important à ins.adsbygoogle[data-ad-status="unfilled"]. Ce que la règle sur la modification du code interdit, c'est de masquer des blocs qui diffusent des annonces, par exemple avec display: none, hors de l'exception documentée des media queries pour les blocs adaptatifs. Masquer un emplacement vide ne masque aucune annonce.
Pourquoi mes emplacements sont-ils vides sur un nouveau site ?
Des emplacements vides sont normaux tant que le site n'est pas prêt ou approuvé, quand la diffusion des annonces est limitée, ou quand il n'y a pas de demande pour la requête. Vérifiez d'abord le statut du site et le Centre des règles. Si tout est en ordre, comparez le taux de couverture dans vos rapports sur plusieurs jours ; quelques requêtes sans annonce sont attendues et ne signalent pas une erreur de code.
Puis-je afficher ma propre bannière quand AdSense n'a pas d'annonce ?
Oui. L'article de Google sur data-ad-status montre une annonce maison : un lien image placé dans l'élément ins, masqué par défaut en CSS et affiché uniquement quand data-ad-status vaut "unfilled". Veillez à ce que cette annonce maison ne puisse pas être confondue avec une annonce Google et n'imite pas le style publicitaire, et ne chargez pas de blocs masqués pour les révéler plus tard.
Sources
- Use the data-ad-status parameter to hide unfilled ad units · Google AdSense Help
- Modifications of AdSense ad code · Google AdSense Help
- Guidelines for fixed-sized display ad units · Google AdSense Help
- Ad formats FAQ · Google AdSense Help
- Optimize Cumulative Layout Shift · web.dev
Guides liés
- Comment éviter le décalage de mise en page (CLS) dû aux annonces AdSense en réservant l'espace des emplacements
Empêcher AdSense de décaler la mise en page : réserver l'espace avec min-height ou des tailles CSS fixes, gérer les emplacements vides et les annonces auto.
- « La diffusion des annonces a été limitée » : comment fonctionnent les limites de diffusion AdSense et ce que vous pouvez faire
« La diffusion des annonces a été limitée » : les deux causes citées par Google, pourquoi les nouveaux comptes la voient, la durée habituelle et les actions utiles.
- États des sites AdSense expliqués : ce que signifie chaque état de la page Sites et quoi faire
Sens de « Examen requis », « Préparation », « Attention requise » et « Prêt » sur la page Sites d'AdSense, colonne ads.txt et prochaine étape.
- Audit automatisé des emplacements publicitaires avec Playwright : captures, nombre de blocs et statut de remplissage
Auditez vos emplacements AdSense avec Playwright sans demander d'annonces : comptez les blocs, vérifiez les hauteurs réservées et ads.txt, capturez le mobile.
- Blocs d'annonces adaptatifs AdSense : data-ad-format, annonces pleine largeur sur mobile et dimensionnement CSS
Comment les blocs display adaptatifs d'AdSense se dimensionnent, ce que font data-ad-format et data-full-width-responsive, et les changements CSS autorisés.