ads.txt et sellers.json

ads.txt « Introuvable » ou « Non autorisé » : liste de contrôle technique (redirections, HTTPS, codes de statut, robots.txt)

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

L'essentiel

  • Google démarre l'exploration d'ads.txt au domaine racine : un fichier placé sur www.domaine.com/ads.txt n'est exploré que si domaine.com/ads.txt redirige vers lui.
  • Google explore ads.txt en HTTP et en HTTPS ; si l'un des deux protocoles renvoie une erreur 404, les entrées explorées auparavant peuvent être purgées, même si l'autre protocole fonctionne.
  • La réponse pour ads.txt doit avoir le code HTTP 200 OK ; Google ignore une réponse dont le code indique que le fichier est introuvable, même si un corps de page est renvoyé.
  • Google accepte plusieurs redirections qui restent dans le domaine racine d'origine et une seule redirection vers une destination extérieure à ce domaine.
  • Une règle robots.txt comme Disallow: /ads, ou une règle qui interdit Googlebot, peut conduire le robot de Google à ignorer le fichier ads.txt.
Loupe posée sur une table ancienne en bois
Image: Magnifying glass on antique table,Stéphane Magnenat,CC BY-SA 4.0,via Wikimedia Commons.

AdSense affiche « Introuvable » lorsque son robot ne parvient pas à récupérer un fichier ads.txt valide sur votre domaine racine, et « Non autorisé » lorsqu’il en récupère un qui ne contient pas votre ID éditeur. Introuvable est presque toujours un problème de livraison : le domaine nu ne sert pas le fichier et ne redirige pas vers lui, l’un des deux protocoles HTTP ou HTTPS renvoie une erreur 404, le code de statut n’est pas 200, ou robots.txt bloque le chemin. Testez chaque cas avec curl, et pas seulement dans un navigateur.

Introuvable ou Non autorisé : quel est votre problème ?

Les libellés officiels français ont été relevés sur la version française du « Guide ads.txt » de l’aide AdSense : « Introuvable » et « Non autorisé » (ainsi que « Autorisé »), affichés dans la page « Sites ».

Statut Signification Où se situe généralement la faute
« Introuvable » Aucun fichier ads.txt détecté Serveur, redirections, DNS, robots.txt, routage du CMS
« Non autorisé » Fichier trouvé, mais votre ID éditeur est absent Le contenu du fichier

Pour « Non autorisé », la correction se trouve dans le texte : ajoutez la ligne de l’option « Extrait ads.txt » dans AdSense, et vérifiez qu’il n’y a ni préfixe ca-pub- ni faute de frappe (voir la syntaxe d’ads.txt). Le reste de ce guide traite de « Introuvable », un cas où le fichier semble souvent correct dans un navigateur alors que le robot de Google voit autre chose.

Quelle URL Google explore-t-il réellement ?

La page Ensure your ads.txt files can be crawled pose trois règles :

  1. Domaine racine d’abord. L’exploration d’ads.txt démarre au domaine racine, et celui-ci doit renvoyer le fichier ads.txt ou rediriger vers lui. Le domaine racine est le domaine enregistrable (la spécification de l’IAB le définit comme le suffixe public plus une étiquette) : pour blog.example.co.uk, c’est example.co.uk.
  2. Les deux protocoles. Le robot de Google tente d’explorer les fichiers ads.txt en HTTP et en HTTPS. Chacun doit soit servir le fichier, soit rediriger vers le protocole qui le sert.
  3. Statut 200. Si le code de statut indique que le fichier est introuvable (par exemple un code 404), la réponse est ignorée et le fichier est considéré comme inexistant, même si un corps de page est renvoyé.

Comment le tester comme un robot ?

Un navigateur suit les redirections sans rien dire, réutilise des réponses en cache et peut afficher une page que votre serveur renvoie avec un code d’erreur. Utilisez curl depuis un terminal :

curl -sIL http://example.com/ads.txt
curl -sIL https://example.com/ads.txt
curl -sIL http://www.example.com/ads.txt
curl -sIL https://www.example.com/ads.txt

-I n’affiche que les en-têtes, -L suit les redirections, -s masque la barre de progression. Pour chaque commande, lisez la chaîne de lignes HTTP/ et d’en-têtes location:. Un résultat sain se termine par 200 et un en-tête content-type: text/plain. Lisez ensuite le corps une fois :

curl -sL https://example.com/ads.txt

