sellers-json-ads-txt-supply-chain

Understanding ads.txt: A Guide to Correct Syntax and Format

In the ever-evolving landscape of digital advertising, transparency and trust play crucial roles. To combat ad fraud and ensure fair monetization for publishers, the Interactive Advertising Bureau (IAB) introduced the ads.txt (Authorized Digital Sellers) initiative and sellers.json In this article, we will delve into the world of sellers.json and ads.txt, focusing specifically on its correct syntax and format

What is Sellers.json ?

Sellers.json is a file that provides transparency and accountability in the digital advertising ecosystem. It is an initiative from IAB to improve the visibility of entities involved in selling digital advertising inventory.The sellers.json file serves as a public record that discloses information about the entities (sellers) participating in the advertising supply chain. It includes details such as seller IDs, domains, and the type of relationship they have with the inventory being sold.

By examining the sellers.json file, buyers and other stakeholders can gain insights into the entities selling the ad space, their legitimacy, and their role in the supply chain. It helps to address issues like domain spoofing, unauthorized reselling, and other fraudulent activities by providing greater transparency and enabling buyers to make informed decisions.

Google, as a major player in the digital advertising ecosystem, maintains its own sellers.json file. It includes information about the sellers associated with Google Ad Manager, AdExchange, AdMob, and other Google advertising products. The Google sellers.json file plays a crucial role in ensuring transparency and accountability for publishers, advertisers, and ad tech providers.

By accessing the sellers.json file, stakeholders can verify the legitimacy of sellers, understand the relationships between sellers and publishers, and identify any intermediaries involved in the ad transactions.

Regularly checking the sellers.json file helps maintain a secure and trusted advertising ecosystem by providing transparency and combating fraudulent practices. It allows buyers to verify the authenticity of sellers and build relationships with reputable partners.

Overall, sellers.json is an essential component of the industry’s efforts to create a transparent, accountable, and fraud-free digital advertising environment, benefiting advertisers, publishers, and ad tech platforms alike.

Correct Syntax of sellers.json:
Sellers.json is a JSON file that follows a specific format. It contains an array of objects, with each object representing a seller of ad inventory. The objects include fields such as “seller_id” (an encrypted identifier for the seller), “name” (the name of the seller), and “domain” (the domain associated with the seller).

Example of sellers.json Format:

{
"contact_email": "[email protected]",
"contact_address": "2 Pal Yam St. Haifa, Israel",
"version": "1.0",
"sellers": [
{
"seller_id": 21670403798,
"name": "RelictMedia Ltd",
"domain": "relict.media",
"seller_type": "BOTH"
}

What does PUBLISHER, INTERMEDIARY, or BOTH mean?
The seller type in Google's sellers.json file is determined based on the payment arrangement with the seller, following guidelines from the Interactive Advertising Bureau (IAB).

PUBLISHER: Sellers listed as PUBLISHER receive direct payment for the inventory they offer.

INTERMEDIARY: Sellers listed as INTERMEDIARY are paid indirectly for the inventory and do not own the website or app that contains the inventory.

BOTH: If a seller is paid directly for inventory but also monetizes a child account, they are listed as BOTH in the sellers.json file.

Example: Understanding PUBLISHER and INTERMEDIARY seller types
Let's consider Seller A and Seller B as an example:
Seller A: They have their own inventory on example.com and receive direct payment for it. Hence, Seller A is listed as PUBLISHER.

Seller B: Seller B monetizes Seller A's inventory on not-example.com through Multiple Customer Management (MCM) or Scaled Partner Management (SPM). Therefore, Seller B is listed as INTERMEDIARY.

If you come across a seller listed as PUBLISHER when they should be listed as INTERMEDIARY

Who should add the seller.json file?

All individual publisher and publisher networks should add the sellers.json file on the root domain.

Where I should add the root domain for sellers.json?

Fix issues with ads.txt and sellers.json files

In Google Ad manager, You can check the status of Sellers.json for all of the publisher, To get the sellers.json status file, Go to Ads.txt Section present in Admin

Various Status in sellers.json file from Google ad manager

Parent inventory authorization status

  • SELLER_UNAUTHORIZED - You aren’t authorized, likely because you’re missing from the app-ads.txt or ads.txt file.
    Add yourself to the app-ads.txt or ads.txt file.
  • SELLER_AUTHORIZED_WITH_WARNING - You’re authorized, but not as a reseller. Double check your publisher type in
    app-ads.txt/ads.txt as a DIRECT seller.
  • SELLER_AUTHORIZED - You’re authorized. No issue.

Child Inventory Authorization Status

  • CHILD_SELLER_ID_NOT_PROVIDED - You haven’t provided a seller ID for this child publisher. Note: This value only
    shows if the app-ads.txt/ads.txt file was crawled successfully. For example, if the child seller ID is not provided
    and there is an app-ads.txt/ads.txt crawling issue, this field will reflect “file not found” instead. Add a seller
    ID for your child publisher.
  • UNAUTHORIZED - The child publisher isn’t authorized. They’re missing from the app-ads.txt/ads.txt file. Add the
    child to the app-ads.txt/ads.txt file.
  • AUTHORIZED - The child publisher is authorized as a direct seller. No issue.
  • AUTHORIZED_WITH_WARNING - The child publisher is authorized, but not as a direct seller. Double check the child's
    publisher type in app-ads.txt/ads.txt.

Detailed information can be found on official documentation present on google ad manager

What is ads.txt? Correct Syntax of ads.txt:

Ads.txt is a text file placed on a publisher's website that lists the authorized sellers of their ad inventory

Correct Syntax of ads.txt:
Ads.txt follows a specific syntax to ensure proper implementation. The syntax consists of several fields, each separated by a comma. Let's break down the correct syntax for ads.txt:

Domain name:
The domain name refers to the website for which the ads.txt file is created. It should be specified as the first field in ads.txt. For example:
example.com

Publisher Account ID:
The publisher's account ID, provided by the advertising platform or exchange, is specified in the second field. It uniquely identifies the publisher within the ecosystem. For example:
pub-1234567890123456

Account Type:
The account type specifies the relationship between the publisher and the advertising system. It can be either "DIRECT" or "RESELLER." Use "DIRECT" when the publisher directly controls and sells their inventory, and "RESELLER" when the inventory is sold through authorized resellers. For example:
DIRECT

Certification Authority ID:
The certification authority ID is an optional field that allows publishers to specify their certification status with certain organizations, such as the Trustworthy Accountability Group (TAG). It helps ensure trust and transparency. For example:
tag.certified.com

Note: The above fields (domain name, publisher account ID, account type, and certification authority ID) should be combined with commas to form a complete line in ads.txt.

Example of ads.txt Format:
Let's look at an example of how the correct syntax is applied to ads.txt:

example.com, pub-1234567890123456, DIRECT, tag.certified.com

References

  • https://support.google.com/adsense/answer/10368261?hl=en&ref_topic=7533328&sjid=16204361800679831275-AP
  • https://iabtechlab.com/sellers-json/
  • https://support.google.com/admanager/answer/12207502?hl=en
  • Tags:

    ©2024 AdTagMacros - Everything About Advertising

    We improve our products and advertising by using Microsoft Clarity to see how you use our website. By using our site, you agree that we and Microsoft can collect and use this data. Our privacy statement has more details.

    Log in with your credentials

    Forgot your details?