ads.txt et sellers.json

Le sellers.json de Google pour les éditeurs AdSense : visibilité des informations vendeur et ce que voient les acheteurs

Mis à jour le Publié le Par la rédaction8 min4 sources

L'essentiel

  • sellers.json est une norme de l'IAB Tech Lab : chaque système publicitaire publie un fichier JSON public listant les vendeurs qu'il rémunère, afin que les acheteurs identifient qui se cache derrière un identifiant de vendeur déclaré dans ads.txt.
  • Google publie un seul sellers.json à l'adresse realtimebidding.google.com/sellers.json, qui couvre les comptes AdSense, AdMob et Ad Manager, avec votre identifiant d'éditeur comme seller_id.
  • Dans AdSense, la section « Seller information visibility » sous Account, Settings, Account information permet de choisir Transparent, ce qui affiche le nom du bénéficiaire du paiement et, facultativement, un domaine d'entreprise.
  • Google indique qu'un nom et un domaine transparents apparaissent dans son sellers.json sous 24 heures, et que votre statut de transparence et votre domaine sont partagés entre AdSense, AdMob et Ad Manager.
  • Google avertit que modifier le nom de votre sellers.json entraîne un retard de paiement automatique de 2 semaines, car le nom provient de votre profil de paiements.
Balance à plateaux
Image: Balance scale IMGP9755,Nikodem Nijaki,CC BY-SA 3.0,via Wikimedia Commons.

sellers.json est le fichier public dans lequel un système publicitaire liste les vendeurs qu’il rémunère. Celui de Google couvre AdSense, AdMob et Ad Manager, indexés par identifiant d’éditeur. Dans AdSense, vous choisissez si votre entrée est « Transparent » (le nom du bénéficiaire du paiement et un domaine d’entreprise facultatif sont affichés) ou confidentielle (seulement votre identifiant et le type de vendeur). Aucun des deux choix n’affecte l’autorisation ads.txt, mais Google indique que des noms masqués peuvent affecter les revenus.

Qu’est-ce que sellers.json et quel est son lien avec ads.txt ?

Les deux fichiers répondent à des questions opposées :

Fichier Publié par Répond à
ads.txt Vous, sur votre domaine Quels comptes vendeurs peuvent vendre mon inventaire ?
sellers.json Le système publicitaire (Google), sur son domaine Quelle entreprise se trouve derrière chaque compte vendeur ?

Votre ligne ads.txt google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0 indique que cet identifiant d’éditeur peut vendre votre inventaire via Google. La spécification Sellers.json de l’IAB Tech Lab permet à un acheteur de prendre cet identifiant, de le chercher dans le fichier de Google et de voir s’il appartient à un éditeur ou à un intermédiaire et, si le vendeur n’est pas confidentiel, son nom et son domaine. La spécification décrit l’objectif comme permettre que « the identity of the final seller of a bid request to be discovered (assuming that they are ads.txt authorized) » (l’identité du vendeur final d’une requête d’enchère puisse être découverte, à condition qu’il soit autorisé par ads.txt). Le détail du format des lignes figure dans la syntaxe d’ads.txt.

Où se trouve le sellers.json de Google ?

La page d’aide de Google Provide your seller information with sellers.json indique realtimebidding.google.com/sellers.json. Lors de la consultation du 18 novembre 2026 par la rédaction, cette URL répondait par une redirection 302 vers un fichier hébergé sur storage.googleapis.com, servi en application/json, d’environ 99 Mo. Le début du fichier déclare l’adresse e-mail de contact de Google, le TAG-ID f08c47fec0942fa0 (la même valeur que le quatrième champ de la ligne ads.txt d’AdSense), "version": "1.0", et un avis indiquant « This file is a beta and is unverified » (ce fichier est une version bêta et n’est pas vérifié).

Dans cette copie, la rédaction a compté 885 909 entrées de vendeurs. 885 327 avaient un seller_type PUBLISHER, 582 avaient BOTH et aucune n’avait INTERMEDIARY. 616 875 entrées étaient confidentielles. Ces chiffres décrivent un seul téléchargement, incluent des comptes AdSense, AdMob et Ad Manager, et évolueront avec le temps.

Quels champs contient votre entrée ?

La page d’aide de Google liste cinq champs :

Champ Ce que Google y met
seller_id Votre identifiant d’éditeur, par exemple pub-1234567890123456
is_confidential Renseigné lorsque votre nom et votre domaine sont masqués
seller_type PUBLISHER, INTERMEDIARY ou BOTH
name Le nom de votre profil de paiements, uniquement si l’entrée est transparente
domain Votre domaine d’entreprise, uniquement s’il est transparent et vérifié

La règle de Google pour seller_type : « If you own the site you’re monetizing and/or you’re paid directly by Google, then you’re classified as PUBLISHER. If not, you’re classified as INTERMEDIARY. » (Si vous possédez le site que vous monétisez et/ou si vous êtes payé directement par Google, vous êtes classé PUBLISHER. Sinon, vous êtes classé INTERMEDIARY.) Les comptes dans les deux situations sont classés BOTH.

