View a markdown version of this page

PRE_ADS_REQUEST - AWS Elemental MediaTailor
當它觸發時Input允許輸出命名空間典型使用案例失敗行為

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

PRE_ADS_REQUEST

當它觸發時

MediaTailor 會在將請求傳送至 ADS 之前，立即執行映射至每個廣告休息時間PRE_ADS_REQUEST一次的函數。函數會在資訊清單處理期間每次遇到廣告機會時執行。

Input

來自 PRE_SESSION_INITIALIZATION、加上 avail.*、 scte.*和 adsRequest.*(url、方法、標頭、內文） 的所有欄位。如需所有可用的欄位，請參閱 輸入欄位參考。

允許輸出命名空間

命名空間 接受的類型 如何使用輸出
player_params.* 字串、數字、布林值 覆寫此廣告休息時間的工作階段播放器參數。透過 可供 ADS 請求 URL 使用ADS 請求的 MediaTailor 動態廣告變數。
session.* 字串、數字、布林值 覆寫此廣告休息時間的工作階段變數。可透過動態變數替換提供給 ADS 請求 URL。
avail.* 字串、數字、布林值 覆寫此廣告休息時間的時段變數。可透過動態變數替換提供給 ADS 請求 URL。
scte.* 字串、數字、布林值 覆寫此廣告休息時間的 SCTE 變數。可透過動態變數替換提供給 ADS 請求 URL。
adsRequest.* String 僅覆寫此廣告休息時間的 ADS 請求。支援的欄位：url、method、headers.<name>、body。url 值會視為範本，並在函數執行ADS 請求的 MediaTailor 動態廣告變數後支援 。未保留。
注意

勾PRE_ADS_REQUEST點的所有輸出都是暫時性覆寫 – 它們僅適用於目前廣告休息時間的 ADS 請求，不會保留到工作階段。

範例 — 重寫 ADS 請求：

{
    "Output": {
        "adsRequest.url": "{%'https://ads.example.com/v1/vast?sid=' & session.id & '&genre=' & player_params.genre%}",
        "adsRequest.headers.X-Custom-Token": "{%player_params.auth_token%}"
    }
}

這會取代 ADS URL，並新增目前廣告休息時間的自訂標頭。

典型使用案例

  • 重寫 ADS 請求 URL，以在不同的廣告伺服器之間路由流量以進行 A/B 測試。

  • 將擴充資料 （對象區段、身分字符） 附加至 ADS 請求 URL 或標頭。

  • 根據 SCTE-35 訊號資料或可用索引，有條件地修改 ADS 請求參數。

失敗行為

如果連接至 的函數因任何原因PRE_ADS_REQUEST失敗，MediaTailor 會捨棄函數的輸出，並像未連接函數一樣繼續進行。ADS 請求是使用原始工作階段和請求參數傳送，無需修改。