透過 SupplyChain 物件獲得出價透明度

透過 SupplyChain 物件，買方和中介商可以查看所有參與銷售或經銷廣告空間的關係方。這個物件會與 ads.txt/app-ads.txt 和 sellers.json 協同運作，清楚交代整個廣告生態系統中的資訊。

1. 發布商傳送出價要求。
2. 買方收到出價要求和來自 SupplyChain 物件的資料。
3. 買方查詢經銷廣告空間的所有中介商的 ID。
4. 買方檢索及驗證有權銷售廣告空間的廠商。

Google 會依適用情況，在 OpenRTB 要求中自動建立相關物件。

SupplyChain 物件的運作方式

SupplyChain 物件 (又稱為 schain) 是 OpenRTB 出價要求中的一部分而且內含多個「節點」。schain 物件中的每個節點就代表參與出價要求中的一個特定實體；也就是說，與廣告空間直接付款流程相關聯的所有實體都會包含在該物件中。

提示：為了讓 Google 建立完整的 SupplyChain 物件，MCM 管理廣告空間上層發布商必須透過 Ad Manager 或使用 API 共用子發布商的賣方 ID (sid)。

 

// 物件示例
"schain": {
    "complete": 1,
    "nodes": [{
         "asi":"google.com",
         "sid":"pub-1234567891234567", // 與 sellers.json 檔案中發布商相同的 seller_id
         "hp":1
    }],
    "ver":"1.0"
}

如需詳細資訊，請參閱 OpenRTB 開發人員說明文件和 IAB 的相關文件。

視您與買方的合作方式而定，SupplyChain 物件的內容會有所不同。

透過 Google 直接銷售廣告的發布商

對於直接透過 Ad Manager、AdMob 或 AdSense 銷售廣告空間的發布商而言，schain 物件中只會有一個「google.com」的節點以及 sellers.json 中相對應的 seller_id。

使用公開出價的廣告發布商

對於使用公開出價與第三方廣告交易平台合作的發布商而言，在 schain 物件中會有兩個節點，其中一個節點為 google.com 以及在 sellers.json 中相對應的 seller_id，另一個則是屬於廣告交易平台收益夥伴的節點。

Google 會在傳送出價要求之前建立 google.com 的節點，而第三方廣告交易平台也同樣必須在傳遞要求之前，將自己的節點加入要求之中。

所有與付款無關的中介商

SupplyChain 物件中並不會納入不處理付款的中介商，像是用戶端標頭出價、非付款標頭出價、廣告空間共用和其他中介服務。

發布商在提出請求前使用付款中介服務 ^(測試版) 

這項功能仍處於 Beta 版
您的聯播網可能無法使用 Beta 版階段的功能。如要掌握這項功能正式發布的時間，請參閱版本資訊。

如果發布商採用付款中介服務向 Google Ad Manager 提出請求，則必須根據 IAB 指南傳遞 SupplyChain 物件。SupplyChain 物件應只包含與廣告空間付款流程直接相關的中介服務，這些中介服務可能包含發布商使用的第三方廣告伺服器技術。 您可以使用 schain 參數，在廣告請求中傳送 SupplyChain 物件。

進一步瞭解 schain 參數

說明

供應鍊 (schain) 參數接受變數值，應為序列化的 SupplyChain 物件。如有這項參數，Google 會先在收到的 schain 物件加上節點，再傳送給買方。

如果不想使用 OpenRTB，而要透過標記傳送 SupplyChain 資訊，歡迎參閱完整的 IAB 說明文件。

查看規定，確保能夠正確剖析 schain

依據 IAB 說明文件，下列項目可以定義 SupplyChain 物件的序列化設定：

• {SupplyChainObject}!{SupplyChainNode array}. SupplyChainObject 和 SupplyChainNode 屬性以半形逗號分隔，因此可以省略選填欄位，也能視情況排除半形逗號分隔符。
• 個別 SupplyChainNode 元素之間會以「!」分隔。
• 如果屬性的值含有需要進行網址編碼的字元 (例如「,」或「!」)，則應先對值進行網址編碼再加以序列化。

序列化順序

SupplyChainObject 屬性會按照下列順序進行序列化：

ver,complete

SupplyChainNode 屬性會按照下列順序進行序列化：

asi,sid,hp,rid,name,domain,ext

