Faire approuver un site statique ou Jamstack par AdSense
L'essentiel
- AdSense n'a pas de règles distinctes pour les sites statiques : le même examen d'éligibilité, de contenu et de conformité s'applique à un site Astro, Hugo ou Eleventy et à un site sous CMS.
- Google exige l'accès au code source HTML afin de pouvoir placer le code AdSense ou la balise meta entre les balises <head> et </head>, ce que les générateurs statiques permettent via la mise en page de base.
- Le fichier ads.txt doit être servi à la racine du domaine ajouté, ce qui, avec les générateurs statiques, signifie généralement le dossier public ou static copié dans la sortie de build.
- Sur GitHub Pages, un site de projet se trouve à l'adresse <propriétaire>.github.io/<dépôt>, donc sa racine appartient à un autre dépôt ; GitHub précise aussi que Pages n'est pas destiné à faire fonctionner une activité commerciale en ligne.
- Google ne documente pas si le robot AdSense exécute JavaScript ; le contenu et le code de vérification doivent donc figurer dans le HTML pré-rendu.

Un site statique ou Jamstack est examiné par AdSense exactement comme n’importe quel autre site : Google contrôle la propriété, l’accessibilité, le contenu et le respect des règles, pas la pile technique. La différence tient à la plomberie : le code de vérification va dans votre mise en page de base, ads.txt va dans le dossier copié à la racine du build, et les sous-domaines de plateforme, les URL d’aperçu et le rendu côté client peuvent faire échouer l’examen si vous ne les anticipez pas.
Qu’est-ce qui ne change pas pour les sites statiques ?
Tout ce que Google évalue lors de l’examen :
- Le candidat doit avoir 18 ans ou plus et être propriétaire du site.
- Le contenu doit être original, suffisant et conforme aux règles.
- Le site doit être accessible aux robots de Google et facile à parcourir.
- L’examen prend généralement quelques jours et peut durer de 2 à 4 semaines.
La page de Google sur la propriété du site indique que vous « devez avoir accès au code source HTML » et pouvoir placer le code AdSense entre les balises <head>. Les générateurs statiques vous l’offrent par conception : l’exigence technique est donc plus facile à remplir que sur de nombreux constructeurs de sites hébergés.
Qu’est-ce qui change sur un site statique ou Jamstack ?
| Sujet | Particularités statique ou Jamstack | Que faire |
|---|---|---|
| Code de vérification | Pas de panneau d’administration ; le head vient d’une mise en page ou d’un composant | Ajoutez l’extrait ou la balise meta une seule fois dans la mise en page de base |
| ads.txt | Doit être copié à la racine du build | Placez-le dans le dossier de copie directe (public/, static/) |
| Domaine | Sous-domaines gratuits de plateforme et URL d’aperçu | Candidatez avec votre domaine personnalisé de production |
| Rendu | Certains frameworks rendent le contenu côté client | Livrez le contenu et le code dans le HTML pré-rendu |
| Redirections | Règles de slash final et de www définies dans la configuration de la plateforme |
Gardez un seul saut jusqu’à l’URL finale |
| Protection anti-bots | Pare-feu de plateforme ou modes de défi | Vérifiez que les robots de Google ne sont pas soumis à un défi |
| En-têtes de sécurité | Une Content Security Policy stricte peut bloquer le script publicitaire | Autorisez les domaines publicitaires de Google avant la mise en ligne des annonces |
Placer le code dans la mise en page de base
L’objectif est un seul extrait dans le head HTML de chaque page, comme Google le demande : « Assurez-vous de placer le code sur chaque page où vous souhaitez que des annonces apparaissent. » En pratique :
- Astro : le composant de mise en page partagé qui produit
<head>. - Hugo : la partie
headincluse parbaseof.html. - Eleventy : le modèle de mise en page de base.
- Next.js en export statique : la mise en page racine.
Si vous n’êtes pas prêt à charger le script publicitaire (par exemple le temps de finir la gestion du consentement), utilisez la balise meta à la place. Elle ne sert qu’à prouver la propriété :
<meta name="google-adsense-account" content="ca-pub-0000000000000000">
Le code propre à chaque framework se trouve dans AdSense avec Astro et AdSense avec Hugo et Eleventy.
Vérifier que l’extrait survit au build
Les chaînes de build statiques peuvent supprimer ou modifier du code sans le signaler :
- Les minificateurs ou optimiseurs HTML peuvent déplacer, différer ou supprimer des scripts. Contrôlez le HTML construit, pas le modèle source.
- Les conditions d’environnement (n’afficher l’extrait que si
NODE_ENV === "production") sont une bonne pratique, mais vérifiez que le build de production l’inclut réellement. - Lancez un contrôle rapide sur le site déployé :
curl -s https://example.com/ | grep -c "ca-pub-"
curl -sI https://example.com/ads.txt
La première commande doit renvoyer au moins 1. La seconde doit renvoyer HTTP/2 200 (ou HTTP/1.1 200) avec un type de contenu texte, sans redirection vers un autre hôte.
Servir ads.txt depuis la racine
Google demande de téléverser le fichier ads.txt « dans le répertoire racine de votre site ». Sur un site statique, cela signifie le placer dans le dossier copié tel quel à la racine de la sortie, puis déployer. Les pièges propres à chaque hébergeur (réécritures, cache, mauvais type de contenu, solutions de repli d’application monopage qui renvoient la page d’accueil au lieu d’une erreur 404) sont traités dans ads.txt sur Netlify, Vercel, Cloudflare Pages et GitHub Pages.
Sous-domaines de plateforme, aperçus et GitHub Pages
Candidater avec le domaine de production
Les hébergeurs Jamstack génèrent des URL supplémentaires : déploiements d’aperçu, déploiements de branche et sous-domaine par défaut de la plateforme, à côté de votre domaine personnalisé. Candidatez avec l’unique domaine de production canonique, et veillez à ce que les autres URL redirigent vers lui ou ne soient pas liées publiquement, pour que l’examinateur et les visiteurs voient un seul site.
Sous-domaines gratuits de plateforme
github.io, netlify.app, vercel.app, pages.dev et web.app figurent tous sur la Public Suffix List, ce qui signifie que les navigateurs traitent votresite.netlify.app comme son propre domaine enregistrable. La manière dont AdSense traite les domaines, sous-domaines et plateformes hébergées est expliquée dans domaine racine, sous-domaine ou sous-répertoire. Un domaine personnalisé évite complètement la question, et il conserve votre site, votre ads.txt et votre historique d’approbation si vous changez d’hébergeur.
Particularités de GitHub Pages
La documentation de GitHub décrit deux types de sites Pages :
| Type | Emplacement par défaut | Qui contrôle la racine |
|---|---|---|
| Site d’utilisateur ou d’organisation | https://<propriétaire>.github.io |
Le dépôt de ce site |
| Site de projet | https://<propriétaire>.github.io/<dépôt> |
Pas le projet ; la racine appartient au dépôt du site d’utilisateur |
Un site de projet ne peut donc pas servir /ads.txt depuis son propre dépôt à la racine de <propriétaire>.github.io. Utilisez plutôt un domaine personnalisé pour le projet.
GitHub fixe aussi une limite d’usage à lire avant de monétiser : GitHub Pages « n’est pas destiné ni autorisé à être utilisé comme service d’hébergement web gratuit pour faire fonctionner votre activité commerciale en ligne, votre site de commerce électronique, ou tout autre site principalement destiné à faciliter des transactions commerciales ou à fournir un logiciel commercial en tant que service ». Confrontez les conditions de GitHub à vos projets, ou hébergez ailleurs le site monétisé.
Rendu : le robot voit-il votre contenu ?
Les pages de Google sur le robot AdSense décrivent ce qu’il fait (il lit les pages pour fournir des annonces pertinentes, respecte robots.txt, n’envoie aucune donnée POST) mais n’indiquent pas s’il exécute JavaScript. Considérez le rendu côté client comme un risque :
- La génération statique (Astro, Hugo, Eleventy, export statique de Next.js) place le texte complet dans le HTML. C’est le choix par défaut le plus sûr.
- Les applications monopages qui récupèrent le texte des articles après le chargement peuvent présenter une coque HTML presque vide. Utilisez le rendu statique ou côté serveur pour les pages de contenu.
- Les « îlots » ou composants hydratés ne posent pas de problème tant que le texte principal est dans le HTML.
Le dépannage du robot par Google signale aussi deux pratiques fréquentes dans les montages Jamstack : les pages qui exigent des données POST (« utilisez des requêtes GET dans la mesure du possible ») et les URL avec paramètres qui font passer un même contenu pour de nouvelles pages, comme les identifiants de session.
Erreurs courantes sur les sites statiques
- Candidater avec l’URL
*.netlify.appou*.vercel.apppuis passer à un domaine personnalisé. Pour AdSense, le domaine personnalisé est un autre site : ajoutez-le et faites-le examiner. - Règles de repli d’application monopage qui renvoient
index.htmlavec un statut 200 pour tout chemin inconnu, y compris/ads.txttant que le fichier n’existe pas. Les pages absentes doivent renvoyer une erreur 404. - Pages générées trop minces. Les générateurs statiques permettent de produire facilement des milliers de pages de tags, de taxonomies et de pagination. Désactivez ou passez en noindex celles dont vous n’avez pas besoin ; l’examen peut couvrir toutes les pages.
- Protection par mot de passe de la plateforme laissée active depuis la préproduction. Retirez-la sur le domaine de production avant de demander l’examen.
- Une Content Security Policy stricte qui bloque le script AdSense. La vérification par balise meta ou par ads.txt fonctionne encore, mais les annonces ne se chargeront pas plus tard.
- Laisser le contenu de démonstration d’un thème de départ, qui donne l’impression d’un site « en construction ».
Une fois la plomberie en place, l’examen porte sur le contenu : la liste de contrôle d’approbation s’applique sans changement.
Questions fréquentes
Un site statique créé avec Astro, Hugo ou Eleventy peut-il être approuvé par AdSense ?
Oui. Les exigences de Google portent sur l'accès au HTML, l'originalité du contenu et le respect des règles, pas sur la technologie. Un générateur statique vous donne le contrôle complet du head HTML, ce que Google demande précisément. L'examen juge ensuite le contenu comme il jugerait celui d'un site WordPress ou d'un site sur mesure.
Où placer ads.txt sur un site statique ?
Dans le dossier que votre générateur copie tel quel à la racine de la sortie de build : public/ avec Astro et avec Eleventy lorsqu'il est utilisé, static/ avec Hugo, ou le dossier de copie directe configuré. Après le déploiement, vérifiez que https://votredomaine/ads.txt renvoie directement le fichier avec un statut 200, sans redirection vers un autre hôte.
Puis-je candidater avec un site sur github.io, netlify.app ou vercel.app ?
Ces domaines de plateforme figurent tous sur la Public Suffix List, ce qui signifie que les navigateurs traitent chaque site comme son propre domaine enregistrable. La possibilité d'en ajouter un dépend des règles d'AdSense sur les sites au moment de votre candidature. En pratique, un domaine personnalisé supprime la question, vous donne une racine pour ads.txt et conserve votre site si vous changez d'hébergeur.
AdSense exécute-t-il le contenu JavaScript côté client ?
La documentation de Google sur le robot AdSense ne dit pas s'il exécute JavaScript. Ne comptez pas dessus. Assurez-vous que le texte des articles, la navigation et l'extrait de vérification figurent dans le HTML renvoyé par le serveur, ce qui est le comportement par défaut des générateurs statiques et des frameworks en rendu statique ou côté serveur.
Sources
- Connect your site to AdSense · Google AdSense Help
- Owning the site you want to use to participate in AdSense · Google AdSense Help
- Fix AdSense crawler issues · Google AdSense Help
- What is GitHub Pages? · GitHub Docs
- GitHub Pages limits · GitHub Docs
Guides liés
- Comment connecter votre site à AdSense : comparatif des trois méthodes de vérification
Comparez les trois méthodes de vérification AdSense (code, ads.txt, balise meta), copiez les extraits exacts et corrigez les erreurs de code ou d'accès.
- Ajouter un site à AdSense : domaine racine, sous-domaine ou sous-répertoire ?
Quelle URL ajouter à AdSense : domaine racine, sous-domaine ou sous-répertoire, rôle des variantes www et d'ads.txt, et différences pour Blogger et les plateformes.
- 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 ajouter Google AdSense à un site Astro (avec ou sans transitions de vue)
Ajouter AdSense à un site Astro : script du head non transformé, composant d'unité publicitaire réutilisable, ClientRouter, chargement en production et ads.txt.
- 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.