ads.txt et sellers.json

ads.txt et sous-domaines : quel fichier le robot lit et quand utiliser subdomain=

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

L'essentiel

  • Selon la spécification ads.txt de l'IAB, les robots récupèrent ads.txt au domaine racine, défini comme le suffixe public plus une étiquette, et retirent les sous-domaines des URL qu'ils explorent.
  • L'ads.txt propre à un sous-domaine n'est exploré que si l'ads.txt du domaine racine le déclare, avec une ligne comme subdomain=blog.example.com.
  • Quand un sous-domaine déclaré possède son propre ads.txt, seuls les vendeurs listés dans ce fichier sont autorisés pour le sous-domaine ; sinon, le fichier racine s'applique.
  • Google indique qu'il explore et applique les fichiers ads.txt placés sur des sous-domaines lorsqu'ils existent et sont référencés depuis l'ads.txt du domaine racine.
  • Google précise qu'une déclaration de sous-domaine n'est nécessaire que si le vendeur autorisé ou l'ID éditeur diffère entre le sous-domaine et le domaine racine.
Grue à tour au-dessus d'un chantier
Image: Crane at construction site - geograph.org.uk - 7593527,Kevin Waterhouse,CC BY-SA 2.0,via Wikimedia Commons.

Les systèmes publicitaires lisent ads.txt au domaine racine, et ce fichier couvre tous les sous-domaines, sauf s’il en délègue un explicitement. Pour donner à un sous-domaine sa propre liste de vendeurs, ajoutez subdomain=sub.example.com au fichier racine et publiez un ads.txt sur le sous-domaine. Une fois la délégation faite, seul le fichier du sous-domaine compte pour ce sous-domaine : il doit donc contenir lui aussi votre ligne AdSense.

Quel fichier ads.txt le robot lit-il pour un sous-domaine ?

La spécification ads.txt 1.1 de l’IAB Tech Lab définit le « domaine racine » comme le « suffixe public » plus une chaîne du nom, établi d’après la Public Suffix List. Ainsi :

URL du site Domaine racine utilisé par le robot
www.example.com example.com
blog.example.com example.com
shop.example.co.uk example.co.uk (co.uk est un suffixe public)
news.example.org example.org

Dans sa section 5.5, la spécification indique que les robots doivent retirer les sous-domaines lorsqu’ils construisent leur liste d’URL, et ne doivent explorer les fichiers ads.txt que sur les sous-domaines listés avec la variable « subdomain= » dans l’ads.txt du domaine racine.

La page Ensure your ads.txt files can be crawled de Google dit la même chose du côté d’AdSense : l’exploration d’ads.txt démarre au domaine racine.

Comment fonctionne la directive subdomain= ?

SUBDOMAIN est l’une des variables d’ads.txt 1.1. La spécification la décrit comme un pointeur lisible par machine vers un sous-domaine du domaine racine, sur lequel un ads.txt peut être trouvé. Deux contraintes :

  • Seuls les domaines racine doivent renvoyer les robots vers des sous-domaines.
  • Les sous-domaines ne doivent pas renvoyer vers d’autres sous-domaines.

Les Ads.txt FAQs de Google confirment la prise en charge : Google explore et applique les fichiers ads.txt placés sur des sous-domaines, lorsqu’ils existent et qu’ils sont référencés depuis le fichier ads.txt du domaine racine. La ligne d’exemple de Google est subdomain=subdomain.example.com.

Voici une configuration complète pour un blog qui utilise un vendeur différent de celui du site principal. Le fichier racine, à l’adresse https://example.com/ads.txt :

google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0
subdomain=blog.example.com

Le fichier du sous-domaine, à l’adresse https://blog.example.com/ads.txt :

google.com, pub-1111111111111111, DIRECT, f08c47fec0942fa0

Ici, pub-0000000000000000 est autorisé sur example.com et www.example.com, et seul pub-1111111111111111 est autorisé sur blog.example.com.

Que se passe-t-il selon chaque configuration ?

La section 5.5 de la spécification décrit le résultat : lorsque l’ads.txt du domaine racine déclare un sous-domaine et qu’un ads.txt existe sur ce sous-domaine, seuls les systèmes publicitaires listés dans l’ads.txt du sous-domaine sont autorisés à vendre de l’inventaire sur ce sous-domaine. Lorsque l’ads.txt du domaine racine ne déclare pas de sous-domaine, ou qu’aucun ads.txt n’existe sur le sous-domaine, seuls les systèmes publicitaires listés dans l’ads.txt du domaine racine sont autorisés à vendre de l’inventaire sur ce sous-domaine.