注意事項：ext 的內容會因廣告交易平台而異，Google Ad Manager 不會剖析這項屬性。

將 SupplyChain 物件序列化的操作示範

您可以透過下列兩種方式，將上方的 SupplyChain 物件序列化：

空白選填欄位「使用」半形逗號的序列化方式

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

空白選填欄位「不使用」半形逗號的序列化方式

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

進一步瞭解 SupplyChain 物件。

使用範例

schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

如果 asi 的值為 exchange,1，含有逸出字元的序列化情況會如下所示：

1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

要求和建議

雖然針對任意實作或交易類型放送廣告時，您不一定要提供這項參數，不過如果發布商會透過付款中介服務向 Google Ad Manager 發出請求，就必須使用這項參數，包括使用第三方廣告伺服器技術的發布商。

 

注意：發布商的 ads.txt/app-ads.txt 檔案中應顯示所有附加至 SupplyChain 物件的額外節點，否則買方可能會將流量視為未經授權。

使用多重客戶管理的廣告發布商

多重客戶管理 (MCM) 可讓上層發布商以兩種方式透過子發布商的廣告空間營利：一是以「管理帳戶」委任類型的方式傳送個別的要求，另一個是用「管理廣告空間」委任類型的方式傳送大量的要求。

管理帳戶合作夥伴

對使用管理帳戶的上層和子發布商而言，schain 物件中會有一個內含子發布商賣方 ID 的節點，且系統會將供應鏈標示為完成。對「管理帳戶」發布商而言，營利的情況其實是出現在子發布商的帳戶中。因此，系統會將子發布商視為終端發布商，而上層發布商的資訊就不會包含於 schain 物件之中。

管理廣告空間合作夥伴

MCM 管理廣告空間發布商現在已將 SupplyChain 物件標示為「完成」。MCM 子發布商有 1 個節點，MCM 上層聯播網有 1 個節點，節點則會標示為完成。

進行這項更新時，MCM 管理廣告空間上層發布商必須透過 Ad Manager 前端或 API，共用子發布商的賣方 ID (SID)。

已完成的 SupplyChain 物件範例

這個例子會顯示以 Google 做為廣告交易平台，且將 MCM 子發布商與上層發布商的 SupplyChain 物件標示為「完成」的案例。

"schain" : {
    "ver": "1.0",
    "complete" : 1,
    "nodes" : [

// MCM 子發布商的節點
        {
            "asi":"mcm-parent-example.com",  // 這是範例，請務必輸入上層發布商的實際網域。 
            "sid":"52e41fac28963d1e058a106f", // 在上層發布商 seller.json 檔案中的子發布商賣方 ID
            "hp":1,
        },

// MCM MI 上層發布商的節點
        {
            "asi":"google.com",
            "sid":"pub-1234567891234567", // 在 Google seller.json 檔案中的 MCM 上層發布商的發布商 ID
            "hp":1,
        }
    ]
}

常見問題

為什麼 MCM 的上層發布商需要建立 sellers.json 檔案？

這是為了要在 sellers.json 檔案中公開提供合作夥伴的相關資訊，用於協助買方確認其廣告空間的一個重要步驟。

進一步瞭解 IAB sellers.json 檔案的規格。

所有的子發布商都必須具備有效的 ads.txt 檔案嗎？

是的。在邀請 MCM 子發布商的流程中，子發布商可以設定 ads.txt 檔案，用以驗證其所擁有和經營網站的網站擁有權。

如果子發布商並未在 ads.txt 中加入將 MCM 上層發布商列為 DIRECT 的敘述行 (例如 MCM-parent-example.com, MCM 子發布商的 Seller ID, DIRECT)，但卻將上層發布商的發布商 ID 列成 Google 的敘述行 (例如 google.com, MCM 上層發布商的發布商 ID, RESELLER, f08c47fec0942fa0)，則是否會對收益造成負面影響？供應鏈會標示為完成嗎？

系統會將供應鏈標示為完成，但由於 SupplyChain 中有一個節點不屬於 ads.txt 所列舉的授權賣方網站，買方可能會將該流量視為「未獲授權」。請更新 ads.txt 檔案，將 MCM 上層發布商納入並設為 DIRECT (例如 MCM-parent-example.com, MCM 子發布商的 Seller-ID, DIRECT)，此為避免這類錯誤的必要步驟。