Use * syntax for faster search

Page History

Versions Compared

Key

This line was added.
This line was removed.
Formatting was changed.

Section

Column

width	50%

Panel

borderColor	#c8c8c8
borderWidth	1
borderStyle	solid

Table of Contents

maxLevel	2
indent	20px
style	none

Column

width	50%

Overview

Sellers.json and SupplyChain Object (schain) are industry specifications, developed by the IAB Tech Lab, to increase supply chain transparency on inventory.

Sellers.json

SSPs and exchanges host sellers.json files, which list all direct sellers and intermediaries that are authorized to sell inventory on their platform. Sellers.json files are used to verify the identity and legitimacy of a seller or reseller, as well as provide additional information to the advertiser, including:

Seller ID - this should match the Publisher ID listed on the publisher’s ads.txt or app-ads.txt file
Seller Name
Website Domain
Seller Type - Publisher, Intermediary, or Both

SupplyChain Object (schain)

The OpenRTB SupplyChain object, also known as schain, shows every entity involved in selling and reselling a bid request. Schain assigns a node to every entity that a payment travels through for a single impression. Advertisers can then view the entire transaction path for each bid request from the original media owner to the final buyer and verify each entity in the chain.

Reporting with sellers.json

Sellers.json dimensions are available in these reporting tools:

App, Domain, and Inventory Reports
Metamarkets
Auction, bid, win, ghost, antenna, and streaming joined win logs

The available sellers.json reporting fields are as follows:

Dimension

Logs Field Name

Definition

Sellers.json Seller Status

SELLERS_JSON_STATUS

Whether a match was found when looking up the Publisher ID in sellers.json files. Values include:

Unknown: No Publisher ID was passed in the bid request to lookup against sellers.
Seller Not Found: No match was found to the Publisher ID passed in the bid request
Authorized: This seller is authorized based on the sellers.json table, but the seller type cannot be identified for various reasons.
Authorized - Publisher: A match was found to the Publisher ID and the Seller Type is "Publisher"
Authorized - Intermediary: A match was found to the Publisher ID and the Seller Type is "Intermediary"
Authorized - Both: A match was found to the Publisher ID and the Seller Type is "Both"

Sellers.json Seller Name

SELLERS_JSON_SELLER_NAME

Seller Name listed on the sellers.json file

Mapped Seller Name

SELLERS_JSON_MAPPED_NAME

The Seller Name listed in the in the sellers.json file mapped to a taxonomy to consolidate into a single standardized name

Info
The taxonomy does not account for all sellers names. The most commonly passed seller names have been prioritized. It's recommended to use both the Seller Name and Mapped Seller Name dimensions.

Sellers.json Seller Type

SELLERS_JSON_SELLER_TYPE

The value pulled from the sellers.json file. Options include:

Publisher: The inventory sold through this account is owned by the named entity and the advertising system pays them directly.
Intermediary: The inventory sold through this account is not owned by the named entity, or the advertising systems does not pay them directly.
Both: Both publisher and intermediary inventory are transacted by this account.

SupplyChain Object (schain) Fields in Win Logs

Schain fields are available in the following logs:

Auction logs
Bid logs
Win logs
Ghost logs
Antenna logs
Streaming joined win logs

Below is a list of the available fields and their definitions. The IAB's specs on the SupplyChain Object can also be found in the OpenRTB GitHub.

Logs Field Name	Definition
SCHAIN_COMPLETE	Flag indicating whether the chain contains all nodes involved in the transaction leading back to the owner of the site, app or other medium of the inventory.
SCHAIN_NODE_ASI	The canonical domain name of the SSP, Exchange, Header Wrapper, etc. system that bidders connect to. This should be the same value as used to identify sellers in an ads.txt file if one exists.
SCHAIN_NODE_DOMAIN	Business domain name of the entity represented by this node. This value is optional and is not included if it exists in the advertising system’s sellers.json file.
SCHAIN_NODE_HP	Indicates whether this node will be involved in the flow of payment for the inventory.
SCHAIN_NODE_INTERNAL_SID	Identifier associated with the seller or reseller account within the advertising system. The SID is augmented to include the exchange handle to match the seller_id field in logs.
SCHAIN_NODE_NAME	Name of the company (the legal entity) that is paid for inventory transacted under the given seller_id.
SCHAIN_NODE_RID	OpenRTB RequestId of the request as issued by this seller.
SCHAIN_NODE_SID	Identifier associated with the seller or reseller account within the advertising system.

Equivalent to the seller_id field without the exchange's prefix

For example, 1234.
SCHAIN_NODE_INTERNAL_SID	The SCHAIN_NODE_SID field augmented to include the exchange handle. For example, stv/1234.
SCHAIN_VERSION	Version of the supply chain specification in use.

Content

Space Tools