ads.txt et sellers.json

Déployer ads.txt sur des hébergeurs statiques et des CDN : dossiers publics, redirections, en-têtes et cache

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

L'essentiel

  • Sur un hébergeur statique, ads.txt se place dans le dossier du framework copié tel quel vers la sortie de build : public/ dans Astro et Next.js, static/ dans Hugo, une copie directe (passthrough) dans Eleventy.
  • Netlify n'autorise pas une règle de réécriture à masquer un fichier existant, sauf si la règle se termine par ! ; Cloudflare Pages précise que les redirections de _redirects sont toujours appliquées, même si une ressource correspond.
  • Cloudflare Pages traite un projet sans fichier 404.html au premier niveau comme une application monopage et sert la page racine pour les chemins inconnus : un ads.txt absent renvoie donc du HTML au lieu d'une erreur 404.
  • GitHub Pages crée automatiquement des redirections entre le domaine racine et www lorsque les enregistrements DNS des deux sont configurés.
  • Sur Amazon S3, Content-Type est une métadonnée d'objet que vous pouvez définir, et CloudFront continue de servir un ads.txt en cache jusqu'à son expiration ou son invalidation.
Gros plan sur un câble à fibre optique aux brins lumineux
Image: Optical fiber cable-10ASD,Asurnipal,CC BY-SA 4.0,via Wikimedia Commons.

Sur un hébergeur statique, ads.txt n’est qu’un fichier de la sortie de build : la plupart des échecs viennent donc de la couche de build ou de routage. Le fichier n’est pas copié, un repli d’application monopage répond à /ads.txt par du HTML, une règle de redirection détourne le chemin, ou le domaine nu n’atteint pas le site. Placez le fichier dans le dossier public de votre framework, puis vérifiez l’URL déployée sur le domaine racine et sur www.

Où placer ads.txt dans chaque framework ?

L’objectif est un fichier à la racine de la sortie de build, servi sous /ads.txt. Chaque générateur dispose d’un dossier copié à l’identique :

Framework Emplacement source Comportement documenté
Astro public/ads.txt Les fichiers de public/ sont copiés dans le dossier de build sans modification
Next.js public/ads.txt Les fichiers de public sont référencés à partir de l’URL de base (/)
Hugo static/ads.txt Les fichiers de static sont copiés dans le répertoire public lors du build
Eleventy eleventyConfig.addPassthroughCopy("ads.txt") La copie directe envoie les fichiers vers le dossier de sortie
HTML simple À côté de index.html Le répertoire que vous déployez

Sources : structure de projet Astro, dossier public de Next.js, structure des répertoires de Hugo, copie directe d’Eleventy. La configuration d’AdSense propre à chaque framework est détaillée dans AdSense dans Astro et AdSense dans Hugo et Eleventy.

Versionnez le fichier. Un fichier envoyé à la main vers un hébergeur qui reconstruit depuis Git disparaît au déploiement suivant, et l’aide de Google sur l’exploration prévient qu’une erreur 404 lors d’une nouvelle exploration purge les entrées explorées auparavant.

Netlify

Placez ads.txt dans le répertoire de publication (via le dossier public de votre framework). Deux comportements comptent :

