ads.txt et sellers.json

Syntaxe d'ads.txt pour AdSense, ligne par ligne : ID pub, DIRECT, ID TAG, commentaires et variables

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

L'essentiel

  • L'enregistrement ads.txt d'AdSense est google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0, où pub-0000000000000000 est remplacé par votre propre ID éditeur.
  • Le champ 2 ne doit contenir que le préfixe pub- et le nombre à 16 chiffres ; Google demande de supprimer les préfixes de produit comme ca- ou ca-video-.
  • f08c47fec0942fa0 est l'identifiant de certification du Trustworthy Accountability Group (TAG) de Google, la même valeur que Google indique comme TAG-ID dans son fichier sellers.json.
  • Dans la spécification ads.txt 1.1 de l'IAB Tech Lab, les lignes qui commencent par # sont des commentaires et les lignes de la forme VARIABLE=VALEUR sont des déclarations de variables, comme CONTACT, SUBDOMAIN, OWNERDOMAIN et MANAGERDOMAIN.
  • Si vous monétisez via plusieurs comptes AdSense ou Ad Manager, Google exige une ligne ads.txt distincte par compte, avec son propre code pub-.
Code source affiché dans un éditeur de texte
Image: Source code,Micke,CC BY-SA 3.0,via Wikimedia Commons.

Un fichier ads.txt AdSense n’exige qu’une ligne : google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0, avec votre propre ID éditeur à la place des zéros. Les quatre champs séparés par des virgules sont le domaine du système publicitaire, votre ID de compte dans ce système, le type de relation et l’identifiant de certification de Google. Tout le reste du fichier (commentaires, autres régies, variables) suit la spécification ads.txt 1.1 de l’IAB Tech Lab.

À quoi ressemble la ligne ads.txt d’AdSense ?

Le Ads.txt guide du centre d’aide AdSense donne ce format exact, où pub-0000000000000000 est remplacé par votre propre ID éditeur :

google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0

Inutile de la saisir. Dans AdSense, ouvrez « Sites », sélectionnez le site, choisissez l’option « Extrait ads.txt » et cliquez sur « Copier » (libellés relevés sur la version française du guide officiel). Copier depuis AdSense évite l’erreur la plus courante : un ID éditeur mal saisi.

Que signifie chaque champ ?

La spécification ads.txt 1.1 de l’IAB Tech Lab définit trois champs obligatoires et un champ facultatif. Les Ads.txt FAQs de Google les relient aux valeurs d’AdSense.

Champ Nom dans la spécification Valeur AdSense Remarques
1 Domain name of the advertising system google.com Google indique que pour les comptes vendeurs Google, le nom de domaine est toujours google.com.
2 Publisher’s Account ID pub- + 16 chiffres Doit correspondre à l’ID utilisé dans les requêtes d’enchères (publisher.id en OpenRTB).
3 Type of Account/Relationship DIRECT DIRECT si vous contrôlez le compte, RESELLER si c’est quelqu’un d’autre. Insensible à la casse.
4 Certification Authority ID f08c47fec0942fa0 Facultatif dans la spécification, inclus dans l’extrait de Google.

Champ 1 : google.com

C’est le domaine canonique du système auquel se connectent les enchérisseurs. N’écrivez pas adsense.com, googlesyndication.com ni www.google.com. Pour tout compte vendeur Google (AdSense, Ad Manager, AdMob), la valeur est google.com.

Champ 2 : votre ID éditeur

Votre ID éditeur ressemble à pub-1234567890123456. Vous le trouvez dans AdSense sous « Account », puis « Settings », puis « Account information », dans le champ « Publisher ID » (Find your publisher ID). Il apparaît aussi dans votre code publicitaire sous la forme ca-pub-1234567890123456.

Ce préfixe ca- est le piège. La FAQ de Google est explicite : n’incluez dans votre déclaration que le préfixe pub- et le code numérique à 16 chiffres, et supprimez le préfixe propre au produit (par exemple ca- ou ca-video-). Une ligne avec ca-pub-... ne correspondra pas à votre compte vendeur.

Champ 3 : DIRECT

Google indique que les éditeurs qui contrôlent directement le compte du champ 2 doivent spécifier DIRECT. RESELLER signifie que vous avez autorisé une autre entité à contrôler ce compte et à revendre votre inventaire, par exemple un compte Ad Manager utilisant Scaled Partner Management pour de l’inventaire qu’il ne gère pas directement. Un éditeur AdSense standard utilise toujours DIRECT.

Champ 4 : f08c47fec0942fa0

