Code et intégration

Blocs d'annonces adaptatifs AdSense : data-ad-format, annonces pleine largeur sur mobile et dimensionnement CSS

Mis à jour le Publié le Par la rédaction7 min4 sources

L'essentiel

  • Les blocs display AdSense sont adaptatifs par défaut et calculent leur taille à partir de la largeur du conteneur parent et de l'écran de l'utilisateur.
  • data-ad-format vaut "auto" par défaut et peut prendre "rectangle", "vertical", "horizontal" ou une combinaison séparée par des virgules, ce qui oriente la forme de l'annonce sur ordinateur uniquement.
  • data-full-width-responsive="true" permet au bloc de s'étendre plus souvent à toute la largeur de l'écran sur mobile en mode portrait ; "false" l'en empêche, ce qui peut réduire les gains selon Google.
  • Google documente des modifications CSS par media queries pour fixer des tailles exactes selon la largeur d'écran ou masquer un bloc sur les petits écrans, et ce sont des modifications de code acceptables.
  • Quand vous dimensionnez ou masquez un bloc adaptatif avec du CSS, Google demande de supprimer les lignes data-ad-format et data-full-width-responsive.
Un élève qui travaille sur un ordinateur de bureau
Image: Student on computer,woodleywonderworks,CC BY 2.0,via Wikimedia Commons.

Un bloc display adaptatif d’AdSense se dimensionne à partir de la largeur de son conteneur parent et de l’écran de l’utilisateur. Deux attributs le contrôlent : data-ad-format ("auto" par défaut, ou une forme comme "horizontal") et data-full-width-responsive (le bloc peut-il passer en pleine largeur sur mobile). Si vous voulez des tailles exactes par point de rupture, Google documente une version du code avec media queries CSS, qui est une modification approuvée.

À quoi ressemble le code adaptatif par défaut ?

Quand vous créez un bloc display et laissez “Responsive” sélectionné, AdSense génère un code comme celui-ci (valeurs fictives) :

<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-0000000000000000"
     crossorigin="anonymous"></script>
<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-0000000000000000"
     data-ad-slot="1234567890"
     data-ad-format="auto"
     data-full-width-responsive="true"></ins>
<script>
     (adsbygoogle = window.adsbygoogle || []).push({});
</script>

L’article de Google sur le comportement adaptatif énumère ce que fait ce code :

  • Dimensionnement automatique : « Nous calculons dynamiquement la taille nécessaire selon l’espace disponible et la taille de l’écran de l’utilisateur. »
  • Changements d’orientation : si la mise en page change quand un téléphone ou une tablette pivote, AdSense demande et charge une nouvelle annonce de la bonne taille. Si l’appareil revient à l’orientation initiale, l’annonce d’origine est de nouveau affichée depuis le cache. Google note que ces requêtes supplémentaires « peuvent entraîner une légère baisse du RPM et du CTR », sans effet négatif sur le revenu global.
  • Annonces pleine largeur sur mobile : les blocs s’étendent à toute la largeur de l’écran quand l’appareil est en orientation portrait, « uniquement … quand elles ont de bonnes chances de bien performer ».

Quelles valeurs data-ad-format peut-il prendre ?

D’après How to use responsive ad tag parameters :

Valeur Effet
"auto" (par défaut) Dimensionnement automatique selon l’espace disponible
"horizontal" Forme générale horizontale
"vertical" Forme générale verticale
"rectangle" Forme générale rectangulaire
Combinaison, par exemple "rectangle, horizontal" N’importe laquelle des formes listées

Google indique que le réglage de forme vaut pour « ordinateur uniquement » (desktop only). Sur mobile, le bloc s’adapte toujours au conteneur. D’autres valeurs que vous rencontrerez dans le code généré, comme "fluid" pour les blocs in-feed et in-article ou "autorelaxed" pour Multiplex, appartiennent à ces types de blocs : ne les collez pas dans un bloc display. Le guide sur les annonces In-article, In-feed et Multiplex les détaille.

Exemple, un bloc horizontal pour un en-tête ou un emplacement sous l’article :

<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-0000000000000000"
     data-ad-slot="1234567890"
     data-ad-format="horizontal"></ins>

Que change data-full-width-responsive ?

Réglage Comportement sur mobile Remarque de Google
"true" S’étend plus souvent à toute la largeur de l’écran Recommandé, « potentiel maximal d’augmentation des revenus »
"false" Ne s’étend jamais automatiquement en pleine largeur « vous pouvez réduire vos gains potentiels »
Attribut absent S’étend encore dans certains cas, moins souvent que "true"

