AttekmiGet Started
/ Blog/AdTech Insights/
How to Authorize Sellers on Attekmi Solutions Using Sellers.json and Ads.txt?
Jan 8, 2025
AdTech Insights

How to Authorize Sellers on Attekmi Solutions Using Sellers.json and Ads.txt?

How to Authorize Sellers on Attekmi Solutions Using Sellers.json and Ads.txt?

Like every medium that generates a lot of money, the digital advertising ecosystem rapidly attracts fraudsters. By 2027, global ad spending is projected to exceed $870 billion. Likewise, the fraudulent schemes multiply at a breakneck speed becoming more sophisticated and hard to spot. The cost of ad fraud is also increasing – by 2028, it may reach over $170 billion.

However, the industry is fighting back. The first initiatives against ad fraud delivered by IAB were ads.txt, soon after IAB delivered sellers.json, and OpenRTB SupplyChain Object, which, for sure played a big role in ad fraud elimination. What are those standards, how do they work, and how to apply them to verify sellers and resellers of inventory on Attekmi’s solutions? Keep reading to find out.

What is Ads.txt?

In simple terms, ads.txt is a text file stored in the main folder of a website that contains a list of companies that are authorized to sell the publisher’s inventory. 

This anti-fraud standard was developed by IAB in 2017. First and foremost, ads.txt was designed to resolve the problem with so-called “domain spoofing” – a scheme that allows fraudsters to sell low-quality traffic as premium ones. This phenomenon was quite common several years ago: many advertisers were fooled into thinking they buy ad impressions at prestigious websites while in fact ads were broadcasted on other, much cheaper inventory.

Ads.txt solves this problem easily: the file lists all platforms that are allowed to sell the publisher’s inventory (app-ads.txt is a variation of this standard created for the mobile ecosystem).

What is Sellers.json?

Sellers.json is a logical continuation of the ads.txt developed by IAB in 2019. Sellers.json serves as a mechanism thanks to which buyers can find out who the entities that offer inventory at RTB auctions are – direct sellers or resellers. There are two required things that the sellers.json file should contain – the ID of the seller and the type of the seller (indicates whether it is a direct seller, a reseller of the inventory, or both). The rest of the data can change. 

This way, together with ads.txt, sellers.json authorizes inventory and makes the digital advertising ecosystem transparent and safe for advertisers. 

Worth pointing out that sellers.json is closely related to SupplyChain Object which is a part of the OpenRTB bid request. SupplyChain Object consists of nodes that represent all sellers that are paid for an individual bid request. This way with a bid request advertisers can identify the final reseller and also find out if such an entity is really authorized to sell the publisher’s inventory.

Attekmi platform screenshot

Why are These Standards so Important?

Domain spoofing and unauthorized resale of advertising inventory are the most common types of fraud plaguing the advertising landscape these days. As the programmatic advertising market grows, the number of fraudulent schemes multiplies so it becomes very important to ensure transparency and reliability of transactions between all participants.

Sellers.json and ads.txt create greater transparency for everyone involved in programmatic media trading: publishers, advertisers, and ad exchanges.

From an advertiser’s point of view, the standards help to easily determine the trustworthiness of partners on the supply side and thus exclude potential fraudsters. Publishers also benefit: Since the sellers.json file is a public file, publishers can easily notify the ad exchange which entities have the right to sell their inventory.

How to Set Up Sellers.json and Ads.txt on Attekmi’s Ad Exchanges?

Ads.txt. For this, you need to go to the “Companies” section in your dashboard, select the company, and download the ads.txt file for it.


Attekmi platform screenshot

After this, the most important step is to send this file to this SSP partner. Ask them to add your lines from ads.txt to their ads.txt hosted on the websites of publishers. 

Sellers.json. In order to set up sellers.json you need to select the company in the “Companies” section. Pay attention to the Domain column. Note that some companies do not have domains:


Attekmi platform screenshot

Companies without domains appear in sellers.json with an ID but without the domain.

Open the profile of each SSP company without the domain, and add it:


Attekmi platform screenshot

Then, open “Settings”.

To set up sellers.json correctly, you will need to fill in the fields with your contact details and main company domain.


Attekmi platform screenshot

