该对象以节点数组的形式与 SupplyChain 对象关联。这些节点定义参与竞价请求供应链的实体的身份。详细实现示例参见:https://github.com/InteractiveAdvertisingBureau/openrtb/blob/master/supplychainobject.md。译稿校对中ENThis object is associated with a SupplyChain object as an array of nodes. These nodes define the identity of an entity participating in the supply chain of a bid request. Detailed implementation examples can be found here: https://github.com/InteractiveAdvertisingBureau/openrtb/blob/master/supplychainobject.md. The SupplyChainNode object contains the following attributes:
| Attribute | Type | Description |
|---|---|---|
| asi required | string | 竞价方所连接的 SSP、交易平台、Header Wrapper 等系统的规范域名(canonical domain)。若系统的运营域名与母公司域名不同,可使用运营域名,以便通过 WHOIS 与反向 IP 查询确认委托系统的所有权。若存在 ads.txt 文件,本取值应与其中标识卖方所用的值一致。译稿校对中ENThe 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 required | string | 广告系统内与卖方或转售方账户关联的标识符。必须与交易(即 OpenRTB 竞价请求)中 SSP/交易平台指定字段所用的值一致;通常在 OpenRTB 中即 publisher.id,在 OpenDirect 中通常为发布方组织 ID。长度应限制在 64 个字符以内。译稿校对中ENThe 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 | 本卖方签发的请求的 OpenRTB 请求 ID(RequestId)。译稿校对中ENThe OpenRTB RequestId of the request as issued by this seller. |
| name | string | 在给定 seller_ID 下因库存交易而获得结算的公司(法律实体)名称。本取值可选;若已存在于广告系统的 sellers.json 文件中,则不应包含。译稿校对中ENThe 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 | 本节点所代表实体的商业域名。本取值可选;若已存在于广告系统的 sellers.json 文件中,则不应包含。译稿校对中ENThe 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 | 指示本节点是否参与库存的支付流。设为 1 时,asi 字段中的广告系统向 sid 字段中的卖方付款,该卖方负责向链路中的前一节点付款;设为 0 时,本节点不参与库存的支付流。对 SupplyChain 1.0 版,本属性应始终为 1。实现方在构造发送给下游广告系统的竞价请求中的 SupplyChain 对象时,应确保继续透传本字段。译稿校对中ENIndicates 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. Implementers should ensure that they propagate this field onwards when constructing SupplyChain objects in bid requests sent to a downstream advertising system. |
| ext | object | 供广告系统对本对象进行专属扩展(advertising-system specific extensions)的占位对象。译稿校对中ENPlaceholder for advertising-system specific extensions to this object. |
译注
译者注asi/sid 与 ads.txt 的对齐:asi 应与 ads.txt 中标识卖方所用的域名一致,sid 应与对应记录中的卖方 ID 一致;二者是买方核验供应链合法性的主键,不一致即视为未授权供给。译稿校对中
name/domain 与 sellers.json 的去重规则:若广告系统已发布 sellers.json,节点中不应再重复 name/domain,以避免信息源冲突;sellers.json 是更权威的信息源。译稿校对中
hp 的支付流含义:hp = 0 的节点(如纯技术中介)不经手资金;在 1.0 版规范中 hp 应始终为 1。透传链路时不得丢失或改写 hp 取值。译稿校对中
字段描述收录自 IAB Tech Lab OpenRTB 2.6 官方规范(CC-BY 3.0)· 枚举值来源 AdCOM 1.0 · 初稿校对中