Marketplace API

總覽

Authorized Buyers Marketplace API 是一組資源，可讓買方透過程式輔助方式管理下列項目：

  • 與發布商協商
  • 競價套裝方案
  • Authorized Buyers 市集 UI 用戶端存取權

本指南將介紹 Marketplace API，並說明 Authorized Buyers UI 中 Marketplace API 資源與 Marketplace 功能的對應方式。

出價方和買方

Marketplace API 與即時出價 API 的結構一致。這兩個 API 都使用 bidders 和 buyers 做為出價工具和買方作業的根層級資源。您可以在即時出價和 Marketplace API 的資源路徑中，使用相同的出價方和買方名稱。

客戶和客戶使用者

您可以使用 Marketplace API 建立及管理用戶端和客戶使用者，以及在 Authorized Buyers 使用者介面中，透過程式輔助方式授予代理商或廣告主「市集」分頁的存取權。

Client 代表與 Authorized Buyers 帳戶相關聯的客戶、代理商或廣告主。

ClientUser 代表在 Client 下具有 UI 存取權的特定個人。用戶端使用者無法存取 Marketplace API。客戶使用者對於您帳戶的「Marketplace」分頁擁有有限的存取權。用戶端使用者權限取決於其父項 Client 中指定的 role。

Marketplace API 中的其他資源會透過 Clients 資源中指定的名稱參照用戶端。

如要進一步瞭解 Authorized Buyers Marketplace UI 中的客戶和客戶使用者，請參閱下列說明中心文章：

媒體企劃人員

媒體企劃人員是獨立與發布商協商交易的代理商或其他實體，可讓一或多個出價方代表其敲定交易出價。這些交易可能是私下競價或首選交易，在敲定之前，您將無法查看或互動。交易完成後，交易就會顯示在 bidders.finalizedDeals.list 回應中。

如要判斷特定敲定交易是否已由媒體企劃人員協商，請查看交易的 mediaPlanner 欄位是否已填入資料。媒體企劃人員可設定符合交易進行交易的需求端平台專屬帳戶 ID 清單，您可以透過 eligibleSeatIds 欄位查看清單。在即時出價出價要求中，這些席位 ID 可能會顯示在發布商設定的許可清單或封鎖清單中，進而判斷是否將出價從競價中篩除。這些元素可出現在下列 BidRequest 欄位中：

  • OpenRTB 通訊協定
    • BidRequest.wseat
    • BidRequest.bseat
    • BidRequest.imp.pmp.deals.wseat
  • Google RTB 通訊協定
    • BidRequest.adslot.allowed_seat_ids
    • BidRequest.adslot.blocked_seat_ids
    • BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids

競價套裝方案

您可以使用 Marketplace API 訂閱及取消訂閱競價套裝方案中的買方和用戶端，並查看您訂閱的競價套裝方案。

AuctionPackage 和市集廣告空間指定目標組合類似。例如，競價套裝方案可能會指定與買家商業興趣相關的一組網址和行動應用程式 ID。

您無法使用 Marketplace API 建立新的競價套裝方案。您可以使用 Authorized Buyers 的市集 UI 建立競價套裝方案。Marketplace API 不會包含與競價套裝方案相關的特定指定目標資訊。

您可以與其他買方和客戶共用競價套裝方案，也能讓 Google 或其他買方與您分享競價套裝方案。

詳情請參閱競價套裝方案。

發布商簡介

您可以使用 Marketplace API 查看可與您協商的發布商設定檔。

PublisherProfile 代表 Marketplace API 中的發布者。Marketplace API 中的其他資源是指具有 PublisherProfile 中指定名稱的發布商。

發布商簡介與 Authorized Buyers 市集使用者介面中「探索」分頁中的「發布商」相似。

詳情請參閱「如何搜尋發布商」。

提案和交易

您可以使用 Marketplace API 與發布商協商交易。以下是透過 Marketplace API 管理交易的幾種方式：

「提案」代表買方或客戶與發布商之間一或多筆交易的最新協議狀態，與 Authorized Buyers 市集 UI 的「協商」分頁類似。

「交易」代表特定提案下協商的最新交易條款，與針對特定提案標記為 CURRENT NEGOTIATION 的 Authorized Buyers Marketplace UI 交易清單都不相同。

敲定交易代表已完成協商階段且準備好放送的交易。包括已放送的交易。敲定交易與 Authorized Buyers Marketplace UI 的「交易」分頁類似。

視您進行的交易類型而定，Marketplace API 資源的行為可能會有所不同。舉例來說，買方無法發起所有交易類型的協商。如要進一步瞭解協商的 Marketplace API 實作，請參閱下列資源：

如要進一步瞭解 Authorized Buyers 市集 UI 中的協商，請參閱以下資源：