程式輔助保證交易

在程式輔助保證交易中,您可以與賣方以固定價格購買的曝光次數進行協議。如果您接受程式輔助保證交易的提案,即表示您承諾根據協商的條款購買賣方的廣告空間。如要進一步瞭解您的承諾使用合約和用來監控法規遵循情況的工具,請參閱有關程式輔助保證服務水準協議架構的說明中心文章。

建立

當協商開始傳送提案請求 (RFP) 時,系統就會建立程式輔助保證交易。如要展開協商,請透過 buyers.proposals.sendRfp 傳送提案請求給賣方。提案請求必須包含 programmaticGuaranteedTerms,系統產生的提案才能用於程式輔助保證交易。賣方也可以傳送 RFP 給您,這些提案請求會在 Marketplace API 中顯示為提案。建立完成後,您就能找到 buyers.proposals.list 交易的提案,以及您與賣方之間的協議。

交涉

程式輔助保證交易的提案建立後,您可以調整提案和相關交易,與賣方進行協商,直到雙方都獲得協議或提案已取消為止。在成功協商後,您可以執行下列任一動作:

  • 變更提案交易的輪詢:每當提案或相應交易發生變更時,proposalRevision 就會遞增。您可以使用這個程式碼來偵測賣家何時接受您的提案,或回應提案中的提案。
  • 修補提案交易:修改您的提案,或傳送議價給賣方。這會增加 proposalRevision
  • 與賣方通訊:提案包含可供買方和賣方查看的附註。舉例來說,您可以新增附註,提供對提案或交易所做的變更的相關資訊。

完成確認並準備放送

如果您對提案感到滿意,且提案的 stateBUYER_ACCEPTANCE_REQUESTED,可以接受提案。這個動作會完成交易,交易是從 flightStartTime 開始放送。

為了確保交易只有在備妥廣告素材時才會開始放送,建議您與客戶技術顧問聯絡,要求將您的程式輔助保證交易排除這個預設行為,改為在廣告素材可供放送時改用手動信號。以下工作流程範例可用來在程式輔助保證交易可供放送時手動發出信號:

  • 與賣方協商提案
  • 使用即時出價 API 將廣告素材送審:您打算放送的廣告素材必須經過審查並獲得核准,才能用於交易。
  • 接受提案:對方接受提案後,系統就會在敲定的交易中反映已接受的交易。
  • 使用即時出價 API 擷取先前提交的廣告素材,並確認這些廣告素材已獲準用於即時出價的交易出價:請查看 dealsPolicyCompliance,確認廣告素材已獲核准,並可刊登於收到的交易出價要求。
    • 如果廣告素材未獲核准,請查看主題來找出拒登原因。視需要調整廣告素材,然後修補廣告素材,再次啟動審核,直到所有問題解決為止。
  • 新增 用於敲定交易的所有廣告素材:建議您在要放送交易之前, 在要使用這些交易的交易中新增廣告素材。
  • 手動信號交易可以放送:交易準備就緒後,您會在設定的 flightStartTime 收到交易的出價要求,而交易的出價要求將持續至達到 flightEndTimeimpressionCap 為止。

重新協商

交易敲定後,您或賣方可以修改提案或其交易,以開始重新協商。在重新協商期間,finalizedDeals 資源會反映先前的協議,並盡可能依據該協議繼續放送。deals 資源會反映重新協商的目前狀態,運作方式與初始協商類似。

如果您和賣方都接受重新協商的交易,就會覆寫原本的最終交易,並根據新協議放送。否則,如果取消交易,交易會在重新協商開始前還原為狀態。

對程式輔助保證交易的曝光出價

程式輔助保證交易開始放送後,您的即時出價整合功能會收到該筆交易的出價要求,並且必須依據交易條款進行出價,例如以特定價格在一段時間內獲得一定的曝光次數。

一個特定的出價要求可能包含多項程式輔助保證交易。如果發生這種情況,您應該為請求中提交的每個交易 ID 做出回應。與程式輔助保證交易直接相關的欄位包括:

Google 通訊協定 OpenRTB 通訊協定 說明
BidRequest.adslot.matching_ad_data.direct_deal.direct_deal_id BidRequest.imp.pmp.deals.id 交易的專屬 ID。這相當於 Marketplace API 傳回的交易資源 ID。
BidRequest.adslot.matching_ad_data.direct_deal.deal_type BidRequest.imp.pmp.deals.ext.deal_type 競價類型,會設為 PROGRAMMATIC_GUARANTEED;如果是 OpenRTB JSON,則會設為「3」。
BidRequest.adslot.matching_ad_data.direct_deal.fixed_cpm_micros BidRequest.imp.pmp.deals.bidfloor 這相當於買方和賣方同意的交易千次曝光出價,在 Marketplace API 中會顯示為 fixedPrice。如果是程式輔助保證交易,這會覆寫出價回應中指定的任何值。
BidRequest.adslot.matching_ad_data.direct_deal.publisher_blocks_overridden BidRequest.imp.pmp.deals.ext.publisher_blocks_overridden 程式輔助保證交易一律為 true,表示允許使用排除類別。
BidRequest.adslot.matching_ad_data.direct_deal.must_bid BidRequest.imp.pmp.deals.ext.must_bid 指出買方是否需要對交易出價。舉例來說,如果交易超前進度,系統就會將此設為 False,可選擇是否出價。否則需要出價。也就是說,未出價可能會對交易放送和廣告空間供應情況造成負面影響。

暫停並恢復放送

如果您暫時無法針對最終的程式輔助保證交易出價,應使用 buyers.finalizedDeals.pause 方法暫停交易。舉例來說,如果廣告素材原本已通過核准,但現在獲得核准,因此需要重新提交,您就可以這麼做。請注意,雖然這樣做會讓您停止接收交易的出價要求,但您還是必須達到已依據協議條款規定的任何義務。

如要繼續放送敲定的交易,請使用 buyers.finalizedDeals.resume