View a markdown version of this page

使用 MediaTailor 獲利函數 - AWS Elemental MediaTailor

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

使用 MediaTailor 獲利函數

透過 MediaTailor 獲利函數 (函數),您可以自訂 如何 AWS Elemental MediaTailor 管理工作階段資料,並在廣告插入期間建置廣告請求。函數可讓您呼叫外部 APIs、使用表達式轉換資料,以及修改廣告決策伺服器 (ADS) 請求參數或玩家參數。您不需要部署或管理自訂基礎設施。

函數使用 JSONata,這是一種用於 JSON 資料的輕量查詢和轉換語言,來評估表達式。您可以撰寫 JSONata 表達式來讀取工作階段資料、轉換值和定義輸出。如需支援 JSONata 函數的完整清單,請參閱 JSONata 表達式參考

當您需要以下項目時,請使用 函數:

  • 使用檢視器資料來豐富廣告請求。在工作階段開始時呼叫身分服務,並在每個 ADS 請求中包含已解析的身分,以進行個人化廣告目標。

  • 自訂 ADS 請求參數。根據工作階段資料、SCTE-35 訊號或外部 API 回應,動態設定 ADS URL、標頭或內文。

  • 跨廣告伺服器執行 A/B 測試。根據工作階段屬性或隨機指派,在不同 ADS 端點之間分割流量。

  • 建置多步驟擴充管道。將多個函數鏈結在一起,以從一個 API 擷取資料、將其轉換,並將結果傳遞至下一個步驟。

函數如何符合 MediaTailor 工作流程

當檢視器啟動播放工作階段時,MediaTailor 會在稱為 lifecycle hook 的廣告插入流程中的特定點評估您的函數。

  1. 您可以定義函數,並透過函數映射將其連接至播放組態。

  2. MediaTailor 會在指定的生命週期掛鉤執行函數。

  3. 函數會讀取工作階段資料,選擇性地呼叫外部 API,並寫入 MediaTailor 在播放處理期間使用的結果。

提示

如果您是初次使用 函數,請從 開始快速入門指南,然後讀取 lifecycle hook。如需表達式語法和完整範例,請參閱 JSONata 表達式參考函數範例