Vous devez voir vos lignes en texte brut, pas du HTML.

Quelles redirections sont autorisées ?

Les Ads.txt FAQs et la spécification ads.txt 1.1 de l’IAB concordent :

Redirection Autorisée ?
example.com/ads.txt vers www.example.com/ads.txt Oui (dans le domaine racine)
http:// vers https:// sur le même hôte Oui
example.com/ads.txt vers sub.example.com/ads.txt Oui
example.com/ads.txt vers example.com/page/ads.txt Oui (exemple de Google lui-même)
Plusieurs sauts, tous dans example.com Oui
Un saut vers other-domain.com/ads.txt Oui, un seul saut hors du domaine racine
other-domain.com/ads.txt redirige à nouveau Non : la spécification demande de traiter cela comme une erreur

La spécification cite les codes 301, 302 et 307 comme ceux que les robots doivent suivre. Les redirections faites en JavaScript ou par une balise meta refresh ne sont pas des redirections HTTP : un robot qui lit /ads.txt voit à la place une page HTML.

Quelles sont les causes fréquentes de « Introuvable » ?

Le fichier n’existe que sur www (ou seulement sur le domaine nu)

Si votre site se trouve sur www.example.com et que le domaine nu n’a pas de serveur web, ou affiche une page de parking, Google n’atteint jamais le fichier. La consigne de Google : si vous devez inclure « www » pour accéder à votre site, il faut configurer une redirection de domain.com/ads.txt vers www.domain.com/ads.txt. Une redirection globale du domaine nu vers www fonctionne si elle conserve le chemin. Une redirection qui envoie toutes les requêtes vers la page d’accueil ne convient pas.

HTTP ou HTTPS renvoie une erreur 404

Google donne précisément ce scénario : s’il n’existe un fichier ads.txt que pour HTTP, l’exploration HTTPS renvoie une erreur 404 et l’entrée explorée auparavant est purgée, même si un fichier ads.txt est exploré via HTTP. Redirigez le protocole défaillant vers celui qui fonctionne. Sur un site en HTTPS, la configuration la plus propre est une redirection permanente de toutes les URL http:// vers https://.

Le code de statut n’est pas 200

Deux variantes :

  • Erreur 404 franche avec un corps. Certaines configurations renvoient une page d’erreur personnalisée avec le statut 404. Google l’ignore.
  • Soft 404. De nombreux CMS et applications monopages répondent à toute URL inconnue par le statut 200 et la page d’accueil ou une coquille d’application. Le statut semble correct, mais le contenu est du HTML. La spécification de l’IAB indique que le type de contenu doit être text/plain et que tous les autres types de contenu doivent être traités comme une erreur, le contenu étant ignoré.

Dans les deux cas, la solution est de faire de /ads.txt un vrai fichier statique (ou une route qui renvoie du texte brut) prioritaire sur le repli du CMS. Les étapes propres à chaque hébergeur figurent dans le déploiement d’ads.txt sur les hébergeurs statiques et CDN et dans ads.txt sur WordPress sans extension.

robots.txt le bloque

Les exemples de Google : avec User-agent: * et Disallow: /ads, le fichier ads.txt est ignoré par les robots qui respectent la norme robots.txt, car /ads correspond aussi à /ads.txt. Avec User-agent: Googlebot et Disallow: /, il est ignoré par le robot de Google. Les corrections suggérées par Google :

User-agent: *
Allow: /ads.txt
Disallow: /ads

ou bien remplacer Disallow: /ads par Disallow: /ads/. Google ajoute que les modifications de robots.txt peuvent ne pas être prises en compte tant que les robots ne sont pas repassés sur votre site.

Pare-feu, protection anti-bots et blocage géographique

Si un pare-feu applicatif, un défi anti-bots, une authentification HTTP ou un blocage par pays intercepte la requête, le robot reçoit une page de défi ou une erreur à la place du fichier. Votre navigateur peut passer le contrôle alors qu’un client automatisé échoue. La spécification de l’IAB indique qu’une réponse 401 (accès restreint) doit conduire le système publicitaire à prendre contact directement avec le site. Excluez /ads.txt des défis et de l’authentification. Les mêmes obstacles bloquent l’examen du site, comme l’explique le guide sur un site inaccessible.

Mauvais emplacement ou mauvais nom