Click “Download file” and move to the next step: place the file on your domain.

How to use sellers.json. After the sellers.json file is downloaded in the settings of sellers.json it should be placed on the company domain.

Together the ads.txt and sellers.json files should have unified IDs that are passed in the Schain object in the requests, that can be checked on public domains, for inventory transparency of the market players like advertisers, publishers, and resellers.

Sellers.json must contain records listed as JSON objects:

{

"contact_email":"smarthub@smart-hub.io",

"contact_address":"New York 5555",

"version":1,

"identifiers": [

{

"name":"TAG-ID",

"value":"a23a4238a0b927520dcc519a6f55841b"

}

],

"sellers": [

{

"seller_id":"7ceab3a1649fda2b3ff8d02edfd5659f",

"seller_type":"INTERMEDIARY",

"name":"SSP_1_Banner_12",

"domain":"Ssp1.com may be for sale - PerfectDomain.com "

},

{

"seller_id":"69add1e107d7f7d035d7dafd4342e1ca",

"seller_type":"INTERMEDIARY",

"name":"SSP_5_Video",

"domain":"ssp5.com"

}

]

}

The main object contains the contact info of the sellers.json issuer, the version of the file, and identifiers, such as TAG-ID.

The sellers’ array must contain objects for each partner. Such an object consists of fields seller_id, seller_type, seller_name, and domain, and also an optional is_passthrough field.

If everything is correct, place the file in the root directory of your main domain, so your partners can scan the file, and scan other sellers.json files down the supply chain.

For example, if the platform URL company.com, sellers.json should be added to the http://company.com domain, the resulting address should be company.com/sellers.json.

Supply Chain Object

If set, each bid request will contain the Schain object that reveals the entire supply chain The request will look like this:

"bidrequest" : {

"id": "BidRequest2",

"app": {

"publisher": {

"id": "aaaaa"

}

}

"source": {

"ext": {

"schain": {

"ver":"1.0",

"complete": 1,

"nodes": [

{

"asi":"directseller.com domain name is for sale. Inquire now. ",

"sid":"00001"

"rid":"BidRequest1",

"hp":1

},

{

"asi":"Reseller Solutions at Name.com ",

The Schain object, as shown above, contains the specification version, the completion flag, and an array of nodes. Each node corresponds to a reseller that is a link in a supply chain. The first node represents the initial advertising system that received the request.

Let’s take a closer look at the object. It contains the following fields:

  • asi – the domain name of the advertising system intermediary.

Note: This should be the same value as used to identify sellers in an ads.txt file if one exists.

  • sid – the identifier of the seller or reseller account within the advertising system.

  • rid – the request ID as issued by the seller or reseller.

  • hp – flag of involvement in the flow of payments.

Note: This field is required and should always be set to 1.

An example of building a supply chain object:

  • The website1.com issues a bid request.

  • The request was received by SSP1.

  • Then, the request is transmitted sequentially to Exchange Platform 1 and to Exchange 2

  • And finally, the request comes to DSP1 that responded with a bid response.

The final supply chain object will look like this:

"nodes": [

{

"asi":"http://ssp1.com ",

"sid":"website1com-id-within-ssp1"

"rid":"BidRequest1",

"hp":1

},

{

"asi":"http://adx1.com ",

"sid":"id-of-ssp1-in-adexchange1"

"rid":"BidRequest2",

"hp":1

},

{

"asi":"reseller2.net",

"sid":"adex1-id-within-reseller2"

"rid":"BidRequest3",

"hp":1

}

]

Final Words

Ads.txt and sellers.json are the solutions that increase the transparency of the entire programmatic ecosystem, prevent fraud, and authorize inventory sellers and resellers.

More specifically, these standards improve the monetization of a publisher’s inventory and instill confidence in programmatic trading among advertisers.

We want to remind you that our solutions ensure your security through data privacy-compliant data processing (GDPR, CCPA, etc.). In addition to ads.txt and sellers.json files, you can integrate multiple traffic and demand scanners to keep your marketplace safe. With all these measures in place, you can create a transparent and highly trusted media-trading space and drive income effectively.

Do you need assistance with generating ads.txt and sellers.json files? Contact us, and we will help! 

Rate:
5/5, 1 review
Share: