Comment ajouter Google AdSense à un site Astro (avec ou sans transitions de vue)
L'essentiel
- Dans Astro, une balise script portant un attribut autre que src n'est ni traitée ni empaquetée : le code AdSense avec async et crossorigin est donc produit exactement tel qu'il est écrit.
- Le code AdSense se place dans le head de la mise en page commune, entre les balises head, comme Google le demande pour chaque page.
- Avec le ClientRouter d'Astro, les scripts de module empaquetés ne s'exécutent qu'une fois et le body est remplacé à chaque navigation : les nouveaux emplacements publicitaires doivent donc être relancés par un écouteur astro:page-load.
- Les fichiers du dossier public d'Astro sont copiés tels quels dans le résultat du build, ce qui fait de public/ads.txt le moyen le plus simple de servir ads.txt à la racine du site.
- import.meta.env.PROD vaut true uniquement dans les builds de production, ce qui permet d'écarter les requêtes publicitaires du développement local.

Pour ajouter AdSense à Astro, affichez le code AdSense sans transformation dans le <head> de votre mise en page commune, créez un petit composant qui produit l’unité <ins> et son appel push, puis servez ads.txt depuis public/. Si vous utilisez <ClientRouter /> pour les transitions de vue, relancez les emplacements sur l’événement astro:page-load, car le body est remplacé sans rechargement complet de la page.
De quoi avez-vous besoin avant de commencer ?
- Un compte AdSense avec votre site ajouté, et votre identifiant d’éditeur (
ca-pub-...). - Pour les emplacements manuels, une unité publicitaire créée dans la page Annonces et l’identifiant de son emplacement (slot).
- Un projet Astro avec une mise en page commune (par exemple
src/layouts/Base.astro).
Les extraits ci-dessous utilisent ca-pub-0000000000000000 et l’emplacement 1234567890 comme valeurs fictives.
Comment ajouter le code AdSense au head d’Astro ?
Google demande de coller le code AdSense entre <head> et </head>, sur chaque page (Where to place AdSense code in your HTML). Dans Astro, cela revient à la mise en page utilisée par toutes les pages.
Par défaut, Astro empaquette et transforme les balises <script> (TypeScript, imports, type="module", dédoublonnage). Le guide des scripts d’Astro précise qu’Astro ne traite pas une balise <script> qui porte un attribut autre que src, et que is:inline permet de s’exclure explicitement du traitement. Le code publicitaire tiers doit rester exactement tel que Google le fournit : utilisez donc is:inline.
---
// src/layouts/Base.astro
const { title } = Astro.props;
const showAds = import.meta.env.PROD;
---
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>{title}</title>
{showAds && (
<script
is:inline
async
src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-0000000000000000"
crossorigin="anonymous"
></script>
)}
</head>
<body>
<slot />
</body>
</html>
import.meta.env.PROD vaut true dans les builds de production et false dans astro dev, d’après le guide des variables d’environnement d’Astro. Écarter les requêtes publicitaires du développement évite de remplir vos rapports avec vos propres impressions de test. Si un déploiement de prévisualisation est construit en mode production, protégez-le avec votre propre variable (par exemple un indicateur PUBLIC_ADS_ENABLED).
Cet extrait du head suffit aux annonces automatiques. Activez les annonces automatiques pour le site dans AdSense et c’est terminé ; la suite de ce guide concerne les unités manuelles.
Comment construire un composant d’unité publicitaire réutilisable ?
Créez un composant qui produit l’élément <ins> et l’appel push. Comme le script de push porte is:inline, Astro le produit une fois par instance de composant, ce qui correspond exactement au besoin : un push par emplacement.
---
// src/components/AdUnit.astro
interface Props {
adSlot: string;
format?: string;
fullWidth?: boolean;
}
const { adSlot, format = "auto", fullWidth = true } = Astro.props;
const showAds = import.meta.env.PROD;
---
{showAds && (
<div class="ad-slot">
<ins
class="adsbygoogle"
style="display:block"
data-ad-client="ca-pub-0000000000000000"
data-ad-slot={adSlot}
data-ad-format={format}
data-full-width-responsive={fullWidth ? "true" : "false"}
></ins>
<script is:inline>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>
</div>
)}
<style>
.ad-slot { min-height: 280px; }
</style>
Utilisation dans une page ou une autre mise en page :
---
import Base from "../layouts/Base.astro";
import AdUnit from "../components/AdUnit.astro";
---
<Base title="My article">
<article>
<p>Intro paragraph...</p>
<AdUnit adSlot="1234567890" />
<p>More content...</p>
</article>
</Base>
Remarques sur ce composant :
- Les valeurs d’attributs (
data-ad-format,data-full-width-responsive) sont celles que Google documente pour les unités responsives. Les valeurs autorisées sont détaillées dans le guide sur les unités publicitaires responsives. - Le
min-heightdu conteneur réserve de l’espace pour que l’annonce ne repousse pas le contenu à son chargement. Choisissez une valeur adaptée à la taille attendue dans votre mise en page ; le guide sur la réservation d’espace pour les annonces en explique les compromis. - Astro limite la portée du
<style>au composant :.ad-slotne déborde donc pas sur d’autres éléments. - Ne mettez pas
display:nonesur le<ins>pour le masquer sous condition. La règle de modification du code de Google range le masquage des unités publicitaires à tout moment parmi les pratiques non autorisées, avec une exception distincte pour les unités responsives masquées par des media queries.
Comment les annonces AdSense se comportent-elles avec les transitions de vue d’Astro ?
Par défaut, Astro utilise la navigation classique en pleine page et la configuration ci-dessus fonctionne sans changement. Tout change quand vous ajoutez <ClientRouter /> depuis astro:transitions, qui transforme le site en application routée côté client. La documentation des transitions de vue décrit ce qui se passe à la navigation :
- Le
<head>est échangé, mais les scripts déjà présents sur la nouvelle page sont laissés en place. La bibliothèque AdSense n’est donc pas chargée deux fois. - Le
<body>est entièrement remplacé par celui de la nouvelle page. Vos anciens emplacements publicitaires disparaissent et la nouvelle page arrive avec de nouveaux éléments<ins>vides. - Les scripts de module empaquetés ne sont exécutés qu’une seule fois (« are only ever executed once »). Les scripts en ligne peuvent ou non être réexécutés, selon l’historique de la page.
astro:page-loadse déclenche à la fois lors de la navigation initiale vers une page pré-rendue et lors de toute navigation ultérieure.
La méthode robuste consiste à ne plus compter sur des scripts en ligne propres à chaque emplacement et à lancer les push depuis un seul écouteur. Retirez le <script> en ligne de AdUnit.astro et ajoutez ce script empaqueté à la mise en page :
<script>
document.addEventListener("astro:page-load", () => {
const slots = document.querySelectorAll(
"ins.adsbygoogle:not([data-adsbygoogle-status])"
);
slots.forEach(() => {
(window.adsbygoogle = window.adsbygoogle || []).push({});
});
});
</script>
data-adsbygoogle-status est l’attribut que le code publicitaire place sur les emplacements qu’il a traités (l’article de Google sur data-ad-status le mentionne comme utilisé « for ads processing purposes »). Le sélecteur ne retient donc que les nouveaux emplacements. Chaque push({}) remplit le prochain <ins> vide.
Si vous préférez conserver les scripts en ligne, Astro propose aussi data-astro-rerun pour forcer l’exécution d’un script en ligne après chaque transition. Cela fonctionne, mais un seul écouteur est plus facile à comprendre que de multiples scripts en ligne.
Qu’en est-il des annonces automatiques avec ClientRouter ?
Google ne documente pas la manière dont les annonces automatiques réagissent à la navigation côté client dans un routeur de framework. Les annonces automatiques analysent une page lors de son chargement. Avec ClientRouter, le navigateur ne charge jamais de nouveau document : ne supposez donc pas que les annonces automatiques réanalysent chaque page échangée. Si les annonces automatiques comptent plus que les animations pour vous, les options les plus simples sont de renoncer à <ClientRouter />, d’utiliser les transitions de vue natives entre documents du navigateur (dont la documentation d’Astro précise qu’elles ne modifient pas le chargement des scripts d’un site multipage), ou de forcer une navigation complète sur certains liens avec data-astro-reload. Le guide sur les applications monopage traite le même problème pour React, Vue et Svelte.
Comment servir ads.txt depuis Astro ?
Placez le fichier à l’emplacement public/ads.txt :
google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0
La documentation sur la structure de projet d’Astro indique que les fichiers de public/ sont copiés dans le dossier de build sans modification (« will be copied into the build folder untouched »), ce qui convient à robots.txt et aux fichiers similaires placés à la racine. Après le déploiement, ouvrez https://votre-domaine/ads.txt et vérifiez que vous obtenez la ligne de texte brut, et non une page HTML. Les particularités propres à chaque hébergeur (redirections, barres obliques finales, cache) sont traitées dans ads.txt sur les hébergeurs statiques et les CDN.
Dépannage
| Symptôme | Cause probable | Correctif |
|---|---|---|
La balise script apparaît avec type="module" ou un nom de fichier à empreinte |
Astro l’a traitée | Ajouter is:inline et conserver les attributs d’origine |
| Les annonces s’affichent sur la première page, puis disparaissent après un clic sur un lien | ClientRouter a remplacé le body et personne n’a relancé les nouveaux emplacements | Utiliser l’écouteur astro:page-load ci-dessus |
| Console : “adsbygoogle.push() error: All ‘ins’ elements in the DOM with class=adsbygoogle already have ads in them.” | Plus d’appels push() que d’emplacements vides, souvent un script de push en ligne exécuté de nouveau |
Ne lancer le push que pour les emplacements non traités, ou supprimer les scripts en ligne en double |
| Console : “No slot size for availableWidth=0” | Le conteneur de l’emplacement n’a aucune largeur au moment du push (masqué, replié, dans un onglet fermé) | S’assurer que le conteneur est visible et a une largeur au moment du push |
Annonces dans astro dev mais pas en production, ou l’inverse |
Condition sur l’environnement | Vérifier import.meta.env.PROD et tout indicateur personnalisé |
/ads.txt renvoie votre page 404 |
Fichier absent de public/, ou réécriture de l’hébergeur |
Le déplacer vers public/ads.txt et vérifier les redirections de l’hébergeur |
Cette approche est-elle conforme aux règles ?
Oui, tant que vous conservez le code tel que Google le fournit. Les extraits ci-dessus se contentent de déplacer le code AdSense dans une mise en page, d’envelopper le <ins> dans un conteneur et d’utiliser le même appel push que celui généré par Google. La règle de modification du code autorise les changements nécessaires à une expérience utilisateur propre et au dimensionnement responsive par CSS ; elle interdit les changements qui gonflent artificiellement les performances publicitaires, le masquage d’unités et le recouvrement de contenu. Pour une vue d’ensemble de l’approbation avec des sites statiques, lisez AdSense sur les sites statiques et Jamstack.
Questions fréquentes
Faut-il is:inline sur le script AdSense dans Astro ?
Pas strictement. La documentation d'Astro indique qu'une balise script portant un attribut autre que src n'est pas traitée, et le code AdSense porte déjà async et crossorigin. Ajouter is:inline rend l'intention explicite et vous protège si quelqu'un retire un jour des attributs. Dans les deux cas, la balise est produite exactement telle qu'écrite, ce qui est souhaitable pour du code publicitaire tiers.
Pourquoi mes annonces AdSense disparaissent-elles après une navigation avec transitions de vue ?
Avec le ClientRouter d'Astro, le body est remplacé à chaque navigation et les scripts empaquetés ne s'exécutent qu'une fois. La nouvelle page contient des éléments ins neufs que personne n'a relancés. Écoutez l'événement astro:page-load, déclenché au premier chargement et après chaque navigation, et appelez adsbygoogle.push une fois pour chaque élément ins que la bibliothèque publicitaire n'a pas encore traité.
Où placer ads.txt dans un projet Astro ?
Placez-le dans le dossier public sous le nom public/ads.txt. Astro copie tout le contenu de public dans le résultat du build sans le modifier : le fichier est alors servi à l'adresse /ads.txt de votre domaine. Après le déploiement, ouvrez https://votredomaine/ads.txt dans un navigateur et vérifiez que la ligne de texte brut s'affiche, et non votre page 404.
Peut-on encapsuler le script AdSense dans un composant Astro ou l'empaqueter ?
Vous pouvez l'afficher depuis un composant, mais ne l'empaquetez pas et ne le réécrivez pas. Chargez adsbygoogle.js depuis l'URL de Google, exactement comme fournie. La règle de modification du code AdSense interdit les changements qui gonflent artificiellement les performances publicitaires : conservez les attributs fournis et ne faites que les modifications documentées par Google, comme le dimensionnement CSS des unités responsives.
Sources
- Scripts and event handling · Astro Docs
- View transitions · Astro Docs
- Project structure · Astro Docs
- Where to place AdSense code in your HTML · Google AdSense Help
- Modifications of AdSense ad code · Google AdSense Help
Guides liés
- Faire approuver un site statique ou Jamstack par AdSense
Faire approuver un site statique ou Jamstack par AdSense : emplacement du code et d'ads.txt, pièges des sous-domaines de plateforme et des aperçus.
- AdSense dans une application monopage : relancer les emplacements à chaque changement de route sans enfreindre les règles
AdSense dans une application monopage React, Vue ou Svelte : un push par nouvel ins à chaque route, ce que Google ne documente pas et la règle d'actualisation.
- Déployer ads.txt sur des hébergeurs statiques et des CDN : dossiers publics, redirections, en-têtes et cache
Où placer ads.txt dans Astro, Next.js, Hugo et Eleventy, et comment Netlify, Vercel, Cloudflare Pages, GitHub Pages et S3 le servent, le mettent en cache.
- 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.
- Comment ajouter AdSense à un site Hugo ou Eleventy avec des partials et des shortcodes
Ajouter AdSense à Hugo ou Eleventy : partial pour le head, shortcode d'unité utilisable en Markdown, chargement en production seule et ads.txt à la racine.