ads.txt et sellers.json

app-ads.txt et ads.txt : site du développeur, fiches des stores et façon dont les vérificateurs trouvent le fichier

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

L'essentiel

  • ads.txt autorise les vendeurs de l'inventaire d'un site web et se trouve à la racine du domaine du site ; app-ads.txt autorise les vendeurs de l'inventaire d'une application et se trouve sur le site du développeur indiqué dans l'app store.
  • Selon la spécification app-ads.txt de l'IAB Tech Lab, publier l'URL d'un site de développeur dans la fiche de l'app store est obligatoire pour que l'inventaire d'une application participe au dispositif.
  • Les vérificateurs déduisent l'emplacement d'app-ads.txt de l'URL du développeur : ils conservent le premier sous-domaine placé avant le domaine enregistrable, suppriment www. ou m., ajoutent /app-ads.txt et essaient d'abord HTTPS.
  • La directive subdomain= utilisée dans ads.txt n'est pas utilisée dans app-ads.txt et doit être ignorée ; le fichier d'un sous-domaine est utilisé s'il existe, sinon celui du domaine parent.
  • La spécification demande aux vérificateurs d'explorer les fiches des app stores au plus une fois par semaine et suggère de laisser en ligne l'ancien fichier app-ads.txt pendant environ 30 jours après un changement de domaine du développeur.
Personnes utilisant des smartphones dans une gare
Image: Smartphone use at railway station,Rawpixel.com,CC0,via Wikimedia Commons.

ads.txt indique qui peut vendre de la publicité sur un site web et se place à la racine du site, par exemple example.com/ads.txt. app-ads.txt joue le même rôle pour les applications mobiles et de télévision connectée, mais les vérificateurs le trouvent par l’intermédiaire de l’app store : ils lisent le site du développeur dans la fiche de l’application et récupèrent /app-ads.txt sur ce domaine. Le format des lignes est identique ; la découverte du fichier et les règles de sous-domaine diffèrent.

Comparaison côte à côte

ads.txt app-ads.txt
Couvre Inventaire web (sites) Inventaire d’applications (mobile, TV connectée, autres apps distribuées par un store)
Spécification IAB Tech Lab ads.txt 1.1 IAB Tech Lab app-ads.txt
Emplacement du fichier Racine du domaine du site Racine du site du développeur indiqué dans la fiche du store
Comment les vérificateurs le trouvent Domaine de la page qui affiche l’annonce URL du store, puis balise meta appstore:developer_url, puis le domaine
Directive subdomain= Prise en charge, déclarée dans le fichier racine « Unused » (non utilisée) et « should be ignored » (doit être ignorée)
Gestion des sous-domaines Domaine racine d’abord ; fichier du sous-domaine seulement s’il est délégué Premier sous-domaine essayé d’abord, domaine parent en repli
Protocole Google explore HTTP et HTTPS HTTPS d’abord, HTTP seulement « if SSL is unavailable » (si SSL n’est pas disponible)
Format des enregistrements domaine, identifiant de compte, DIRECT ou RESELLER, identifiant de certification facultatif Identique à ads.txt

La spécification app-ads.txt indique que « the structure and content of the app-ads.txt file is the same as ads.txt for web files » (la structure et le contenu du fichier app-ads.txt sont les mêmes que ceux d’ads.txt pour les fichiers web), et que le nom de fichier différent existe « so that app and web configurations are managed separately and do not create conflicts » (afin que les configurations des applications et du web soient gérées séparément et ne créent pas de conflits). Tout ce que la syntaxe d’ads.txt dit des champs, des commentaires et des variables s’applique aux deux fichiers.

Comment les vérificateurs trouvent-ils l’app-ads.txt d’une application ?

La spécification décrit trois participants :

  1. Les développeurs d’applications « provide a website URL in their app’s store metadata and publish an app-ads.txt file on that website » (indiquent l’URL d’un site web dans les métadonnées de leur application sur le store et publient un fichier app-ads.txt sur ce site).
  2. Les app stores publient les métadonnées de l’application dans des balises HTML <meta> sur chaque page de fiche.
  3. Les vérificateurs de vendeurs autorisés explorent les fiches des stores pour y lire l’URL du développeur, puis explorent le site du développeur pour y trouver le fichier.

Les balises définies par la spécification côté store :

<meta name="appstore:developer_url" content="https://www.path.to/page" />
<meta name="appstore:bundle_id" content="com.example.myapp" />
<meta name="appstore:store_id" content="SKU12345" />

Vous n’ajoutez pas ces balises vous-même : le store les génère à partir du site du développeur que vous saisissez dans la console du store. Ce que vous contrôlez, c’est ce champ. La spécification est explicite : « Publishing a website and providing its URL is required for the app’s ad inventory to participate in the authorized seller scheme » (publier un site web et en fournir l’URL est obligatoire pour que l’inventaire publicitaire de l’application participe au dispositif des vendeurs autorisés).