La pleine largeur signifie que l’annonce peut dépasser la marge intérieure de votre colonne de contenu jusqu’aux bords de l’écran. Réglez "false" là où cela entrerait en conflit avec votre design, par exemple dans des cartes, des grilles ou à côté d’un élément fixe.

Comment définir des tailles exactes selon la largeur d’écran ?

L’article de Google How to modify your responsive ad code fournit une version CSS, expressément listée comme modification acceptable. Adaptée avec des valeurs fictives :

<style>
  .ad_header_1 { width: 320px; height: 100px; }
  @media (min-width: 500px) { .ad_header_1 { width: 468px; height: 60px; } }
  @media (min-width: 800px) { .ad_header_1 { width: 728px; height: 90px; } }
</style>
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-0000000000000000"
     crossorigin="anonymous"></script>
<ins class="adsbygoogle ad_header_1"
     style="display:block"
     data-ad-client="ca-pub-0000000000000000"
     data-ad-slot="1234567890"></ins>
<script>
     (adsbygoogle = window.adsbygoogle || []).push({});
</script>

Règles tirées de l’article de Google :

  1. Partez d’un bloc display créé avec “Responsive” sélectionné.
  2. Donnez à la classe un nom unique composé uniquement de lettres anglaises, de chiffres et de tirets bas, commençant par une lettre, et utilisez un nom différent chaque fois que vous adaptez l’exemple.
  3. Supprimez data-ad-format="auto" et data-full-width-responsive="true" du <ins>.
  4. Gardez le bloc <style> dans la page. Google précise que « définir la taille du bloc par du CSS dans des feuilles de style externes n’est pas officiellement pris en charge ».
  5. Testez sur plusieurs appareils et largeurs d’écran.

Cette version est la plus prévisible pour la stabilité de la mise en page, car l’emplacement a sa taille définitive avant l’arrivée de l’annonce. C’est le principe de la réservation d’espace pour éviter le CLS.

Largeur extensible, hauteur fixe

Google documente aussi une bannière à largeur fluide et hauteur fixe, définie en ligne :

<ins class="adsbygoogle"
     style="display:block;min-width:400px;max-width:970px;width:100%;height:90px"
     data-ad-client="ca-pub-0000000000000000"
     data-ad-slot="1234567890"></ins>

Puis-je masquer un bloc sur les petits écrans ?

Oui, avec une media query, et uniquement ainsi. L’exemple de Google :

<style>
  .ad_sidebar_1 { display: block; width: 320px; height: 50px; }
  @media (max-width: 400px) { .ad_sidebar_1 { display: none; } }
  @media (min-width: 500px) { .ad_sidebar_1 { width: 468px; height: 60px; } }
  @media (min-width: 800px) { .ad_sidebar_1 { width: 728px; height: 90px; } }
</style>
<ins class="adsbygoogle ad_sidebar_1"
     data-ad-client="ca-pub-0000000000000000"
     data-ad-slot="1234567890"></ins>

Google indique que cela fait en sorte qu’« aucune requête publicitaire ne soit faite et qu’aucune annonce ne s’affiche » en dessous de 400 px. Là encore, supprimez data-ad-format et data-full-width-responsive.

Masquer reste une exception étroite. La règle sur la modification du code range le fait de masquer des blocs à tout moment, par exemple avec display:none, parmi les changements non autorisés, avec les blocs adaptatifs comme exception. Masquer avec JavaScript après le chargement de l’annonce, ou masquer des blocs qui ont déjà diffusé, sort de cette exception.

Faut-il plutôt utiliser un bloc de taille fixe ?

Les Guidelines for fixed-sized display ad units de Google décrivent le compromis. Les blocs de taille fixe « ne changent pas dynamiquement de taille et ne réagissent pas aux changements d’orientation de l’écran », et « si votre site utilise un design adaptatif, nous recommandons d’utiliser plutôt un bloc display adaptatif ». Les tailles fixes se justifient quand vous avez besoin d’un cadre exact pour votre mise en page ou d’une taille régionale très répandue sur votre marché.

Les tailles fixes ont aussi des limites strictes : une seule dimension au-dessus de 450 pixels, un minimum de 120 pixels de large et 50 pixels de haut, et rien au-delà de 1200 pixels. Les blocs hors de ces limites ne s’affichent pas du tout.

Même un bloc fixe peut diffuser une taille différente. La FAQ sur les formats publicitaires nomme deux fonctions responsables : “Similar sized display ads” et “Ad size optimization”, qui permet à Google d’optimiser la taille des blocs sur mobile. Les deux peuvent être désactivées, la seconde sous “Ads” > “Global settings”, avec l’avertissement de Google selon lequel cela « peut avoir un effet négatif sur les performances de votre bloc ». Pour la plupart des sites adaptatifs, la méthode des media queries CSS ci-dessus offre la maîtrise d’une taille fixe sans quitter le type de bloc adaptatif.

