> For the complete documentation index, see [llms.txt](https://support.gamoshi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.gamoshi.com/gamoshi-wiki/general-information/guide-to-ads.txt-and-sellers.json-implementation.md).

# Guide to ads.txt and sellers.json Implementation

## Overview

To ensure your inventory is monetized correctly and complies with IAB transparency standards, the platform integrates ads.txt and sellers.json management directly into the [**Business Partners**](/gamoshi-wiki/core-entities/business-partners.md) entity.

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

***

## 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 serves as a public list of those 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.

***

## How the Gamoshi Platform Manages Identity

These features are managed through the **Business Partner entity**. 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.

{% hint style="info" %}
**Legacy IDs:** If you already have an existing Seller ID that a publisher is using, you don't need to change it. Enter a **Legacy Value** in the "Seller JSON ID" field, and the system will use that instead of the auto-generated one.
{% endhint %}

***

## Implementation Steps

{% stepper %}
{% step %}

### 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 with associated inventory.
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.
   {% endstep %}

{% step %}

### Part B: Advertiser Lines (Reseller)

{% hint style="warning" %}
Your advertisers (demand partners) will often require you to declare them as authorized sellers as well. Since you sit between the publisher and the advertiser, you are the **"Reseller"** for their demand.
{% endhint %}

These records aren't generated by the Gamoshi platform; your advertisers/buyers provide them directly.

1. **Collect records:** Ask your advertisers for their ads.txt records. These will usually end in RESELLER.
2. **Combine:** 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.
   {% endstep %}

{% step %}

### Part C: Setting Up SCHAIN and Sellers.json

This advanced step is 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:** Fill in all mandatory fields, including business info, contact details, and technical specs.
3. **Automatic bid transparency:** Once activated, the system automatically injects SCHAIN values into bid requests sent to advertisers.
4. **Hosting the file:** If you have the ads.txt Management module (available for PE enterprise accounts), you can mark partners for inclusion and generate the actual sellers.json file to upload to your domain.
   {% endstep %}
   {% endstepper %}

***

## 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 bring 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 "Reseller," so the bouncer knows they're with you and lets them in.

The 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're bringing along.

***

## Related articles

* [Business Partners](/gamoshi-wiki/core-entities/business-partners.md)
* [How to create a Business partner](/gamoshi-wiki/how-to-guides/how-to-create-a-business-partner.md)
* [How to map SCHAIN in a mapping rule](/gamoshi-wiki/how-to-guides/how-to-map-schain-in-a-mapping-rule.md)