Introduction
app-ads.txt is the companion of ads.txt for software applications distributed through
mobile app stores, connected-TV app stores and similar channels (IAB Tech Lab, “Authorized Sellers for Apps (app-ads.txt)”). A developer publishes it at
/app-ads.txt on the developer website that the app store lists for the app. The file name differs from ads.txt “so that
app and web configurations are managed separately and do not create conflicts between each other”.
Structure
The structure and content are those of ads.txt: records domain, account ID, DIRECT|RESELLER[, certification ID], variables
NAME=value, # comments, and the placeholder record for a file that authorises nobody. The one difference
the specification states is that the SUBDOMAIN variable “is unused in app-ads.txt files and should be ignored if
encountered”. The records and variables page of ads.txt applies.
Verifiers find the file by taking the developer website address from the store listing, reducing it to its registrable domain using the Public
Suffix List (a file on the listed subdomain is used first, and the parent’s file only if the subdomain has none), and fetching
/app-ads.txt. The explorer does none of that: it reads a file you drop.
In the explorer
A file named app-ads.txt opens in the same viewer as ads.txt, with one more message: a SUBDOMAIN line is noted (a message that starts with “Note:”) as
unused. It is recognised by its name and, as for ads.txt, by name alone when the text is not HTML and holds a valid record or a variable
(so a file with many faulty lines still opens here and shows its Issues); any other file with this name opens as plain text. Long
tables are paged 200 rows at a time and the Overview gives the total; there is no size limit on the claim (see ads.txt
for the details).
Not described
Known, not yet covered
- Reference: the app store side (structured app information, the
storeurlparameter in bid requests, domain canonicalisation test cases in the specification’s appendices) is not described. - Reference: a version number of app-ads.txt: the specification text read for this page (“Authorized Sellers for Apps”, the Supply-Chain-Validation repository) states none, so this page and the viewer give none; the name “app-ads.txt 1.0” used by IAB Tech Lab elsewhere was not verified.
- Viewer: the same limits as ads.txt: no Public Suffix List, no sellers.json, no highlighting.
Links
Reference
- Authorized Sellers for Apps (app-ads.txt) – the specification text
- IAB Tech Lab: ads.txt and app-ads.txt – the home of both specifications