La requête d’enchère transporte un storeurl, qui permet au vérificateur de passer d’une opportunité publicitaire à la fiche, de la fiche à votre domaine, puis de votre domaine à votre liste de vendeurs autorisés.

Comment l’URL du développeur devient-elle un chemin de fichier ?

Les étapes « Translate developer URL to an app-ads.txt path » de la spécification :

  1. Extraire le nom d’hôte.
  2. Ne conserver que le premier (et, s’il existe, le deuxième) nom placé avant le suffixe public.
  3. Supprimer tout préfixe www. ou m..
  4. Ajouter /app-ads.txt.
  5. Essayer HTTPS d’abord, puis HTTP « if SSL is unavailable ».

Exemples tirés de l’annexe A de la spécification :

URL du développeur dans le store Domaine utilisé
https://www.example.com/test example.com
https://m.example.com/test example.com
https://subdomain.example.com/test subdomain.example.com
https://another.subdomain.example.com/test subdomain.example.com
https://subdomain.www.example.com/test example.com
https://www.example.co.uk/test example.co.uk

Vient ensuite la règle de repli : les vérificateurs « must use the app-ads.txt file found on the subdomain » (doivent utiliser le fichier app-ads.txt trouvé sur le sous-domaine), « only defaulting to the app-ads.txt file found on the subdomain’s parent if no file is found on that subdomain » (et ne se rabattent sur le fichier du parent du sous-domaine que si aucun fichier n’est trouvé sur ce sous-domaine).

C’est le sens inverse de celui d’ads.txt. Pour les sites web, le fichier du domaine racine s’applique aux sous-domaines, sauf s’il les délègue avec subdomain=, comme l’explique ads.txt et les sous-domaines. Pour les applications, un fichier placé sur le sous-domaine du développeur prime automatiquement.

Pourquoi les éditeurs ont-ils souvent besoin des deux fichiers ?

De nombreuses entreprises possèdent à la fois un site web et des applications. Les deux fichiers servent des inventaires différents et sont contrôlés par des processus différents :

  • Les annonces affichées sur les pages de example.com sont comparées à example.com/ads.txt.
  • Les annonces affichées dans une application dont la fiche de store indique https://example.com sont comparées à example.com/app-ads.txt.

Les deux fichiers peuvent coexister à la même racine. Chacun ne contient que les vendeurs de son propre inventaire. Un vendeur qui vend à la fois votre inventaire web et votre inventaire d’applications, comme Google, peut apparaître dans les deux fichiers, avec l’identifiant de compte du produit qui vend chaque type d’inventaire.

La page d’aide de Google sur sellers.json confirme cette séparation des comptes : un éditeur peut avoir des comptes AdSense, AdMob et Ad Manager, le « seller_id is unique to each product » (seller_id est propre à chaque produit), et votre statut de transparence ainsi que votre domaine d’entreprise sont partagés entre les trois. L’identifiant d’éditeur de votre app-ads.txt peut donc différer de celui de votre ads.txt. Copiez chaque ligne depuis le compte qui monétise l’inventaire concerné. AdSense lui-même est conçu pour les pages web ; dans les applications, les annonces AdSense ne sont autorisées que dans des cadres d’affichage de contenu web approuvés, comme le détaille l’article sur les emplacements interdits au code AdSense.

Que faire quand vous changez de site de développeur ?

La spécification demande aux vérificateurs d’explorer chaque fiche de store « no more frequently than weekly » (pas plus d’une fois par semaine) : une modification dans la console du store n’est donc pas instantanée. Ses conseils en cas de changement de domaine :

  1. Publier d’abord app-ads.txt, avec les mêmes entrées, sur le nouveau domaine.
  2. Mettre à jour le site du développeur dans chaque store qui référence l’application.
  3. Conserver le fichier sur l’ancien domaine pendant « an extended period (suggested 30 days, if possible) » (une période prolongée, 30 jours suggérés si possible).
  4. Ne le supprimer qu’ensuite.

Supprimer l’ancien fichier trop tôt risque de provoquer une « non-coverage » (absence de couverture) ; en retirer des entrées risque de rendre l’inventaire « unavailable » (indisponible).

Peut-on répartir les vendeurs entre les applications ?

Pas à l’intérieur d’un même fichier. La spécification précise que les développeurs « who want to partition the authorized sellers between individual apps must use separate developer domains/subdomains » (qui veulent répartir les vendeurs autorisés entre des applications distinctes doivent utiliser des domaines ou sous-domaines de développeur séparés), car un seul app-ads.txt ne peut pas indiquer qu’un vendeur est autorisé pour une partie seulement des applications. Elle ajoute : « We generally advise against attempting to exert fine-grained control using app-ads.txt » (il est généralement déconseillé de chercher à exercer un contrôle fin avec app-ads.txt).

Si vous avez besoin d’une séparation, utilisez un sous-domaine par groupe d’applications, par exemple games.example.com et tools.example.com, renseignez en conséquence le site du développeur de chaque application, et publiez un fichier sur chaque sous-domaine. Avec la règle de sous-domaine ci-dessus, chaque fichier est utilisé avant celui du domaine parent.