Le fichier racine déclare le sous-domaine ? Le sous-domaine a un ads.txt ? Fichier qui régit le sous-domaine
Non Non Fichier racine
Non Oui Fichier racine (le fichier du sous-domaine n’est jamais exploré)
Oui Non Fichier racine
Oui Oui Fichier du sous-domaine uniquement

La dernière ligne est celle où se font piéger les éditeurs. Si vous déclarez le sous-domaine et que son fichier ne liste qu’une autre régie, votre compte AdSense n’y est plus autorisé, même si le fichier racine le liste.

Quand utiliser subdomain= ?

La remarque de Google sert de règle générale : cette démarche n’est nécessaire que si le vendeur autorisé ou votre ID éditeur est différent pour le sous-domaine par rapport au domaine racine.

Cas typiques :

  • Comptes AdSense différents. Un sous-domaine géré par un partenaire ou une entreprise distincte, avec son propre ID éditeur.
  • Régies différentes. Le site principal n’utilise qu’AdSense, tandis qu’un sous-domaine utilise aussi une autre SSP que vous ne voulez pas autoriser sur le site principal.
  • Sections hébergées. Un sous-domaine exploité par une plateforme (forum, boutique, site d’offres d’emploi) qui vend son propre inventaire.

Si vous utilisez simplement le même compte AdSense sur www, blog et shop, ne déclarez rien. Une seule ligne dans le fichier racine les couvre tous, et vous évitez de maintenir plusieurs fichiers.

Comment déléguer un sous-domaine, étape par étape ?

L’ordre compte, car dès que le fichier racine déclare le sous-domaine, le fichier du sous-domaine devient la seule liste qui compte pour lui.

  1. Rédigez d’abord le fichier du sous-domaine. Incluez tous les vendeurs qui doivent être autorisés sur le sous-domaine, y compris votre ligne AdSense si AdSense y est diffusé.
  2. Publiez-le à l’adresse https://sub.example.com/ads.txt et confirmez avec curl -sIL qu’il renvoie le statut 200 et text/plain en HTTP comme en HTTPS (Google explore les deux protocoles).
  3. Ajoutez la déclaration au fichier racine, une ligne par sous-domaine, avec le nom d’hôte seul : subdomain=sub.example.com.
  4. Vérifiez le fichier racine : il doit toujours renvoyer 200 et contenir les lignes du site principal.
  5. Demandez à AdSense de revérifier. Sur la page du site, sous « Sites », cliquez sur « Rechercher des mises à jour ».

Pour annuler une délégation, inversez l’ordre : retirez d’abord la ligne subdomain= du fichier racine, puis seulement supprimez le fichier du sous-domaine.

Comment voir ce que voit le robot ?

Récupérez les deux fichiers comme le ferait un robot, en partant de la racine :

curl -sL https://example.com/ads.txt | grep -i '^subdomain='
curl -sL https://blog.example.com/ads.txt

La première commande liste les sous-domaines que le fichier racine délègue. Pour chacun, la seconde commande montre les seuls vendeurs autorisés. Si votre ID éditeur AdSense ne figure pas dans ce résultat, AdSense n’est pas autorisé sur ce sous-domaine. Le robot open source de l’IAB suit les renvois subdomain= de la même façon, ce qui le rend utile pour auditer plusieurs domaines à la fois (voir la validation d’ads.txt par vos propres moyens).

Et si mon site est un sous-domaine d’un domaine qui ne m’appartient pas ?

Si votre site est yourname.platform.com, le domaine racine est platform.com et vous ne pouvez pas modifier son ads.txt. L’outil de dépannage ads.txt propose deux options dans ce cas : demander au propriétaire d’héberger le fichier ads.txt en votre nom, ou demander au prestataire de configurer pour vous un renvoi de sous-domaine. La seconde option signifie que la plateforme ajoute subdomain=yourname.platform.com à son fichier racine, de sorte que votre propre fichier de sous-domaine soit exploré.

Savoir si un tel site peut même être ajouté à AdSense est une question distincte, traitée dans l’ajout de sous-domaines et de sous-répertoires à AdSense.

En quoi est-ce différent de www ?

