ads.txt et sellers.json

OWNERDOMAIN et MANAGERDOMAIN dans ads.txt 1.1 : syntaxe, quand les ajouter et cohérence avec sellers.json

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

L'essentiel

  • OWNERDOMAIN et MANAGERDOMAIN sont des variables ajoutées à la spécification ads.txt de l'IAB Tech Lab dans la version 1.1, publiée en 2022.
  • OWNERDOMAIN déclare le domaine d'entreprise de l'entité propriétaire du site ; la spécification la marque comme recommandée et précise qu'elle doit être égale au champ domain de vos entrées dans sellers.json.
  • Si OWNERDOMAIN est absente, la spécification indique que les consommateurs du fichier doivent supposer que le domaine propriétaire est celui où le fichier ads.txt a été trouvé.
  • MANAGERDOMAIN est facultative et déclare un partenaire de monétisation principal ou exclusif, au niveau mondial ou pour un seul pays, au format domaine, suivi d'un code pays à deux lettres facultatif.
  • Les pages d'aide AdSense de Google ne disent pas si AdSense lit OWNERDOMAIN ou MANAGERDOMAIN ; ces variables s'adressent aux acheteurs et aux outils de validation qui comparent ads.txt à sellers.json.
Pièces de puzzle rouges
Image: Red jigsaw puzzle pieces,Profpcde,CC0,via Wikimedia Commons.

OWNERDOMAIN et MANAGERDOMAIN sont deux variables facultatives ajoutées dans ads.txt 1.1. OWNERDOMAIN=example.com désigne l’entreprise propriétaire du site et doit correspondre au domaine de vos entrées dans sellers.json. MANAGERDOMAIN=partner.com désigne un partenaire de monétisation exclusif, au niveau mondial ou par pays. Aucune des deux n’autorise un vendeur, et les pages d’aide AdSense de Google n’en demandent aucune.

Quel problème ces variables résolvent-elles ?

Avant la version 1.1, une ligne d’ads.txt indiquait qu’un compte vendeur pouvait vendre l’inventaire d’un site, et le champ DIRECT ou RESELLER décrivait la relation. Les acheteurs n’avaient aucun moyen standard de vérifier si une mention DIRECT était exacte, ni de distinguer l’inventaire détenu de l’inventaire revendu.

Le guide d’implémentation d’ads.txt 1.1 de l’IAB Tech Lab énumère les objectifs : « linking ads.txt/app-ads.txt directly to sellers.json » (relier directement ads.txt/app-ads.txt à sellers.json), identifier les « primary, or exclusive representatives of a publisher’s inventory » (représentants principaux ou exclusifs de l’inventaire d’un éditeur) grâce à MANAGERDOMAIN, et relier « the sellers.domain listed in sellers.json and the ads.txt file » (le sellers.domain indiqué dans sellers.json et le fichier ads.txt). Les deux variables donnent aux acheteurs un domaine à comparer au champ domain du sellers.json de chaque système publicitaire.

Le journal des modifications de la spécification ads.txt 1.1 indique pour cette version « April 2022 public comment July 2022 final release » (consultation publique en avril 2022, version finale en juillet 2022), tandis que la couverture du guide d’implémentation mentionne « Released August 2022 » (publié en août 2022).

Quelle est la syntaxe exacte ?

Toutes deux sont des déclarations de variable de la forme VARIABLE=valeur, comme CONTACT et subdomain. Exemple tiré de la section 4.8 de la spécification :

OWNERDOMAIN=mediacompany.com
MANAGERDOMAIN=yellowmediamanager.com, FR
MANAGERDOMAIN=bluemediamanager.com, US
greenadexchange.com, XF7342, DIRECT, 5jyxf8k54
OWNERDOMAIN MANAGERDOMAIN
Statut dans la spécification « Recommended » (recommandée) « Optional, use only when relevant » (facultative, à utiliser seulement si pertinent)
Valeur Domaine racine (Public Suffix List plus un libellé) Domaine racine, puis code pays ISO 3166-1 alpha-2 facultatif
Nombre Une ; « only the first should be used » (seule la première doit être utilisée) si elle est répétée Plusieurs admises, « but only one per country » (mais une seule par pays)
Si absente Propriétaire supposé : le domaine où le fichier se trouve Aucun gestionnaire déclaré
Doit correspondre à domain de vos entrées PUBLISHER dans sellers.json domain du gestionnaire dans sellers.json

La spécification indique que les variables peuvent figurer n’importe où et recommande de les placer « at the end of the file » (à la fin du fichier) pour la lisibilité. L’exemple de la spécification les place pourtant en tête ; les deux fonctionnent. Le format général des lignes est présenté dans la syntaxe d’ads.txt.

Que déclare OWNERDOMAIN ?

