SupplyChain (schain) object

Overview

As part of a broader effort to eliminate the ability to profit from invalid traffic, ad fraud, and counterfeit inventory in the open digital advertising ecosystem, the SupplyChain object enables buyers to see all parties who are selling or reselling a given bid request. The SupplyChain object is composed primarily of a set of nodes where each node represents a specific entity that participates in the transacting of inventory. The entire chain of nodes from beginning to end represents all entities who are involved in the direct flow of payment for inventory.

By using the RTB extension object on your ADR, Kevel can enable you to pass your schain object to demand partners. Given this tool's wide adoption, it is highly recommended that all publishers using RTB adopt the SupplyChain object.

Before setting up your SupplyChain object, please ensure that you have enabled Ads.txt or Sellers.json (if you are representing 3P inventory).

OpenRTB object: Supply Chain

Attribute	Type	Description
complete	integer; required	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, where 0 = no, 1 = yes.
nodes	object array; required	Array of SupplyChainNode objects in the order of the chain. In a complete supply chain, the first node represents the initial advertising system and seller ID involved in the transaction, i.e. the owner of the site, app, or other medium. In an incomplete supply chain, it represents the first known node. The last node represents the entity sending this bid request.
ver	string; required	Version of the supply chain specification in use, in the format of “major.minor”. For example, for version 1.0 of the spec, use the string “1.0”.
ext	object; optional	Placeholder for advertising-system specific extensions to this object.

OpenRTB object: SupplyChainNode

Attribute	Type	Description
asi	String; required	The canonical domain name of the SSP, Exchange, Header Wrapper, etc system that bidders connect to. This may be the operational domain of the system, if that is different than the parent corporate domain, to facilitate WHOIS and reverse IP lookups to establish clear ownership of the delegate system. This should be the same value as used to identify sellers in an ads.txt file if one exists.
sid	string; required	The identifier associated with the seller or reseller account within the advertising system. This must contain the same value used in transactions (i.e. OpenRTB bid requests) in the field specified by the SSP/exchange. Typically, in OpenRTB, this is publisher.id. For OpenDirect it is typically the publisher’s organization ID.Should be limited to 64 characters in length.
rid	string; optional	The OpenRTB RequestId of the request as issued by this seller.
name	string; optional	The name of the company (the legal entity) that is paid for inventory transacted under the given seller_id. This value is optional and should NOT be included if it exists in the advertising system’s sellers.json file.
domain	string; optional	The business domain name of the entity represented by this node. This value is optional and should NOT be included if it exists in the advertising system’s sellers.json file.
hp	integer; required	Indicates whether this node will be involved in the flow of payment for the inventory. When set to 1, the advertising system in the asi field pays the seller in the sid field, who is responsible for paying the previous node in the chain. When set to 0, this node is not involved in the flow of payment for the inventory. For version 1.0 of SupplyChain, this property should always be 1. It is explicitly required to be included as it is expected that future versions of the specification will introduce non-payment handling nodes. Implementers should ensure that they support this field and propagate it onwards when constructing SupplyChain objects in bid requests sent to a downstream advertising system.
ext	object; optional	Placeholder for advertising-system specific extensions to this object.

Example ADR with SupplyChain object

{  
  "url": "<https://fotbolldirekt.se/">,  
  "placements": \[  
    {  
      "divName": "div1",  
      "adTypes": [  
        5  
      ],  
      "networkId": YOURNETWORKID,  
      "count": 1,  
      "siteId": "YOURSITEID"  
    }  
  ],  
  "rtb":{  
    "schain": {  
      "complete": 1,  
      "nodes": [{  
        "asi": "yourdomain.com",  
        "sid": "YOURSELLERID",  
        "hp": 1  
      }],  
      "ver": "1.0"  
    }  
  }  
}