Un développeur sans vendeur publicitaire a-t-il besoin d’un fichier ?

C’est facultatif. La spécification renvoie aux consignes d’ads.txt pour les « files without authorized advertising system records » (fichiers sans enregistrement de système publicitaire autorisé). Dans ads.txt 1.1, la façon d’indiquer qu’aucun vendeur n’est autorisé consiste à utiliser un enregistrement de substitution unique :

placeholder.example.com, placeholder, DIRECT, placeholder

Comment tester mon app-ads.txt comme un vérificateur ?

Commencez par copier exactement le site du développeur tel qu’il apparaît dans chaque fiche de store, puis appliquez les règles de conversion ci-dessus pour obtenir le domaine. Récupérez ensuite le fichier en HTTPS, que la spécification dit essayé en premier par les vérificateurs :

curl -sIL https://example.com/app-ads.txt
curl -sL https://example.com/app-ads.txt

La première commande doit se terminer par le statut 200 et un type de contenu texte brut ; la seconde doit afficher vos lignes de vendeurs, et non du HTML. Si l’URL du développeur utilise un sous-domaine, testez d’abord ce sous-domaine, puis le domaine parent, car c’est l’ordre que la spécification donne aux vérificateurs. Répétez l’opération pour chaque store où l’application est référencée : si deux stores indiquent des sites de développeur différents, chaque domaine a besoin d’un fichier.

Dépannage d’app-ads.txt

Problème Cause probable Solution
Fichier sur example.com/app-ads.txt, mais le store indique https://studio.example.com Le vérificateur cherche d’abord sur studio.example.com Placer le fichier sur le sous-domaine, ou modifier l’URL dans le store
Seul un fichier ads.txt existe Mauvais nom de fichier pour les applications Ajouter app-ads.txt
La fiche du store n’indique aucun site de développeur La spécification l’exige Ajouter l’URL dans chaque console de store
Modifications non prises en compte Fiches de store explorées au plus une fois par semaine Patienter ; conserver les anciens fichiers lors d’un changement de domaine
Lignes subdomain= ajoutées Ignorées dans app-ads.txt Utiliser un fichier par sous-domaine
Page HTML ou erreur 404 sur /app-ads.txt Mêmes problèmes de diffusion qu’avec ads.txt Appliquer les contrôles de ads.txt « Not found » ou « Unauthorized »

Les exigences de diffusion sont communes avec ads.txt : un fichier en texte brut au chemin exact, un statut 200, aucune page HTML de repli, aucun défi anti-robot. Les tests curl qui fonctionnent pour /ads.txt fonctionnent pour /app-ads.txt en changeant le chemin.

Questions fréquentes

Puis-je mettre mes vendeurs d'application dans ads.txt plutôt que dans app-ads.txt ?

Non. La spécification app-ads.txt de l'IAB utilise un nom de fichier distinct pour que les configurations des applications et du web soient gérées séparément et n'entrent pas en conflit. Les vérificateurs qui contrôlent l'inventaire d'une application cherchent /app-ads.txt sur le domaine du développeur indiqué dans la fiche du store, et non /ads.txt. Si le même domaine héberge à la fois un site web et votre page de développeur, publiez les deux fichiers côte à côte à la racine.

app-ads.txt doit-il être sur le même domaine que mon site web ?

Seulement si ce domaine est le site du développeur saisi dans la fiche de l'app store. Les vérificateurs lisent l'URL du développeur dans le store, la normalisent et récupèrent /app-ads.txt à cet endroit. Si votre fiche pointe vers un autre domaine, par exemple le site d'un studio, le fichier doit se trouver sur ce domaine. Modifier l'un sans l'autre est une cause fréquente de signalement d'une application comme non autorisée.

Puis-je autoriser un vendeur pour une seule de mes applications ?

Pas dans un seul fichier. La spécification précise qu'aucune disposition ne permet d'autoriser un vendeur pour seulement une partie des applications dans un même app-ads.txt. Les développeurs qui veulent des listes de vendeurs différentes par application doivent utiliser des domaines ou sous-domaines de développeur distincts, chacun indiqué dans les fiches concernées, et la spécification déconseille en général un contrôle fin via app-ads.txt.

Combien de temps faut-il pour qu'une modification soit prise en compte ?

La spécification ne fixe pas de calendrier de nouvelle exploration pour les fichiers app-ads.txt eux-mêmes, mais elle demande aux vérificateurs d'explorer chaque fiche de store au plus une fois par semaine. Un changement d'URL de développeur dans le store peut donc mettre du temps à être remarqué. La spécification suggère de conserver l'ancien fichier pendant une période prolongée, environ 30 jours si possible, après un changement de domaine.

Sources

  1. IAB Tech Lab Authorized Sellers for Apps (app-ads.txt) · IAB Tech Lab
  2. Ads.txt Version 1.1 · IAB Tech Lab
  3. Ensure your ads.txt files can be crawled · Google AdSense Help
  4. Provide your seller information with sellers.json · Google AdSense Help