www est un sous-domaine comme un autre, mais il n’est normalement pas déclaré. Si votre site se trouve sur www.example.com, la règle de Google est que example.com/ads.txt doit servir le fichier ou rediriger vers www.example.com/ads.txt. Une redirection à l’intérieur du domaine racine est autorisée, et le contenu compte alors comme le fichier racine. N’ajoutez pas subdomain=www.example.com pour remplacer une URL racine fonctionnelle ; le dépannage de ce cas est traité dans ads.txt introuvable ou non autorisé.

app-ads.txt gère-t-il les sous-domaines de la même façon ?

Non. La spécification app-ads.txt de l’IAB indique que la directive de sous-domaine n’est pas utilisée dans les fichiers app-ads.txt et doit être ignorée si elle est rencontrée. À la place, les vérificateurs déduisent le chemin de l’URL du développeur dans la boutique d’applications : ils conservent le premier sous-domaine avant le domaine enregistrable (en écartant www. et m.), essaient d’abord https://subdomain.example.com/app-ads.txt puis se replient sur https://example.com/app-ads.txt. Plus de détails dans app-ads.txt et ads.txt.

Erreurs fréquentes

Erreur Effet Correction
Fichier sur le sous-domaine, pas de subdomain= dans la racine Fichier du sous-domaine ignoré Le déclarer dans le fichier racine, ou déplacer la ligne dans le fichier racine
subdomain= déclaré, ligne AdSense absente du fichier du sous-domaine AdSense non autorisé sur ce sous-domaine Ajouter la ligne AdSense au fichier du sous-domaine
subdomain=https://blog.example.com/ La valeur n’est pas un nom d’hôte Utiliser le nom d’hôte seul : subdomain=blog.example.com
subdomain= placé dans le fichier d’un sous-domaine Interdit par la spécification Placer toutes les déclarations dans le fichier racine
Le fichier du sous-domaine renvoie du HTML ou une erreur 404 Repli sur le fichier racine (selon la spécification) Servir une réponse 200 en texte brut

Après toute modification, utilisez « Rechercher des mises à jour » sur la page du site dans AdSense ; Google indique que les mises à jour prennent quelques jours, et jusqu’à un mois pour les sites qui génèrent peu de requêtes publicitaires. Le format des lignes est traité dans la syntaxe d’ads.txt.

Questions fréquentes

Ai-je besoin d'un fichier ads.txt sur chaque sous-domaine ?

Non. Si le même compte AdSense et les mêmes régies monétisent le sous-domaine, l'ads.txt du domaine racine le couvre déjà : la spécification de l'IAB indique que lorsque le fichier racine ne déclare pas de sous-domaine, seuls les vendeurs du fichier racine y sont autorisés. Google précise qu'une déclaration de sous-domaine n'est nécessaire que si le vendeur autorisé ou l'ID éditeur diffère.

J'ai placé ads.txt sur blog.example.com mais AdSense l'ignore. Pourquoi ?

Les robots démarrent au domaine racine et ne récupèrent l'ads.txt d'un sous-domaine que si le fichier racine y renvoie avec subdomain=blog.example.com. Sans cette ligne, le fichier du sous-domaine n'est jamais lu et le fichier racine régit le sous-domaine. Ajoutez la déclaration dans example.com/ads.txt, ou mettez plutôt votre ligne AdSense dans le fichier racine.

Un sous-domaine peut-il renvoyer vers un autre sous-domaine ?

Non. La spécification ads.txt 1.1 de l'IAB indique que seuls les domaines racine doivent renvoyer les robots vers des sous-domaines, et que les sous-domaines ne doivent pas renvoyer vers d'autres sous-domaines. Chaque déclaration subdomain= se place donc dans le fichier du domaine racine, à raison d'une ligne par sous-domaine.

La directive subdomain= fonctionne-t-elle dans app-ads.txt ?

Non. La spécification app-ads.txt de l'IAB indique que la directive de sous-domaine n'est pas utilisée dans les fichiers app-ads.txt et doit être ignorée si elle est rencontrée. app-ads.txt applique sa propre règle : les vérificateurs examinent le premier sous-domaine de l'URL du site du développeur, puis se replient sur le domaine racine.

Sources

  1. Ads.txt FAQs · Google AdSense Help
  2. Ensure your ads.txt files can be crawled · Google AdSense Help
  3. Ads.txt troubleshooter · Google AdSense Help
  4. Ads.txt Version 1.1 · IAB Tech Lab
  5. IAB Tech Lab Authorized Sellers for Apps (app-ads.txt) · IAB Tech Lab