La spécification la définit comme « the business domain of the business entity that owns the domain/site/app (e.g., example.com owns example1.com, example2.com, etc.) » (le domaine d’entreprise de l’entité qui possède le domaine, le site ou l’application, par exemple example.com possède example1.com, example2.com, etc.). Trois règles de la spécification :

  • Elle « should be the same value as the sellers.domain in this Publisher’s entries in referenced sellers.json files » (doit avoir la même valeur que sellers.domain dans les entrées de cet éditeur des fichiers sellers.json référencés).
  • Elle doit être « Public Suffix List+1, not a full hostname or a URL » (Public Suffix List+1, et non un nom d’hôte complet ni une URL).
  • Il est « recommended that this field is included even if the OWNERDOMAIN is the same as the domain on which the ads.txt file is found » (recommandé d’inclure ce champ même si OWNERDOMAIN est identique au domaine sur lequel le fichier ads.txt se trouve).

Ainsi, une société nommée Example Media qui possède recipes-site.com et travel-site.net indiquerait OWNERDOMAIN=examplemedia.com dans les fichiers ads.txt des deux sites. Un éditeur indépendant qui ne possède que myblog.com et n’a pas de domaine d’entreprise distinct écrirait OWNERDOMAIN=myblog.com.

Comment OWNERDOMAIN se relie-t-elle au sellers.json de Google ?

Le guide d’implémentation énonce la règle côté éditeur : « All accounts authorized in your ads.txt that are PUBLISHER in the corresponding sellers.json file should also have a sellers.domain in sellers.json that matches the OWNERDOMAIN in your ads.txt. » (Tous les comptes autorisés dans votre ads.txt qui sont de type PUBLISHER dans le fichier sellers.json correspondant doivent aussi avoir dans sellers.json un sellers.domain qui correspond à l’OWNERDOMAIN de votre ads.txt.)

Pour un éditeur AdSense, ce sellers.domain est le domaine d’entreprise que vous définissez dans AdSense sous Account, Settings, Account information, dans la section « Seller information visibility ». La page d’aide de Google sur sellers.json précise que le domaine d’entreprise n’apparaît que si vous sélectionnez « Transparent », et qu’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).

Votre réglage AdSense Votre entrée dans le sellers.json de Google Un acheteur peut-il rapprocher OWNERDOMAIN ?
Transparent, domaine d’entreprise vérifié Inclut domain Oui, si les valeurs sont égales
Transparent, sans domaine Nom seulement Aucun domaine à comparer
Confidential Identifiant et type de vendeur seulement Non

Si votre entrée est confidentielle dans sellers.json, OWNERDOMAIN dans votre ads.txt ne peut pas être recoupée avec votre entrée Google, bien qu’elle indique toujours la propriété à quiconque lit le fichier. Le réglage de visibilité complet est expliqué dans sellers.json pour AdSense.

Que déclare MANAGERDOMAIN ?

La spécification décrit MANAGERDOMAIN comme « the business domain of a primary or exclusive monetization partner of the publishers inventory » (le domaine d’entreprise d’un partenaire de monétisation principal ou exclusif de l’inventaire de l’éditeur). Elle « should only be used for a seller who is not the publisher but is the primary or exclusive programmatic seller for this site » (ne doit servir que pour un vendeur qui n’est pas l’éditeur mais qui est le vendeur programmatique principal ou exclusif de ce site), ce qui « will typically only apply if the publisher is not selling their own inventory in the given market » (ne s’appliquera en général que si l’éditeur ne vend pas lui-même son inventaire sur le marché concerné).

Détails de syntaxe de la spécification :

  • MANAGERDOMAIN=manager.com, sans pays, est la valeur globale par défaut.
  • MANAGERDOMAIN=manager.com, FR s’applique à un seul pays et remplace la valeur par défaut pour ce pays.
  • Une seule par pays. Le guide d’implémentation recommande que les consommateurs traitent deux gestionnaires pour le même pays « as if there is no MANAGERDOMAIN declared for that country » (comme si aucune MANAGERDOMAIN n’était déclarée pour ce pays).

Le conseil du guide d’implémentation aux éditeurs est restreint : « only use MANAGERDOMAIN if a majority of your inventory is managed by a single entity » (n’utilisez MANAGERDOMAIN que si la majorité de votre inventaire est gérée par une seule entité). Il avertit aussi : « if the same inventory is available through multiple sellers, and you still use MANAGERDOMAIN, buyers will likely treat the other non-manager accounts as RESELLER entries » (si le même inventaire est disponible via plusieurs vendeurs et que vous utilisez quand même MANAGERDOMAIN, les acheteurs traiteront probablement les autres comptes non gestionnaires comme des entrées RESELLER).

Un éditeur AdSense doit-il les ajouter ?

Votre situation OWNERDOMAIN MANAGERDOMAIN
Un site, AdSense seulement, vous êtes le bénéficiaire du paiement Facultative ; recommandée par la spécification, par exemple OWNERDOMAIN=yoursite.com Non
Plusieurs sites appartenant à une même société Oui, le domaine de la société dans chaque fichier Non
Une régie ou un partenaire vend la majeure partie de votre inventaire Oui Oui, le domaine du partenaire
Partenaire différent pour un seul pays Oui Une ligne avec ce code pays
Vous revendez l’inventaire d’autres éditeurs Oui, dans les fichiers que vous possédez ; suivez les consignes de vos partenaires dans les leurs Possiblement, dans les fichiers que vous gérez

