Metadata and search guides

Trace a repeated seller and a conflicting manager country

·

An ads.txt row declares a seller account for web advertising inventory. Compare the fields at their original lines before changing the file, especially when a partner’s account ID contains leading zeros.

Ads.txt Validator

Trace the duplicate to its first seller line

Choose Load example and Validate ads.txt. The example reports one content error and two warnings. The seller on line 3 repeats line 2 even though the domain and relationship use different capitalization.

Open Parsed seller records. Both rows keep 00917 as their account ID. A leading zero is part of the identifier. Field four in the sample is an example certification ID. Compare the actual values with the advertising system’s documentation.

Trace the duplicate to its first seller line
LineFindingEvidence to review
3Duplicate sellerCompare the same 00917 account on line 2
4Invalid relationshipMANAGED begins at column 32
7Repeated manager countryLine 6 already declares the GB slot

IAB Tech Lab, ads.txt specification version 1.1

Choose the relationship from the actual account arrangement

Line 4 uses MANAGED where the spec permits DIRECT or RESELLER. A DIRECT relationship means the publisher controls the listed account. A RESELLER relationship means another entity controls the account and can resell the publisher’s inventory.

The two manager declarations use GB and gb, which represent the same country slot for comparison. Resolve that pair using your actual exclusive manager for the market. A separate global manager is possible when no country suffix is supplied.

IAB Tech Lab, ads.txt specification version 1.1IAB Tech Lab, ads.txt 1.1 Implementation Guide

Check the root document and its subdomain referral

The example file URL has the root location https://example.com/ads.txt. Its SUBDOMAIN value news.example.com lies below that root. Replace the referral with news.example.net and validate again to see the out-of-root error.

Download the JSON report to preserve the text and line references. Compare the intended upload location and its recorded response when you verify the published file. A local syntax check covers the supplied document.

Example of a web file with a referral to one of its subdomains
exchange.example.com, 00917, DIRECT, cert-84
OWNERDOMAIN = example.com
SUBDOMAIN = news.example.com

IAB Tech Lab, ads.txt specification version 1.1Mozilla community Public Suffix List

Common questions

Can I declare more than one contact?

Yes. The spec allows repeated CONTACT lines such as an email and a contact page. The report keeps each supplied declaration.

How does the tool handle a seller followed by a comment?

A hash starts the comment. The seller fields before it are parsed. The complete source is available in the JSON report.

Sources

Put it into practice.

Related guides