Le fichier doit se trouver à la racine, exactement sous /ads.txt, en minuscules. example.com/blog/ads.txt ou example.com/ads.txt/ ne sont pas la même URL. Si votre site est sur un sous-domaine, consultez ads.txt et les sous-domaines.

Trop tôt

Google indique que les changements peuvent prendre quelques jours, et jusqu’à un mois pour les sites qui génèrent peu de requêtes publicitaires. Corrigez d’abord la livraison, puis utilisez « Rechercher des mises à jour » sur la page du site dans AdSense et patientez.

Tableau de diagnostic

Résultat de curl Diagnostic Correction
200, text/plain, vos lignes Livraison correcte Vérifier le contenu, attendre la nouvelle exploration
200, text/html, balisage de page Soft 404 ou route du CMS Servir un vrai fichier statique
404 sur HTTPS uniquement Absent sur un des protocoles Rediriger HTTP et HTTPS vers le même fichier
404 sur le domaine nu, 200 sur www Pas de redirection à la racine Rediriger example.com/ads.txt vers www
301 vers / (page d’accueil) Chemin perdu par la redirection Conserver le chemin dans la règle de redirection
403 ou 503 avec une page de défi Pare-feu ou protection anti-bots Exempter /ads.txt
401 Protection par mot de passe Retirer l’authentification sur /ads.txt
Erreur de connexion sur le domaine nu Pas d’enregistrement DNS ni de serveur Ajouter le DNS et une redirection pour le domaine racine
Deux redirections externes La chaîne quitte deux fois le domaine racine Pointer directement vers le fichier final

Que faire si je ne contrôle pas le domaine racine ?

Si le domaine de premier niveau appartient à une plateforme, l’outil de dépannage ads.txt indique que vous pouvez demander au propriétaire d’héberger le fichier en votre nom, ou de configurer pour vous un renvoi de sous-domaine. Votre seul sous-domaine ne permet pas de corriger cela.

Lorsque curl montre un 200 text/plain propre sur les quatre variantes d’URL et que le fichier contient exactement votre ligne, le dernier facteur est le temps. Pour mesurer ce que l’alerte coûte pendant l’attente, consultez l’alerte « Earnings at risk ».

Questions fréquentes

Mon site utilise www. Où doit se trouver ads.txt ?

Le fichier peut se trouver sur www.example.com/ads.txt, mais Google démarre l'exploration au domaine racine : example.com/ads.txt doit donc rediriger vers lui. L'aide de Google sur l'exploration indique qu'un fichier ads.txt situé sur www.domain.com/ads.txt n'est exploré que si domain.com/ads.txt redirige vers lui. Une redirection globale du domaine nu vers www suffit généralement, à condition de conserver le chemin /ads.txt.

ads.txt peut-il rediriger vers un autre domaine ?

Une seule fois. Google accepte une unique redirection HTTP vers une destination extérieure au domaine racine d'origine, par exemple example1.com/ads.txt vers example2.com/ads.txt. Les redirections qui restent dans le domaine racine (vers www, vers un sous-domaine ou vers un autre chemin) peuvent s'enchaîner. La spécification de l'IAB précise que si l'emplacement tiers redirige à son tour, la situation doit être traitée comme une erreur.

Quelle différence entre Introuvable et Non autorisé ?

« Introuvable » signifie que Google n'a trouvé aucun fichier ads.txt exploitable sur le site. « Non autorisé » signifie qu'un fichier a été trouvé, mais que votre ID éditeur n'y figure pas. Les corrections diffèrent : pour Introuvable, vérifiez l'URL, les redirections, le code de statut et robots.txt ; pour Non autorisé, ajoutez ou corrigez la ligne AdSense (ligne manquante, faute de frappe ou préfixe ca-pub-).

robots.txt influence-t-il ads.txt ?

Oui. Google avertit que le fichier ads.txt peut être ignoré si robots.txt interdit le chemin où il est publié ou interdit le robot de Google. Une règle comme Disallow: /ads correspond aussi à /ads.txt, car les règles robots.txt fonctionnent par préfixe. Remplacez-la par Disallow: /ads/ ou ajoutez Allow: /ads.txt afin que le fichier reste explorable.

Sources

  1. Ensure your ads.txt files can be crawled · Google AdSense Help
  2. Ads.txt FAQs · Google AdSense Help
  3. Ads.txt guide · Google AdSense Help
  4. Ads.txt troubleshooter · Google AdSense Help
  5. Ads.txt Version 1.1 · IAB Tech Lab