建立預先擷取排程 - AWS Elemental MediaTailor
決定您的用戶端應該多久呼叫 CreatePrefetchSchedule API

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

建立預先擷取排程

下列程序說明如何使用 MediaTailor主控台建立預先擷取排程。如需有關以程式設計方式建立和管理預先擷取排程的資訊 MediaTailor API，請參閱PrefetchSchedules中的 AWS Elemental MediaTailor API參考。

注意

如果您想要在排程中使用可用性比對條件，請務必先使用動態變數設定播放設定的ADSURL範本，否則可用性符合條件將不會產生作用。如需使用動態變數的詳細資訊，請參閱 MediaTailor廣告插入入門主題步驟 3：設定ADS要求URL和查詢參數中的。

使用主控台建立新的預先擷取排程

  1. 在開啟 MediaTailor 主控台https://console.aws.amazon.com/mediatailor/。

  2. 在導覽窗格中，選擇 [組態]。選取您要建立預先擷取排程的播放組態。

  3. 在「預取排程」標籤上，選擇「新增預取排程」。

  4. 在「預先擷取排程詳細資料」窗格下，執行下列動作：

    • 在名稱中，輸入預先擷取排程的識別碼，例如my-prefetch-schedule。

    • 針對「串流 ID」，選擇性地輸入唯一 ID。如果您的來源包含多個播放串流，您可以使用此 ID 指示 MediaTailor 在特定串流中放置廣告。舉例來說，如果您的來源有體育串流和電視節目串流，您可以使用串流 ID 建立預先擷取時間表，以插入針對該體育直播的廣告。您可以 MediaTailor 在用戶端的工作階段初始化或資訊清單要求中將串流 ID 值傳遞給。如需詳細資訊，請參閱下列範例。

      • 對於服務器端跟踪，請在客戶端對 MediaTailor 端點的GET HTTP請求中包含?aws.streamId查詢參數和值。如需伺服器端追蹤的一般資訊，請參閱 伺服器端廣告追 包含串流 ID 的HLS端點的資訊清單要求如下所示，其中myStreamId是串流 ID 的名稱：

        GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.streamId=myStreamId

      • 對於用戶端追蹤，請在用戶端的POST HTTP工作階段初始化要求主體中包含streamId金鑰和值到 MediaTailor/v1/ session 端點。如需用戶端追蹤的一般資訊，請參閱用戶端廣告追蹤。包含串流 ID 的工作階段初始化要求如下所示，其中myStreamId是串流 ID 的名稱：

        POST <mediatailorURL>/v1/session/<hashed-account-id>/<origin-id>/<asset-id>
{
    'streamId': 'myStreamId'
}
      顯示較多顯示較少

  5. 在 [擷取] 窗格上，指定您要使用的擷取設定。這些設定會決定何時從中 MediaTailor 預先擷取廣告。ADS它們也會決定要在要求中包含哪些動態變數 (如果有的話)。ADS

    • 在 [開始時間] 中，輸入此廣告插播 MediaTailor 可開始預先擷取擷取的時間。 MediaTailor 將嘗試為您的客戶在此時間或之後提出的清單請求預取廣告。預設值是目前時間。如果您未指定值，服務會盡快開始預先擷取擷取。

    • 在 [結束時間] 中，輸入您要停止 MediaTailor 為此廣告插播預先擷取廣告的時間。 MediaTailor 將嘗試針對在此時間或之前發生的資訊清單要求預先擷取廣告。擷取視窗可與沖銷視窗重疊。

    • 在「動態變數」區段中，輸入最多 100 個動態變數。 MediaTailor 在傳送至的預先擷取要求中使用這些變數來取ADS代。如果您未輸入任何動態變數， MediaTailor請盡最大努力嘗試插入. ADSURL

      • 選取「新增動態變數」。

      • 在 Key 中，輸入動態變數金鑰，例如scte.event_id。您可以使用任何 MediaTailor 支援的動態變數。如需動態變數的相關資訊，請參閱使用動態廣告變數 MediaTailor。

      • 在「值」中，輸入動態變數值，例如 my-event.

      • 若要新增其他動態變數，請選擇「選取新增動態變數」。

  6. 在「耗用」窗格中，指定要用於沖銷視窗的設定。這些設定會決定廣告 MediaTailor 放入廣告插播的時間。他們還確定了您要使用的任何可用匹配條件。

    • 在 [開始時間] 中，輸入您想 MediaTailor 要在廣告插播中放置預先擷取的廣告的時間。預設值為目前時間。如果您未指定時間，服務會儘快開始預先擷取消耗。

    • 在 [結束時間] 中，輸入停止將預先擷取的廣告放入廣告插播的時間。 MediaTailor MediaTailor 將嘗試為在此時間或之前發生的客戶清單請求預先獲取廣告。結束時間必須在開始時間之後，並且從現在起不到一天。沖銷視窗可與擷取視窗重疊。

    • 在「可用性匹配條件」部分中，選擇「添加可用條件」，然後在計劃中添加最多五個廣告可用匹配條件。然後，在動態變量鍵下，添加一個動態變量鍵，例如scte.event_id。 MediaTailor 只有當預先擷取的廣告符合客戶傳送至的動態變數值所定義的條件 MediaTailor，或是從工作階段資料等資訊 MediaTailor 推斷的情況下，才會將預先擷取的廣告放入廣告插播中。如需相關資訊，請參閱前一節avail-matching-criteria。

  7. 選取 [新增可用條件]。

預取排程會在沖銷時段結束時間後自動過期。出於診斷目的，它們至少保持可見 7 天，之後 MediaTailor 會自動刪除它們。或者，您可以隨時手動刪除預先擷取排程。如需如何手動刪除預先擷取排程的詳細資訊，請參閱下刪除預取排程節。

決定您的用戶端應該多久呼叫 CreatePrefetchSchedule API

如果您知道廣告插播的確切時間，您的客戶可以通過編程方式調用每天CreatePrefetchScheduleAPI一次來設置檢索和消費。或者，您的客戶可以在一天中API多次調用以定義檢索和消耗。選擇API通話頻率時，請考慮 MediaTailor使用中預先擷取排程的最大數目，以及建立預先擷取排程後，廣告插播時間表是否會變更的可能性。如果您建立預先擷取排程後，廣告插播時間表可能會有所變更，您可能會想要API更頻繁地撥打電話給廣告插播時間表。