Skip to content
English
More support
Gamoshi.com
  • There are no suggestions because the search field is empty.

Guide to ads.txt and sellers.json Implementation

A general guide to ads.txt and sellers.json

Content

 

Overview

To ensure your inventory is monetized correctly and complies with IAB transparency standards, our platform integrates ads.txt and sellers.json management directly into the Business Partners module.

Here is an overview of how these protocols work, how to handle lines from your advertisers, and how to configure everything in your account.

 

1. The Concepts: What are they?

These are industry standards designed to prevent fraud and ensure buyers trust your inventory.

  • ads.txt (Authorized Digital Sellers): A text file hosted on the publisher's website. It acts as a public list of who is authorized to sell their ad space.
  • sellers.json: A file hosted by you (the network/platform) that identifies the entities selling inventory through your system.
  • SCHAIN (Supply Chain): A protocol that sends transparency data automatically inside the bid request to advertisers.

 

2. How the Platform Manages Identity

In our system, these features are managed through Business Partners. When you associate an inventory source with a Business Partner, the platform automatically generates a Universal Identifier.

This single ID synchronizes the entire chain:

  • Publisher ID: The ID sent in the bid request to the advertiser.
  • Seller ID: The ID listed in your sellers.json file.
  • Account ID: The ID the publisher must place in their ads.txt file.

Note on Legacy IDs: If you already have an existing Seller ID that a publisher is using, you do not have to change it. You can enter a Legacy Value in the "Seller Json Id" field, and the system will use that instead of the auto-generated one.

 

3. Implementation Steps

Part A: Your Network Line (Direct)

This step authorizes you (the Network) to sell the Publisher's inventory.

  1. Create/Select a Business Partner: Navigate to the Business Partners module and open a partner that has Inventory associated with it.
  2. Verify Info: Ensure basic business information is filled out.
  3. Get the File: Go to the Business Partners grid and look for the "Supply Ads.txt" column. Click "View".
  4. Action: Copy this text. This is the DIRECT line that authorizes your platform.

Part B: Advertiser Lines (Reseller)

Important: Your advertisers (Demand Partners) will often require you to declare them as authorized sellers as well. Since you are sitting between the publisher and the advertiser, you are the "Reseller" for their demand.

These records are not generated by the Gamoshi platform; they are provided to you directly by your advertisers/buyers.

  1. Collect Records: Ask your advertisers for their ads.txt records. These will usually end in , RESELLER.
  2. Combine: You must combine the Platform Line (from Part A) with the Advertiser Lines you collected externally.
  3. Send to Publisher: Send the complete list (Your Line + Your Advertisers' Lines) to your inventory partner to implement on their site.

Part C: Setting up SCHAIN and sellers.json

This is an advanced step required to pass supply chain transparency data to buyers.

  1. Activate: Inside the Business Partner details, toggle the "Activate Seller JSON" switch.
  2. Complete Data: You must fill in all mandatory fields, including business info, contact details, and technical specs.
  3. Automatic Bid Transparency: Once activated, the system will automatically inject SCHAIN values into bid requests sent to advertisers.
  4. Hosting the File: If you have the ads.txt Management module, you can mark partners for inclusion and generate the actual sellers.json file to upload to your domain.

 

The Analogy

  • The Club: The Publisher's Website.
  • The Guest List (ads.txt): Posted at the front door. It tells the bouncer exactly who is allowed to get in.
  • The Promoter (You/The Network): You are the one bringing people to the club.
  • The Promoter's ID (sellers.json): The badge you wear that proves to the club owners you are a legitimate business partner.

How the lines work:

  • Part A (Direct): You put your own name on the Guest List so the bouncer lets you in.
  • Part B (Reseller): You also have VIP friends (Advertisers) coming with you. You must put their names on the Guest List (marked as "Reseller") so the bouncer knows they are with you and allows them in, too.

Our platform automatically prints your ID badge and writes your name on the guest list—you just need to add the names of the VIP friends you are bringing along!