Pourquoi mon bloc adaptatif ne se dimensionne-t-il pas ?

Google liste les situations où le code adaptatif ne peut pas calculer de taille (article sur le comportement adaptatif) :

Situation Ce qui ne va pas Solution de Google
Des scripts tiers s’exécutent d’abord et masquent les annonces jusqu’au chargement de la page Le code publicitaire ne peut pas mesurer l’emplacement Définir les tailles avec des media queries CSS
Le conteneur parent n’a pas de largeur explicite (par exemple un élément flottant) Pas de largeur de référence pour le calcul Définir la taille du parent avec des media queries CSS
Le conteneur parent a une hauteur fixe ou limitée L’annonce peut être plus haute que la boîte Définir plutôt la hauteur du parent avec des media queries
Appareil mobile avec une mauvaise connexion Quelques réagencements du navigateur pendant le calcul de la hauteur Comportement attendu

Dans la console du navigateur, un emplacement mesuré à largeur nulle affiche le message de la bibliothèque “No slot size for availableWidth=0”. Il signifie généralement que le <ins> se trouve dans un onglet masqué, un menu replié, un parent en display:none ou un élément flex réduit à rien.

Erreurs courantes

  • Entourer le bloc d’une boîte avec height: 250px; overflow: hidden. Les annonces adaptatives peuvent être plus hautes sur certains appareils, et rogner une annonce revient à la couvrir avec du contenu. Utilisez plutôt min-height sur le conteneur.
  • Déplacer le CSS de taille dans votre feuille de style principale. Cela peut fonctionner, mais Google précise que ce n’est pas officiellement pris en charge. Gardez-le dans un bloc <style> à côté du bloc.
  • Conserver data-ad-format="auto" avec des tailles CSS. Les instructions de Google demandent de le supprimer quand vous définissez des tailles exactes.
  • Réutiliser le même nom de classe pour plusieurs blocs. Google demande un nom unique par bloc adapté.
  • Attendre des formes sur mobile. Les formes de data-ad-format valent pour ordinateur uniquement.
  • Placer des annonces trop près des boutons et de la navigation. Le dimensionnement adaptatif peut rendre un bloc plus grand que prévu. Consultez les règles de placement des annonces sur les clics accidentels après des tests sur petits écrans.

Si des blocs restent vides alors qu’ils sont correctement dimensionnés, l’emplacement est peut-être simplement non rempli ; les emplacements publicitaires vides expliquent comment détecter et styler cet état.

Questions fréquentes

Que fait data-ad-format="auto" ?

Il active le dimensionnement automatique d'un bloc display adaptatif : AdSense calcule la taille de l'annonce à partir de l'espace disponible dans le conteneur parent et de la taille de l'écran. C'est la valeur par défaut du code adaptatif généré. Vous pouvez la remplacer par "rectangle", "vertical", "horizontal" ou une combinaison séparée par des virgules pour suggérer une forme générale, ce qui s'applique uniquement sur ordinateur.

Faut-il régler data-full-width-responsive sur true ou false ?

Google recommande "true" : le bloc s'étend alors plus souvent à toute la largeur de l'écran sur mobile, avec le potentiel de revenu maximal. Utilisez "false" quand une annonce pleine largeur casserait votre mise en page, par exemple dans une carte étroite ou à côté d'une barre latérale sur tablette. Sans ce paramètre, l'extension pleine largeur se produit parfois, mais moins souvent.

Puis-je donner une taille fixe à un bloc adaptatif avec du CSS ?

Oui. L'article de Google "How to modify your responsive ad code" montre une classe sur l'élément ins dont la largeur et la hauteur dépendent de la largeur d'écran, via des media queries dans un bloc style. Supprimez data-ad-format et data-full-width-responsive dans ce cas. Google précise que définir la taille par des feuilles de style externes n'est pas officiellement pris en charge.

Pourquoi mon bloc adaptatif ne s'affiche-t-il pas ?

La cause la plus fréquente est un conteneur parent sans largeur exploitable, comme un élément flottant ou un onglet masqué : AdSense ne peut alors pas calculer de taille. Un parent à hauteur fixe ou limitée en est une autre. Les scripts qui masquent les annonces jusqu'à la fin du chargement de la page empêchent aussi le calcul. Donnez au conteneur une largeur explicite ou utilisez un dimensionnement CSS.

Sources

  1. About the responsive behavior of display ad units · Google AdSense Help
  2. How to use responsive ad tag parameters · Google AdSense Help
  3. How to modify your responsive ad code · Google AdSense Help
  4. Modifications of AdSense ad code · Google AdSense Help