Les réécritures ne masquent pas les fichiers existants. La page Rewrites and proxies de Netlify indique que, par défaut, une URL qui existe réellement dans le site ne peut pas être masquée. Une règle classique d’application monopage /* /index.html 200 laisse donc un vrai /ads.txt tranquille. Deux exceptions : une règle forcée avec ! (par exemple /* /index.html 200!) l’emporte sur les fichiers, et si ads.txt manque dans le déploiement, la règle générique sert index.html avec le statut 200, ce qui constitue un soft 404.

En-têtes. Pour contrôler le cache, Netlify lit un fichier _headers dans le répertoire de publication :

/ads.txt
  Cache-Control: public, max-age=0, must-revalidate

Les en-têtes personnalisés de Netlify s’appliquent uniquement aux fichiers que Netlify sert depuis son propre stockage, pas aux réponses des fonctions ni des fonctions de périphérie (edge functions).

Vercel

Placez le fichier dans le dossier public de votre framework. La référence de vercel.json documente deux options qui touchent aux URL :

  • trailingSlash: true redirige les chemins sans barre oblique finale, mais les chemins avec une extension de fichier ne sont pas redirigés vers une version avec barre oblique : /ads.txt n’est donc pas concerné.
  • cleanUrls retire les extensions des fichiers HTML et des fonctions uniquement.

Les en-têtes personnalisés, par exemple une politique de cache, se définissent dans vercel.json :

{
  "headers": [
    {
      "source": "/ads.txt",
      "headers": [{ "key": "Cache-Control", "value": "public, max-age=0, must-revalidate" }]
    }
  ]
}

Si ads.txt est généré par un gestionnaire de route ou un middleware plutôt que par un fichier statique, assurez-vous que ce code renvoie le statut 200 et text/plain à chaque requête.

Cloudflare Pages

Placez ads.txt dans le répertoire des ressources statiques (public/ ou static/ avec un framework, ou le répertoire de sortie du build sans framework). Deux comportements documentés sont des pièges :

Les redirections l’emportent toujours. La page Redirects de Cloudflare indique que les redirections sont toujours appliquées, qu’une ressource corresponde ou non à la requête entrante. Une règle large dans _redirects, comme /* /new-path 301, capture donc aussi /ads.txt. Gardez les redirections générales précises, ou placez en premier une exception explicite pour /ads.txt.

Repli d’application monopage. Selon Serving Pages, s’il n’existe pas de 404.html au premier niveau, Pages suppose que vous déployez une application monopage et sert la racine pour les chemins inconnus. Un ads.txt manquant renvoie alors votre page d’accueil avec le statut 200. Ajouter un 404.html fait renvoyer une vraie erreur 404 pour les fichiers absents, ce qui facilite le diagnostic.

Pages garde les ressources déployées en cache sur son CDN jusqu’au prochain déploiement : un nouveau déploiement est donc la manière de publier un fichier modifié. Notez aussi que Cloudflare classe les redirections au niveau du domaine parmi les fonctions non prises en charge dans _redirects : une redirection du domaine racine vers www doit être configurée ailleurs dans Cloudflare (par exemple avec les Bulk Redirects).

GitHub Pages

Placez ads.txt à la racine de votre source de publication (la racine de la branche, /docs, ou l’artefact que téléverse votre workflow Actions). Deux points :

  • Domaine racine et www. La documentation GitHub sur les domaines personnalisés indique que si vous configurez les bons enregistrements DNS pour le domaine racine et pour www, GitHub Pages crée automatiquement des redirections entre les domaines. Configurez les deux pour que le domaine racine atteigne le fichier.
  • Sites de projet. Un site de projet à l’adresse username.github.io/project/ ne peut pas héberger le fichier racine ; username.github.io/ads.txt provient du dépôt du site utilisateur (username.github.io). Avec un domaine personnalisé sur le site de projet, le fichier se place à la racine de publication du projet.

Amazon S3 et CloudFront

Envoyez ads.txt à la racine du bucket (clé d’objet ads.txt, sans préfixe). Deux vérifications :

  • Content-Type. Dans S3, Content-Type est une métadonnée système que l’utilisateur peut définir, d’après la documentation sur les métadonnées d’objet S3. Confirmez qu’il vaut text/plain avec curl -sI. La spécification de l’IAB indique que les autres types de contenu doivent être traités comme une erreur.
  • Cache du CDN. CloudFront sert l’objet en cache jusqu’à son expiration. Le guide d’invalidation d’AWS explique que, pour retirer un fichier des caches de périphérie avant son expiration, vous pouvez l’invalider ; CloudFront retourne alors à l’origine chercher la dernière version. Les noms de fichiers versionnés ne sont pas une option pour ads.txt, dont le chemin est fixe : invalidez donc /ads.txt après chaque modification.

Assurez-vous aussi que le domaine racine pointe vers la distribution, ou redirige vers www en conservant le chemin.

Cache : combien de temps ads.txt doit-il être mis en cache ?

La spécification ads.txt 1.1 de l’IAB indique que les consommateurs du fichier doivent respecter les en-têtes de cache HTTP standard et, en leur absence, appliquer par défaut une expiration de 7 jours. Google ne dit pas comment il applique les en-têtes de cache ; il indique que les changements dans AdSense prennent quelques jours, jusqu’à un mois pour les sites qui génèrent peu de requêtes publicitaires. Un cache court ou avec revalidation de votre côté garantit que tout robot reçoit votre fichier actuel. Next.js documente Cache-Control: public, max-age=0 pour les fichiers de public, et Cloudflare Pages indique qu’il ajoute parfois Cache-Control: public, max-age=0, must-revalidate.

Erreurs fréquentes sur les hébergeurs statiques

Erreur Ce que reçoit le robot Correction
Fichier envoyé par le tableau de bord de l’hébergeur, non versionné Erreur 404 après le prochain déploiement Git Versionner ads.txt dans le dossier public ou static
Fichier placé dans src/ ou content/ au lieu du dossier copié Erreur 404, ou page de repli de l’application Le déplacer dans public/ ou static/ (ou ajouter une copie directe)
Règle générique d’application monopage avec drapeau de forçage (200!) sur Netlify Votre index.html Retirer ! ou exclure /ads.txt
Règle large dans le _redirects de Cloudflare Pages Une redirection qui éloigne du fichier Restreindre la règle ; les redirections l’emportent sur les ressources
Domaine racine non relié à l’hébergeur Erreur de connexion ou page de parking Ajouter le domaine racine au projet et le rediriger vers l’hôte canonique
Redirection du domaine racine vers www qui perd le chemin La page d’accueil Conserver le chemin dans la redirection
Déploiement de prévisualisation ou de branche utilisé comme URL de production Un autre fichier, ou aucun Contrôler le domaine de production, pas l’URL de prévisualisation
Ancien fichier encore en cache sur le CDN L’ancien contenu Purger ou invalider /ads.txt

Et les monorepos et les sites multiples ?

Si un même dépôt construit plusieurs sites, la sortie de chaque site a besoin de son propre ads.txt, car chaque domaine est exploré séparément. Lorsque les sites partagent le même compte AdSense et les mêmes régies, générer le fichier à partir d’un modèle unique au moment du build les garde identiques. Lorsqu’ils diffèrent (ID éditeur différents, ou un site avec une régie supplémentaire), conservez un fichier source par site et vérifiez chaque domaine déployé séparément.

ads.txt doit-il être généré dynamiquement ?

Seulement si c’est nécessaire. Un simple fichier versionné est l’option la plus robuste : il est servi comme ressource statique, bénéficie du traitement par défaut des fichiers .txt de l’hébergeur et ne peut pas échouer à cause d’un délai d’expiration de fonction ou d’un démarrage à froid. Si vous le construisez au déploiement (à partir de variables d’environnement, par exemple), ajoutez une étape de build qui échoue lorsque la ligne AdSense manque, afin qu’un fichier défectueux n’arrive jamais en production.

Liste de contrôle après chaque déploiement

  1. curl -sIL https://example.com/ads.txt se termine par 200 avec content-type: text/plain.
  2. Même résultat pour http://example.com/ads.txt et pour les deux variantes www (les redirections sont acceptées, voir ads.txt introuvable).
  3. curl -sL https://example.com/ads.txt affiche vos lignes, pas du HTML.
  4. Un chemin volontairement erroné comme /ads-test-404.txt renvoie une erreur 404, ce qui prouve que votre hébergeur ne masque pas les fichiers manquants derrière un repli d’application monopage.
  5. Automatisez ces contrôles dans votre intégration continue, comme le montre la validation d’ads.txt par vos propres moyens.

Questions fréquentes

Où placer ads.txt dans un projet Astro ou Next.js ?

Dans le dossier public/ à la racine du projet. La documentation d'Astro indique que les fichiers de public/ sont copiés tels quels dans le dossier de build, et Next.js sert les fichiers de public/ depuis l'URL de base : public/ads.txt devient donc /ads.txt. Versionnez-le dans votre dépôt pour que chaque déploiement l'inclue.

Pourquoi mon site statique renvoie-t-il la page d'accueil sur /ads.txt ?

En général parce que le fichier manque dans la sortie de build et que l'hébergeur se replie sur la coquille de votre application. Cloudflare Pages sert la page racine pour les chemins inconnus lorsqu'aucun 404.html de premier niveau n'existe, et les réécritures génériques des applications monopages font de même ailleurs. Le robot reçoit alors du HTML avec le statut 200. Vérifiez que ads.txt figure dans la sortie déployée.

Puis-je héberger ads.txt sur un sous-domaine gratuit comme netlify.app ou github.io ?

Techniquement oui : github.io, netlify.app, vercel.app et pages.dev figurent dans la Public Suffix List, donc yoursite.netlify.app compte comme son propre domaine racine pour ads.txt. Pour un site de projet GitHub Pages à l'adresse username.github.io/project/, le fichier doit toutefois se trouver sur username.github.io/ads.txt, qui dépend du dépôt de votre site utilisateur.

Dois-je définir un en-tête Content-Type pour ads.txt ?

Vérifiez avant de modifier quoi que ce soit. La spécification de l'IAB exige text/plain : lancez curl -sI sur l'URL d'ads.txt et lisez la ligne content-type. Si elle indique déjà text/plain, ne touchez à rien. Sur Amazon S3, Content-Type est stocké comme métadonnée d'objet que vous pouvez définir ; contrôlez-le après l'envoi et corrigez-le si votre outil a choisi autre chose.

Sources

  1. Ensure your ads.txt files can be crawled · Google AdSense Help
  2. Rewrites and proxies · Netlify Docs
  3. Redirects · Cloudflare Docs
  4. Serving Pages · Cloudflare Docs
  5. Managing a custom domain for your GitHub Pages site · GitHub Docs
  6. Static Configuration with vercel.json · Vercel Docs