Dans le fichier téléchargé, une entrée AdSense confidentielle ressemble à ceci :

{
  "seller_id": "pub-0000000000000000",
  "is_confidential": 1,
  "seller_type": "PUBLISHER"
}

Une entrée transparente n’a aucune clé is_confidential et ajoute le nom et, s’il est renseigné et vérifié, le domaine :

{
  "seller_id": "pub-0000000000000000",
  "seller_type": "PUBLISHER",
  "name": "Example Media LLC",
  "domain": "example.com"
}

Omettre la clé est valide : la spécification définit is_confidential comme un entier facultatif dont la valeur par défaut est 0.

Comment rendre mes informations vendeur transparentes ?

Les étapes de la page d’aide de Google :

  1. Connectez-vous à AdSense.
  2. Cliquez sur Account, puis Settings, puis Account information.
  3. Dans la section « Seller information visibility », sélectionnez Transparent.
  4. Si vous le souhaitez, ajoutez votre domaine d’entreprise et cliquez sur Verify and add.

Google indique que votre nom, votre domaine (s’il est renseigné) et votre identifiant d’éditeur « will appear in the Google sellers.json file within 24 hours » (apparaîtront dans le fichier sellers.json de Google dans un délai de 24 heures).

Avant de basculer, vérifiez le nom. Ce n’est pas un champ de texte libre : il provient de la section « Name and address » (comptes de particuliers) ou « Business name and address » (comptes d’entreprise) de votre profil de paiements. Google avertit : « If you change your name, this will result in an automatic payment delay of 2 weeks. » (Si vous changez de nom, cela entraîne un retard de paiement automatique de 2 semaines.) Si le nom de votre bénéficiaire doit être corrigé pour d’autres raisons, les compromis sont traités dans l’écart entre nom du bénéficiaire et compte bancaire.

Transparent ou confidentiel : qu’est-ce qui change pour vous ?

La position de Google est que vous devriez être transparent : « If your information isn’t made transparent, advertisers won’t be able to see your name, which might impact your revenue. » (Si vos informations ne sont pas rendues transparentes, les annonceurs ne pourront pas voir votre nom, ce qui peut avoir un impact sur vos revenus.) La page d’aide ne chiffre pas cet effet, et aucune autre page officielle de Google consultée par la rédaction non plus : considérez-le comme un effet possible, et non comme un chiffre.

Transparent Confidential
Visible par quiconque télécharge le fichier Identifiant d’éditeur, type de vendeur, nom, domaine s’il est vérifié Identifiant d’éditeur, type de vendeur
Nom personnel exposé (comptes de particuliers) Oui Non
Les acheteurs peuvent relier votre identifiant à une entreprise Oui Seulement via d’autres données
Affecte le statut ads.txt Non Non
Partagé avec les comptes AdMob et Ad Manager Oui Oui

Pour un compte de particulier, « Transparent » publie votre nom civil dans un fichier que tout le monde peut télécharger et que des sociétés de données archivent. Pour une entreprise, publier le nom de la société présente généralement peu de risques. C’est la décision que vous prenez.

Qu’est-ce que le domaine d’entreprise, et lequel utiliser ?

