ads.txt et sellers.json

Ajouter ads.txt à WordPress sans extension (et éviter les conflits avec les fichiers ads.txt virtuels)

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

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.
Navigateur Firefox affichant un article de Wikipédia
Image: Firefox web browser on wikipedia page,Mozilla Corporation,CC BY-SA 4.0,via Wikimedia Commons.

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 ?

  1. 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).
  2. 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.
  3. Ajoutez les autres régies, une ligne chacune, d’après leur propre documentation.
  4. Connectez-vous à votre serveur en SFTP ou via le gestionnaire de fichiers de votre hébergeur.
  5. Repérez la racine web : en général le dossier qui contient wp-config.php, wp-admin, wp-content et wp-includes, souvent nommé public_html, www ou htdocs chez un hébergeur mutualisé.
  6. Envoyez ads.txt à cet endroit.
  7. Ouvrez https://yourdomain.com/ads.txt dans une fenêtre de navigation privée. Vous devez voir du texte brut.
  8. 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 :

  1. Cherchez le fichier sur le disque. Dans le gestionnaire de fichiers ou le client SFTP, vérifiez si ads.txt existe à la racine web. S’il n’y est pas, ce que renvoie /ads.txt provient de WordPress ou d’une extension.
  2. Comparez le contenu. Ouvrez le fichier du disque et https://yourdomain.com/ads.txt côte à côte. Un contenu différent signale un cache ou une autre source en travers du chemin.
  3. Renommez temporairement le fichier en ads.txt.bak et rechargez /ads.txt dans 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.
  4. 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

  1. Ads.txt FAQs · Google AdSense Help
  2. Ads.txt guide · Google AdSense Help
  3. Apache HTTPD / .htaccess · WordPress Developer Resources
  4. Nginx · WordPress Developer Resources
  5. Giving WordPress Its Own Directory · WordPress Developer Resources
  6. Apache Module mod_rewrite · Apache HTTP Server Project