C’est l’identifiant du système publicitaire (Google) auprès d’une autorité de certification, le Trustworthy Accountability Group (TAG). Il est identique pour tous les éditeurs AdSense. Vous pouvez le voir dans le sellers.json de Google, qui liste un identifiant nommé TAG-ID ayant pour valeur f08c47fec0942fa0.

La spécification marque le champ 4 comme facultatif, précise que les identifiants de certification sont remplacés par l’objet identifiers de sellers.json et que le champ pourrait être abandonné dans une version future. Certaines pages de Google montrent la ligne avec trois champs seulement ; la page de dépannage de l’exploration utilise google.com, pub-0000000000000000, DIRECT comme exemple. Gardez la version à quatre champs que fournit AdSense : c’est ce que produit l’option « Extrait ads.txt » et elle est valide dans toutes les versions de la spécification.

Comment fonctionnent les commentaires, les lignes vides et les espaces ?

La spécification emprunte sa simplicité à robots.txt. Les règles qui comptent en pratique :

  • Commentaires. Tout ce qui suit un #, jusqu’à la fin de la ligne, est ignoré. Une ligne entière commençant par # est une ligne de commentaire.
  • Espaces. Les consommateurs du fichier doivent ignorer toute suite d’espaces ou de tabulations entre les champs : google.com,pub-... et google.com, pub-... sont donc équivalents. Aucun champ ne peut contenir lui-même d’espace, de virgule ni de tabulation.
  • Fins de ligne. Les enregistrements sont séparés par des sauts de ligne, et les consommateurs doivent accepter CR, LF ou CRLF.
  • Champs d’extension. Les implémenteurs peuvent ajouter des données d’extension après un séparateur ; à la fin d’un enregistrement. AdSense ne vous demande d’en ajouter aucune.

Voici un petit fichier valide avec un commentaire en fin de ligne et une seconde régie (la deuxième ligne est un exemple de remplacement pour la ligne que documente votre autre régie) :

google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0 # AdSense
othernetwork.example, 12345, DIRECT

Pour toute régie autre que Google, reprenez la ligne de sa propre documentation. La spécification indique que les éditeurs doivent consulter chaque SSP ou place de marché pour connaître son domaine canonique et l’ID à utiliser.

Quelles variables ads.txt 1.1 prend-il en charge ?

Toute ligne de la forme VARIABLE=VALEUR est une déclaration de variable. La version 1.1 (publication finale en juillet 2022 d’après l’historique des modifications de la spécification) liste cinq variables prises en charge :

Variable Rôle Nécessaire pour AdSense ?
CONTACT Contact lisible par un humain pour le propriétaire du fichier (e-mail, téléphone, URL de formulaire) Facultatif
SUBDOMAIN Oriente les robots vers un sous-domaine qui a son propre ads.txt Seulement si un sous-domaine a des vendeurs différents (voir ads.txt et les sous-domaines)
INVENTORYPARTNERDOMAIN Pointe vers un domaine partenaire qui possède de l’inventaire dans votre site ou application, surtout en CTV Rarement
OWNERDOMAIN Domaine professionnel de l’entité propriétaire du site Recommandé par l’IAB, voir OWNERDOMAIN et MANAGERDOMAIN
MANAGERDOMAIN Domaine professionnel d’un partenaire de monétisation exclusif ou principal Seulement si quelqu’un d’autre vend votre inventaire

La spécification recommande de placer les variables en fin de fichier pour la lisibilité, mais précise que les robots ne doivent pas supposer cet ordre. Un fichier avec des variables :

google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0
contact=adops@example.com
ownerdomain=example.com

Les exemples de la spécification écrivent les variables tantôt en minuscules (contact=, subdomain=), tantôt en majuscules (OWNERDOMAIN=, MANAGERDOMAIN=). Les pages d’aide AdSense de Google ne documentent que subdomain= ; elles ne disent pas si AdSense lit OWNERDOMAIN. Considérez donc cette variable comme une information destinée aux acheteurs, et non comme quelque chose qu’AdSense vérifie.

Que faire si j’utilise plusieurs comptes AdSense ou Ad Manager ?

Chaque compte vendeur a besoin de sa propre ligne. La FAQ de Google : si vous monétisez via plusieurs comptes Ad Manager et/ou AdSense, vous devez inclure une ligne distincte pour chaque compte, avec son code pub- correspondant. Deux lignes avec le même domaine google.com et des ID pub- différents sont normales.

Ne listez pas de comptes qui ne sont pas les vôtres ou qui ne vendent plus votre inventaire. ads.txt est une liste d’autorisations : chaque ligne est une permission de vente.

À quoi ressemble un fichier « sans vendeur » ?