Google ne documente pas si AdSense utilise l’une ou l’autre variable, et l’extrait « Ads.txt snippet » d’AdSense ne contient que la ligne d’autorisation. Ajouter OWNERDOMAIN ne change pas votre statut AdSense, et son absence ne provoque pas de statut « Unauthorized ». La valeur est destinée aux autres acheteurs et aux outils de validation qui mettent en œuvre ads.txt 1.1. Si vous passez à une configuration gérée ou à Ad Manager via un partenaire, c’est normalement le partenaire qui vous indique les lignes et variables à ajouter ; voir AdSense et Ad Manager.

À quoi ressemble un fichier complet pour un site AdSense typique ?

Un éditeur qui possède myrecipes.com, vend uniquement via AdSense et a défini myrecipes.com comme domaine d’entreprise vérifié dans « Seller information visibility » pourrait publier :

google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0
OWNERDOMAIN=myrecipes.com

Le même éditeur après avoir vendu le site à un groupe de médias dont le domaine sellers.json est bigmedia.com, avec une régie qui gère la France seulement :

google.com, pub-1111111111111111, DIRECT, f08c47fec0942fa0
OWNERDOMAIN=bigmedia.com
MANAGERDOMAIN=saleshouse-example.com, FR

Dans le second cas, la ligne AdSense doit reprendre l’identifiant d’éditeur du nouveau propriétaire, et la régie ajouterait ses propres lignes de vendeur selon sa documentation.

Quelles erreurs éviter ?

Erreur Pourquoi c’est incorrect Forme correcte
OWNERDOMAIN=https://www.example.com/ Il faut un domaine racine, pas une URL OWNERDOMAIN=example.com
OWNERDOMAIN=blog.example.com Nom d’hôte, et non PSL+1 OWNERDOMAIN=example.com
Deux lignes OWNERDOMAIN différentes Seule la première est utilisée N’en garder qu’une
OWNERDOMAIN différente du domaine de votre sellers.json Les acheteurs ne peuvent pas la rapprocher Utiliser le même domaine dans les deux
MANAGERDOMAIN=manager.com, France Le pays doit être un code ISO à deux lettres MANAGERDOMAIN=manager.com, FR
Deux lignes MANAGERDOMAIN pour le même pays Traitées comme l’absence de gestionnaire pour ce pays Une par pays
MANAGERDOMAIN pour un partenaire qui vend une petite part Contredit « principal ou exclusif » L’omettre

Comment vérifier votre fichier ?

Récupérez le fichier et affichez les lignes de variables :

curl -sL https://example.com/ads.txt | grep -iE '^(ownerdomain|managerdomain)='

Comparez ensuite la valeur d’OWNERDOMAIN au domain de votre entrée dans le sellers.json de Google, avec la méthode grep -A4 du guide sur sellers.json. Attention : les outils diffèrent. Le robot de référence open source de l’IAB est antérieur à la version 1.1 et ne conserve pas ces variables, comme l’explique la vérification d’ads.txt par vos propres moyens. L’ensemble des normes apparentées est cartographié dans les spécifications IAB Tech Lab.

Questions fréquentes

OWNERDOMAIN est-elle nécessaire pour qu'AdSense affiche des annonces ?

Non. Les pages d'aide AdSense de Google décrivent la ligne d'autorisation google.com, pub-..., DIRECT, f08c47fec0942fa0 et ne mentionnent pas OWNERDOMAIN. La spécification de l'IAB marque la variable comme recommandée, et non obligatoire, et précise qu'en son absence les consommateurs doivent supposer que le propriétaire est le domaine où le fichier a été trouvé. L'ajouter est un signal de transparence pour les acheteurs et les outils de validation, pas une exigence d'AdSense.

Quelle valeur mettre dans OWNERDOMAIN ?

Le domaine racine de l'entreprise propriétaire du site, écrit sous la forme example.com, sans protocole, sans www et sans chemin. La spécification précise qu'il doit correspondre au domaine de vos entrées dans sellers.json. Pour AdSense, il s'agit du domaine d'entreprise affiché dans le sellers.json de Google lorsque vos informations de vendeur sont transparentes et que le domaine a été vérifié.

Un petit éditeur doit-il ajouter MANAGERDOMAIN ?

Généralement non. La spécification précise que MANAGERDOMAIN ne doit servir que pour un vendeur qui n'est pas l'éditeur mais qui est le vendeur programmatique principal ou exclusif du site. Le guide d'implémentation ne la recommande que lorsqu'une seule entité gère la majorité de votre inventaire. Si vous vendez vous-même via AdSense, il n'y a aucun gestionnaire à déclarer.

Que se passe-t-il avec deux lignes MANAGERDOMAIN pour le même pays ?

La spécification n'autorise qu'une seule MANAGERDOMAIN par pays. Le guide d'implémentation de l'IAB indique que les entrées contradictoires ne doivent pas être utilisées et seront probablement ignorées, et recommande aux consommateurs de traiter deux gestionnaires pour un même pays comme si aucun gestionnaire n'était déclaré pour ce pays. Conservez une ligne globale sans code pays et, si nécessaire, une ligne par pays précis.

Sources

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