Ajouter ads.txt à WordPress sans extension (et éviter les conflits avec les fichiers ads.txt virtuels)
L'essentiel
- Sur un site WordPress auto-hébergé, un fichier ads.txt physique envoyé à la racine web est servi directement par Apache ou Nginx, avant que WordPress ne s'exécute.
- Les règles .htaccess de base de WordPress n'envoient une requête vers index.php que si elle ne correspond à aucun fichier ni répertoire existant (RewriteCond %{REQUEST_FILENAME} !-f et !-d).
- La configuration Nginx recommandée par WordPress utilise try_files $uri $uri/ /index.php?$args, qui sert aussi un fichier statique existant avant PHP.
- Comme le fichier physique l'emporte, une extension qui génère un ads.txt virtuel via WordPress est ignorée dès qu'un vrai fichier ads.txt existe à la racine web.
- Si WordPress se trouve dans son propre sous-répertoire alors que le site est servi à la racine du domaine, ads.txt se place à la racine publique, à côté de l'index.php copié, et non dans le dossier de WordPress.

Pour ajouter ads.txt à un site WordPress auto-hébergé sans extension, créez un fichier texte brut nommé ads.txt contenant votre ligne AdSense, puis envoyez-le par SFTP ou par le gestionnaire de fichiers de votre hébergeur à la racine web, le dossier qui sert https://yourdomain.com/. Apache et Nginx servent ce fichier directement, avant le chargement de WordPress, ce qui signifie aussi qu’il l’emporte sur tout ads.txt virtuel généré par une extension.
Pourquoi utiliser un fichier plutôt qu’une extension ?
Les Ads.txt FAQs de Google suggèrent une extension comme option pour WordPress (si vous utilisez déjà une extension pour placer des annonces, elle peut inclure une fonction de création du fichier ads.txt). Une extension n’est pas obligatoire. Un fichier physique présente des avantages pratiques :
| Fichier physique à la racine web | Extension (fichier virtuel) | |
|---|---|---|
| Servi par | Le serveur web, avant PHP | WordPress, via PHP |
| Dépend des mises à jour de l’extension | Non | Oui |
| Affecté par les erreurs PHP ou le mode maintenance | Non | Possible |
| Affecté par les extensions de cache de pages | Généralement non (fichier statique) | Possible |
| Modification | SFTP ou gestionnaire de fichiers | Tableau de bord WordPress |
| Résiste aux changements de thème | Oui | Oui |
La principale raison de préférer une extension est l’accès : si vous ne pouvez pas atteindre vos fichiers, une extension dotée d’un éditeur dans le tableau de bord est plus simple.
Comment ajouter ads.txt à WordPress, étape par étape ?
- Copiez votre ligne depuis AdSense. Dans « Sites », ouvrez le site, sélectionnez l’option « Extrait ads.txt » et cliquez sur « Copier » (libellés relevés sur la version française du guide officiel). Elle ressemble à
google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0(voir la syntaxe d’ads.txt). - Créez le fichier dans un éditeur de texte brut. Le Ads.txt guide de Google suggère le Bloc-notes (Notepad, sous Windows) ou TextEdit (Mac). Dans TextEdit, passez en texte brut avant d’enregistrer. Nommez-le exactement
ads.txt. - Ajoutez les autres régies, une ligne chacune, d’après leur propre documentation.
- Connectez-vous à votre serveur en SFTP ou via le gestionnaire de fichiers de votre hébergeur.
- Repérez la racine web : en général le dossier qui contient
wp-config.php,wp-admin,wp-contentetwp-includes, souvent nommépublic_html,wwwouhtdocschez un hébergeur mutualisé. - Envoyez
ads.txtà cet endroit. - Ouvrez
https://yourdomain.com/ads.txtdans une fenêtre de navigation privée. Vous devez voir du texte brut. - Dans AdSense, cliquez sur « Rechercher des mises à jour » sur la page du site. Google indique que les changements peuvent prendre quelques jours, jusqu’à un mois pour les sites qui génèrent peu de requêtes publicitaires.
Pourquoi un vrai fichier l’emporte-t-il sur WordPress ?
Parce que WordPress ne traite que les requêtes que le serveur web ne peut pas satisfaire lui-même.
Apache. Le bloc .htaccess de base de WordPress, tel que publié dans Apache HTTPD / .htaccess, se termine ainsi :
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
Dans mod_rewrite, -f teste si le chemin existe et est un fichier ordinaire, -d s’il s’agit d’un répertoire, et un préfixe ! rend la condition vraie uniquement si le motif de la condition ne correspond pas. La règle n’envoie donc une requête vers index.php que si aucun fichier ni répertoire réel ne correspond. Un vrai /ads.txt est servi comme fichier statique.
Nginx. La configuration Nginx de WordPress utilise :
try_files $uri $uri/ /index.php?$args;
Le commentaire de la page elle-même indique qu’aucun PHP n’est sollicité pour le contenu statique. Nginx sert d’abord le fichier existant et ne se replie sur index.php que si rien ne correspond.
Qu’est-ce qu’un ads.txt « virtuel », et pourquoi entre-t-il en conflit ?
Contrairement à robots.txt, que le cœur de WordPress peut produire lui-même via do_robots(), ads.txt provient soit d’un fichier physique, soit d’une extension. Certaines extensions écrivent un vrai fichier sur le disque ; d’autres répondent à la requête /ads.txt depuis WordPress, avec un contenu stocké en base de données et affiché par PHP. Ce second type est un ads.txt « virtuel » : il n’y a aucun fichier à trouver sur le serveur.
Combiné au routage décrit plus haut, le conflit est prévisible :
| Situation | Ce que reçoivent les visiteurs et les robots |
|---|---|
| Fichier physique seul | Le fichier physique |
| Extension seule | La sortie virtuelle de l’extension |
| Fichier physique et extension | Le fichier physique ; les réglages de l’extension n’ont aucun effet |
| Deux extensions gérant toutes deux ads.txt | Dépend de l’ordre de chargement ; difficile à prévoir après les mises à jour |
| Aucun des deux, avec un thème qui renvoie une page 404 | La page 404 HTML du thème, qu’AdSense signale comme « Introuvable » |
Le ticket d’assistance classique : quelqu’un modifie ads.txt dans une extension, voit le changement dans l’écran de l’extension, mais /ads.txt affiche encore l’ancien contenu. Un fichier physique oublié, hérité d’une configuration antérieure, prend la priorité. Choisissez une seule source de référence. Si vous suivez ce guide, désactivez la fonction ads.txt de toute extension de publicité ou de référencement qui en propose une.
Et dans les configurations WordPress particulières ?
WordPress dans son propre répertoire
Avec Giving WordPress Its Own Directory, les fichiers du cœur se trouvent dans un sous-dossier comme /wordpress alors que le site est servi à la racine, et il faut copier (et non déplacer) les fichiers index.php et .htaccess vers la racine. Dans ce cas, ads.txt se place à la racine publique, à côté de l’index.php copié, et non dans /wordpress. Le test reste toujours l’URL : https://yourdomain.com/ads.txt doit renvoyer le fichier.
Multisite
Sur un réseau en sous-répertoires (example.com/site2/), tous les sites partagent un même domaine, donc un seul ads.txt à la racine. Sur un réseau en sous-domaines (site2.example.com), le fichier du domaine racine couvre tous les sous-sites, sauf s’il déclare des entrées subdomain=, comme l’explique ads.txt et les sous-domaines. Les domaines personnalisés mappés ont chacun besoin de leur propre fichier à leur propre racine, ce qu’un fichier physique dans une racine web partagée ne peut pas offrir par domaine ; c’est l’un des rares cas où une extension ou une règle au niveau du serveur est la réponse pratique.
Hébergeurs gérés et CDN
Certains hébergeurs WordPress gérés placent un CDN ou un cache de page complète devant le site. Si vous modifiez le fichier et voyez toujours l’ancienne version, purgez le cache de /ads.txt dans le tableau de bord de l’hébergeur. Si votre hébergeur interdit l’envoi de fichiers à la racine web, demandez-lui de placer le fichier ; la FAQ de Google conseille de contacter votre prestataire lorsqu’un CMS ne permet pas de placer un fichier sur le domaine racine.
Comment confirmer quelle source répond ?
Quand vous soupçonnez qu’une extension et un fichier se font concurrence, testez au lieu de deviner :
- Cherchez le fichier sur le disque. Dans le gestionnaire de fichiers ou le client SFTP, vérifiez si
ads.txtexiste à la racine web. S’il n’y est pas, ce que renvoie/ads.txtprovient de WordPress ou d’une extension. - Comparez le contenu. Ouvrez le fichier du disque et
https://yourdomain.com/ads.txtcôte à côte. Un contenu différent signale un cache ou une autre source en travers du chemin. - Renommez temporairement le fichier en
ads.txt.baket rechargez/ads.txtdans une fenêtre privée. Si l’URL renvoie encore des lignes ads.txt, une extension les génère ; si elle renvoie la page 404 de votre thème, le fichier physique était la seule source. Remettez-le immédiatement à son nom. - Contrôlez la réponse avec curl :
curl -sI https://yourdomain.com/ads.txt
Vous attendez un statut 200 et un content-type de text/plain. Gardez ce test court pour que les robots ne trouvent pas le fichier manquant.
Les permissions du fichier comptent aussi. Le serveur web doit pouvoir le lire ; sur un hébergement Linux classique, 644 (le propriétaire peut écrire, tout le monde peut lire) est le réglage habituel d’un fichier statique. Un fichier envoyé avec des permissions trop restrictives peut renvoyer une erreur 403.
Dépannage
| Symptôme | Cause probable | Correction |
|---|---|---|
/ads.txt affiche une page 404 du thème |
Fichier absent de la racine web, ou mauvais nom (ads.txt.txt, Ads.txt) |
Envoyer dans le dossier qui sert /, vérifier le nom exact |
/ads.txt affiche l’ancien contenu |
Fichier physique qui masque une extension, ou cache | Supprimer une source, purger le cache |
| Le navigateur télécharge le fichier au lieu de l’afficher | Le serveur envoie un Content-Type inhabituel | Contrôler avec curl -sI ; la spécification exige text/plain |
Fonctionne sur www, AdSense indique « Introuvable » |
Le domaine nu ne redirige pas | Rediriger example.com/ads.txt vers l’URL en www |
| Caractères étranges au début du fichier | Enregistré avec une marque d’ordre des octets ou en texte enrichi | Réenregistrer en texte brut sans BOM |
| Une extension de sécurité renvoie 403 | Règle de pare-feu sur les fichiers .txt |
Autoriser /ads.txt |
Pour tout ce qui dépasse ces cas, la liste de contrôle complète de la livraison (HTTPS, redirections, robots.txt) se trouve dans ads.txt introuvable ou non autorisé. Pour ajouter le code AdSense lui-même sans extension, voir AdSense sur WordPress sans extension.
Questions fréquentes
Où envoyer exactement ads.txt sur un site WordPress ?
Dans le répertoire qui répond aux requêtes de la racine de votre domaine, en général le dossier qui contient wp-config.php, wp-admin et wp-content (souvent appelé public_html ou www chez un hébergeur mutualisé). Si WordPress est installé dans un sous-répertoire mais que le site est servi à la racine, utilisez plutôt le dossier racine qui contient l'index.php copié.
Ai-je besoin d'une extension pour ads.txt sur WordPress ?
Non. Les Ads.txt FAQs de Google suggèrent d'envisager une extension, mais un fichier texte simple envoyé à la racine web fonctionne sur tout site WordPress auto-hébergé et ne dépend ni de PHP, ni des mises à jour d'extensions, ni des couches de cache. Une extension est pratique quand vous ne pouvez pas accéder aux fichiers par SFTP ou par le gestionnaire de fichiers de l'hébergeur.
J'ai un vrai fichier ads.txt et une extension qui gère ads.txt. Lequel est servi ?
Le vrai fichier, sur les configurations Apache et Nginx standard. Les règles .htaccess de WordPress et la ligne try_files recommandée pour Nginx servent un fichier existant avant de passer la requête à WordPress : la sortie virtuelle de l'extension ne s'exécute donc jamais. Les modifications faites dans les réglages de l'extension n'ont alors aucun effet visible. Gardez une seule source : supprimez le fichier ou désactivez la fonction ads.txt de l'extension.
Puis-je modifier ads.txt depuis le tableau de bord WordPress sans extension ?
Pas avec les fonctions du cœur de WordPress. Utilisez le gestionnaire de fichiers de votre hébergeur ou un client SFTP pour créer et modifier le fichier. Évitez de le modifier dans un traitement de texte ou un champ de texte enrichi : Google conseille un éditeur de texte brut, car le texte enrichi peut ajouter des caractères de mise en forme qui rendent le fichier difficile à analyser.
Sources
- Ads.txt FAQs · Google AdSense Help
- Ads.txt guide · Google AdSense Help
- Apache HTTPD / .htaccess · WordPress Developer Resources
- Nginx · WordPress Developer Resources
- Giving WordPress Its Own Directory · WordPress Developer Resources
- Apache Module mod_rewrite · Apache HTTP Server Project
Guides liés
- Comment ajouter AdSense à WordPress sans extension (thèmes classiques et thèmes à blocs)
Ajouter AdSense à WordPress sans extension : le hook wp_head, les blocs dans le contenu via the_content, les thèmes à blocs et ads.txt à la racine du site.
- ads.txt « Introuvable » ou « Non autorisé » : liste de contrôle technique (redirections, HTTPS, codes de statut, robots.txt)
Diagnostiquer les statuts ads.txt Introuvable et Non autorisé : domaine racine, www, HTTP et HTTPS, redirections, 404, robots.txt, type de contenu, tests curl.
- Syntaxe d'ads.txt pour AdSense, ligne par ligne : ID pub, DIRECT, ID TAG, commentaires et variables
La ligne ads.txt d'AdSense champ par champ : google.com, votre ID pub, DIRECT, f08c47fec0942fa0, plus commentaires, variables et erreurs de format.
- Comment corriger l'alerte ads.txt « Earnings at risk » d'AdSense
Pourquoi AdSense affiche l'alerte ads.txt « Earnings at risk », ce que coûtent vraiment « Not found » et « Unauthorized », et comment la faire disparaître plus vite.