Si un domaine ne doit avoir aucun vendeur autorisé (un domaine de préproduction, par exemple), la spécification a abandonné l’ancienne méthode du fichier vide et demande à la place cet enregistrement de substitution :

placeholder.example.com, placeholder, DIRECT, placeholder

Ne l’utilisez jamais sur un domaine où vous diffusez des annonces AdSense : il déclare que personne, Google compris, n’est autorisé.

Quelles erreurs de format cassent un fichier ads.txt ?

La page de dépannage de l’exploration de Google avertit que des caractères d’espacement invalides, difficiles à détecter, peuvent rendre un fichier ads.txt difficile à analyser pour un robot, et que le fichier risque d’être ignoré. Les coupables habituels :

Erreur Exemple Correction
Préfixe de produit dans le champ 2 ca-pub-1234... Utiliser pub-1234...
Mauvais nombre de chiffres 15 ou 17 chiffres Copier l’ID depuis « Account information »
Caractères typographiques Guillemets courbes, espaces insécables, marque d’ordre des octets issue d’un traitement de texte Recréer le fichier dans un éditeur de texte brut
Texte enrichi collé Copié depuis un document ou un e-mail mis en forme Google conseille un éditeur de texte brut et suggère un éditeur hexadécimal pour repérer de l’UTF-8 invalide
Virgules ou champs en trop google.com,, pub-... Une seule virgule entre chaque champ
HTML au lieu de texte Votre CMS renvoie une page habillée sur /ads.txt Voir ads.txt introuvable ou non autorisé
Mauvais nom de fichier Ads.txt, ads.txt.txt Exactement ads.txt, en minuscules, à la racine

La spécification exige aussi que le fichier soit servi avec Content-Type: text/plain, et indique que les autres types de contenu doivent être traités comme une erreur, le contenu étant ignoré. La plupart des serveurs le font automatiquement pour un fichier .txt.

Comment vérifier rapidement la syntaxe ?

  1. Ouvrez https://yourdomain.com/ads.txt dans un navigateur. Google indique que si le fichier s’affiche, il est probable qu’AdSense le trouvera.
  2. Comparez la ligne Google caractère par caractère avec l’extrait d’AdSense.
  3. Cherchez les caractères invisibles, par exemple avec curl -s https://example.com/ads.txt | od -c | head sous macOS ou Linux ; tout ce qui n’est pas une lettre, un chiffre, une ponctuation, un espace ou \n ou \r mérite un examen.
  4. Après une correction, utilisez « Rechercher des mises à jour » sur la page du site dans AdSense. 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.

Pour des vérifications automatisées sur de nombreux domaines, voir la validation d’ads.txt avec des outils open source.

Questions fréquentes

Que signifie f08c47fec0942fa0 dans la ligne ads.txt d'AdSense ?

C'est le quatrième champ, facultatif : l'identifiant de l'autorité de certification du système publicitaire. Pour Google, il s'agit de l'ID du Trustworthy Accountability Group (TAG), et Google publie la même valeur comme TAG-ID dans son fichier sellers.json. Il identifie Google en tant que système publicitaire, pas votre compte : tous les éditeurs AdSense utilisent la même valeur. Votre propre identité figure dans le champ 2, l'ID pub-.

Faut-il écrire ca-pub ou pub dans ads.txt ?

Utilisez pub- suivi des 16 chiffres. Les Ads.txt FAQs de Google demandent de n'inclure que le préfixe pub- et le code numérique à 16 chiffres, et de supprimer les préfixes propres à un produit comme ca- ou ca-video-. La forme ca-pub- que vous voyez dans le code publicitaire (data-ad-client) est la version préfixée du même ID et n'a pas sa place dans ads.txt.

DIRECT ou RESELLER pour AdSense ?

DIRECT, si vous êtes propriétaire du compte AdSense. Google indique que les éditeurs qui contrôlent directement le compte nommé dans le champ 2 doivent spécifier DIRECT ; RESELLER concerne les comptes que l'éditeur ne contrôle pas directement, comme un compte Ad Manager utilisant Scaled Partner Management. La spécification de l'IAB ne distingue pas les majuscules, mais les écrire en capitales correspond à tous les exemples officiels.

Puis-je ajouter des commentaires dans mon fichier ads.txt ?

Oui. La spécification de l'IAB Tech Lab indique que tout ce qui suit un caractère # jusqu'à la fin de la ligne est ignoré par les consommateurs du fichier. Vous pouvez utiliser des lignes de commentaire entières ou des commentaires en fin d'enregistrement. Gardez des commentaires en texte ASCII simple pour éviter des caractères invisibles qui compliqueraient l'analyse du fichier.

Sources

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