Google le définit comme « the domain for your corporate entity, not necessarily the domain where inventory is being monetized » (le domaine de votre entité juridique, pas nécessairement celui où l’inventaire est monétisé). Si le seul domaine que vous possédez est celui que vous monétisez, indiquez celui-là. Les règles :

  • Utilisez le domaine racine : example.com ou example.co.uk.
  • Pas de protocole (https://), pas de www., aucun autre sous-domaine, pas de barre oblique finale.
  • Le domaine doit utiliser un suffixe de la Public Suffix List ; Google donne google.ltd et google.tech comme exemples non pris en charge.
  • Il « may be hidden in sellers.json until we have verified that you own the URL » (peut rester masqué dans sellers.json tant que Google n’a pas vérifié que vous possédez l’URL).
  • Si votre compte est confidentiel ou si vous n’avez pas de présence web, vous n’avez pas besoin d’en indiquer un.

Ce domaine compte pour ads.txt 1.1 : la spécification de l’IAB indique que la valeur OWNERDOMAIN de votre ads.txt doit correspondre au domain de votre entrée sellers.json. Ce lien est expliqué dans OWNERDOMAIN et MANAGERDOMAIN.

Le réglage est-il partagé avec AdMob et Ad Manager ?

Oui. Google indique que « your transparency status and domain will be shared across all products. It’s not possible to be confidential for one product and transparent in another. » (votre statut de transparence et votre domaine seront partagés entre tous les produits ; il n’est pas possible d’être confidentiel pour un produit et transparent pour un autre.) Activer la transparence dans AdSense l’active aussi pour vos comptes AdMob et Ad Manager, et le domaine d’entreprise se propage de la même façon. Chaque produit conserve son propre seller_id.

Les intermédiaires et les comptes BOTH n’ont pas ce choix : Google indique qu’ils « have is_confidential set to false by default » (ont is_confidential défini sur false par défaut) et n’ont pas le contrôle « Seller information visibility ». Si vous envisagez de passer à Ad Manager ou de travailler avec un partenaire, voir AdSense et Ad Manager.

Comment trouver ma propre entrée ?

Google suggère de télécharger le fichier et d’y chercher avec Ctrl+F (Commande+F sur Mac). À environ 99 Mo, la recherche peut être lente dans un navigateur ou un éditeur de texte. Depuis un terminal :

curl -sL https://realtimebidding.google.com/sellers.json -o sellers.json
grep -A4 '"pub-0000000000000000"' sellers.json

Remplacez les zéros par votre identifiant d’éditeur (dans AdSense sous Account, Settings, Account information, dans le champ « Publisher ID »). -L est indispensable à cause de la redirection ; sans lui, curl enregistre une réponse de redirection vide. -A4 affiche les quatre lignes qui suivent la correspondance, ce qui couvre le reste d’une petite entrée, car le fichier est mis en forme avec une clé par ligne.

Si votre identifiant est introuvable, vérifiez que vous avez utilisé la forme pub- sans le préfixe ca-. Si vous venez de passer à Transparent, attendez 24 heures et téléchargez à nouveau.

Qu’est-ce qui peut mal tourner ?

Ce que vous constatez Raison probable Que faire
L’entrée reste confidentielle après le changement Moins de 24 heures écoulées, ou copie en cache Télécharger à nouveau le fichier plus tard
Nom affiché, domaine absent Domaine non ajouté ou pas encore vérifié L’ajouter dans « Seller information visibility » et terminer la vérification
Mauvais nom affiché Nom du profil de paiements Le modifier en sachant qu’un retard de paiement de 2 semaines s’applique
Nom visible après être repassé à Confidential Anciennes copies du fichier Google note que des données transparentes passées peuvent rester visibles
seller_type vaut BOTH ou INTERMEDIARY Classification du compte par Google Revoir la propriété et le paiement de l’inventaire ; il n’y a pas de commutateur

Où la documentation de Google et le fichier divergent

Deux détails de la page d’aide de Google ne correspondent pas au fichier téléchargé par la rédaction. L’exemple de la page d’aide utilise "sellerId" et "sellerType", alors que le fichier réel et la spécification de l’IAB utilisent seller_id et seller_type. La page d’aide décrit is_confidential comme « true », alors que le fichier utilise l’entier 1, comme l’exige la spécification. Si vous écrivez des scripts, fiez-vous au fichier réel et à la spécification de l’IAB, et non à l’exemple de la page d’aide. Les autres spécifications ouvertes de la même famille sont cartographiées dans les spécifications IAB Tech Lab.

Questions fréquentes

Suis-je obligé de rendre transparentes mes informations vendeur AdSense ?

Non. Confidential est un choix valide et n'empêche pas la diffusion des annonces. Google encourage la transparence et indique que si vos informations ne sont pas transparentes, les annonceurs ne pourront pas voir votre nom, ce qui peut avoir un impact sur vos revenus. Mettez cela en balance avec la confidentialité : pour un compte de particulier, le nom indiqué est votre nom de bénéficiaire du paiement, issu du profil de paiements.

Quel nom apparaît dans sellers.json ?

Le nom de votre profil de paiements AdSense : la section « Name and address » pour les comptes de particuliers, ou la section « Business name and address » pour les comptes d'entreprise. Vous ne pouvez pas saisir un autre nom d'affichage. Google avertit que modifier ce nom entraîne un retard de paiement automatique de 2 semaines : vérifiez donc le profil de paiements avant de passer à Transparent.

Combien de temps faut-il pour que mon entrée change ?

Google indique que votre nom, votre domaine s'il est renseigné et votre identifiant d'éditeur apparaissent dans son sellers.json dans les 24 heures qui suivent la sélection de Transparent. Le domaine d'entreprise peut rester masqué tant que Google n'a pas vérifié que vous en êtes propriétaire. Les acheteurs et les outils qui mettent le fichier en cache peuvent mettre plus longtemps à refléter le changement de leur côté.

Si je repasse à Confidential, mon nom disparaît-il partout ?

Il est retiré des versions futures du fichier de Google, mais Google précise que votre identifiant d'éditeur reste le même : les informations vendeur de la période où votre statut était transparent pourraient donc rester visibles pour des tiers. Quiconque a enregistré une copie antérieure du fichier, ou constitué une base de données à partir de celui-ci, en conserve l'historique.

Sources

  1. Provide your seller information with sellers.json · Google AdSense Help
  2. Sellers.json · IAB Tech Lab
  3. sellers.json Supply Chain Transparency · IAB Tech Lab
  4. Ads.txt Version 1.1 · IAB Tech Lab