本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
開始使用 MediaTailor 廣告插入
若要使用 AWS Elemental MediaTailor,您需要 AWS 帳戶 和權限才能存取、檢視和編輯 MediaTailor 組態。如需如何執行此作業的資訊,請參閱 設定 AWS Elemental MediaTailor。
此入門教學課程說明如何執行以下任務:
-
準備您的 HLS 或短跑內容流
-
設定廣告決策伺服器 (ADS) 範本 URL
-
建立包含播放端點的 MediaTailor 組態
-
使用您的播放器或內容傳遞網路 (CDN) 提出播放要求 MediaTailor
完成後,您就可以向直播中的個人化廣告內容傳送播放要求。 MediaTailor
主題
必要條件
開始之前,請務必先完成 設定 AWS Elemental MediaTailor 中的步驟。
步驟 1:存取 AWS Elemental MediaTailor
使用您的 IAM 登入資料,登入 MediaTailor 主控台,位於https://console.aws.amazon.com/mediatailor/home
。
步驟 2:準備直播
設定您的原始伺服器以產生與 AWS Elemental MediaTailor相容的 HLS 或 DASH 資訊清單。
準備一個 HLS 流
HLS 資訊清單必須符合以下要求:
-
資訊清單必須可在公有網際網路上供存取。
-
資訊清單必須為即時或隨需影片 (VOD)。
-
資訊清單必須有
3
或更高的EXT-X-VERSION
。 -
對於即時內容,資訊清單必須包含標記來描述廣告時段。對 VOD 內容來說,這是選用的,它可以改為使用 VMAP 時間偏移。
資訊清單檔案必須以下列其中一項標示廣告時段:
-
#EXT-X-CUE-OUT / #EXT-X-CUE-IN (較常見) 具有的持續時間如以下範例所示。
#EXT-X-CUE-OUT:60.00 #EXT-X-CUE-IN
-
#EXT-X-DATERANGE (較不常見) 具有的持續時間如以下範例所示。
#EXT-X-DATERANGE:ID="",START-DATE="",DURATION=30.000,SCTE35-OUT=0xF #EXT-X-DATERANGE:ID="",START-DATE="",DURATION=30.000,SCTE35-OUT=0xF
顯示
#EXT-X-DATERANGE
的所有欄位為必要欄位。
您在資訊清單中設定廣告標記的方式,會影響廣告是否要在串流中插入或取代串流中的其他片段。如需詳細資訊,請參閱 瞭解 MediaTailor 廣告插入行為。
-
-
HLS 主資訊清單必須遵循 HTTP 即時串流:主播放
清單標記中記錄的 HLS 規範。特別是, #EXT-X-STREAM-INF
必須包含欄位RESOLUTION
、BANDWIDTH
和CODEC
。
設定串流之後,記下主要資訊清單的內容來源 URL 字首。在本教學中稍後,您會需要它才能在 AWS Elemental MediaTailor中建立組態。
準備一個破折號流
DASH 資訊清單必須符合以下要求:
-
資訊清單必須可在公有網際網路上供存取。
-
資訊清單必須為即時或隨需影片 (VOD)。
-
資訊清單必須使用接合插入標記或時間信號標記,將事件標記為廣告時段。您可以以 Clear XML 或以 base64 編碼的二進位提供廣告標記。對於接合插入,必須啟用 out-of-network指示器。對於時間信號標記,位於分段 UPID 內的分段類型 ID 必須是由識別的提示值。 AWS Elemental MediaTailor廣告時段會在事件開始時開始,並在事件持續時間持續 (如果有指定),或是直到下一個事件開始為止。
以下範例顯示使用接合插入標記指定為廣告時段的事件。此廣告時段的持續時間為事件的持續時間。
<Period start="PT444806.040S" id="123586" duration="PT15.000S"> <EventStream timescale="90000" schemeIdUri="urn:scte:scte35:2013:xml"> <Event duration="1350000"> <scte35:SpliceInfoSection protocolVersion="0" ptsAdjustment="180832" tier="4095"> <scte35:SpliceInsert spliceEventId="4026531855" spliceEventCancelIndicator="false" outOfNetworkIndicator="true" spliceImmediateFlag="false" uniqueProgramId="1" availNum="1" availsExpected="1"> <scte35:Program><scte35:SpliceTime ptsTime="5672624400"/></scte35:Program> <scte35:BreakDuration autoReturn="true" duration="1350000"/> </scte35:SpliceInsert> </scte35:SpliceInfoSection> </Event> </EventStream> <AdaptationSet mimeType="video/mp4" ... </AdaptationSet> </Period>
-
廣告時段必須擁有與內容串流相同的
AdaptationSet
和Representation
設定。 AWS Elemental MediaTailor 會使用這些設定來轉碼廣告,以符合內容串流,以便在兩個串流之間順暢切換。
設定串流之後,記下 DASH 資訊清單的內容來源 URL 字首。您需要在本自學課程稍後的中建立規劃。 AWS Elemental MediaTailor
步驟 3:設定 ADS 請求網址和查詢參數
若要判斷 ADS 需要的查詢參數,請從 ADS 產生廣告標籤 URL。此 URL 可做為對 ADS 請求的範本,並包含下列項目:
-
靜態值
-
產生的值 AWS Elemental MediaTailor (由
session
或avail
查詢參數表示) -
播放器產生的值,從用戶端應用程式取得 (以
player_params.
查詢參數表示)
範例 來自 ADS 的廣告標籤 URL
https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=[session.id]&cust_params=[player_params.cust_params]
其中:
-
output 和 content_id 是靜態值
-
播放器會話 = [會話 .id] 是由提供的動態值。 AWS Elemental MediaTailor每個播放器工作階段的 [session.id] 值會變更,並且造成每個工作階段 VAST 請求的 URL 不同。
-
cust_params 是播放器提供的動態值
來自播放器主要資訊清單的請求,必須提供與 ADS 請求 URL 中 player_params.
查詢參數對應的索引鍵-值組。如需在對 AWS Elemental MediaTailor的請求中設定索引鍵-值組的詳細資訊,請參閱使用動態廣告變數 AWS Elemental MediaTailor。
在中建立原始伺服器/廣告對應時 MediaTailor,請輸入已設定的「範本」URL。步驟 4:建立組態
測試
您可以使用來自 ADS 的靜態 VAST 回應供測試目的。通常,VAST 回應會傳回 AWS Elemental MediaTailor 可以轉碼的 Mezzanine 品質 MP4 轉譯。如果 ADS 的回應包含多個播放轉譯,請 MediaTailor 挑選最高品質和解析度的 MP4 轉譯,並將其傳送給轉碼器。
步驟 4:建立組態
AWS Elemental MediaTailor 組態會保留原始伺服器和 ADS 的對應資訊。
建立組態 (主控台)
請在以下位置開啟 MediaTailor 主控台。
https://console.aws.amazon.com/mediatailor/ -
在 Configurations (組態) 頁面上,選擇 Create configuration (建立組態)。
-
在頁面底部的 Configuration (組態) 區段中,對於 Configuration name (組態名稱),輸入描述組態的唯一名稱。名稱為組態的主要識別符。允許的長度上限為 512 個字元。
-
對於 Video content source (影片內容來源),請輸入此串流的 HLS 主要資訊清單或 DASH 資訊清單 URL 字首,去除資產 ID。例如,如果主要資訊清單 URL 為
http://origin-server.com/a/master.m3u8
,您會輸入http://origin-server.com/a/
。或者,您可以輸入較短的字首,例如http://origin-server.com
,但接著您必須將/a/
包含在播放器內容請求的資產 ID 中。長度上限為 512 個字元。注意
如果您的內容來源使用 HTTPS,則其憑證必須來自知名的憑證授權單位。(不能是自簽憑證。) 否則, AWS Elemental MediaTailor 無法連接到內容來源,並且無法提供資訊清單以回應播放程式要求。
-
在「廣告決策伺服器」中,輸入 ADS 的 URL。這是步驟 3:設定 ADS 請求網址和查詢參數 中所述具有變數的 URL,或是您用於測試用途的靜態 VAST URL。長度上限為 25,000 個字元。
注意
如果您的 ADS 使用 HTTPS,則其憑證必須來自知名的憑證授權單位。(不能是自簽憑證。) 相同情況適用於 ADS 傳回的 Mezzanine 廣告 URL。否則, MediaTailor 無法從內容來源擷取並將廣告整合到資訊清單。
-
如果您已設定 CDN 路由規則來存取資訊清單,且您要使用用戶端報 MediaTailor 表,或者您的玩家支援嚴格 HTTP 重新導向,請選擇 [位置],請選擇 [已停用]。
如需 Location (位置) 功能的詳細資訊,請參閱 短跑位置功能。
-
(選用) 如果您的原始伺服器會產生單一期間 DASH 資訊清單,請選擇 DASH mpd manifest origin type (DASH mp 資訊清單來源類型),然後選擇 SINGLE_PERIOD。依預設,會將 DASH 資訊清單 MediaTailor 處理為多期間資訊清單。如需詳細資訊,請參閱 整合 MPEG-破折號源。
-
選擇建立組態。
AWS Elemental MediaTailor 在「組態」頁面上顯示新的組態。
步驟 5:測試配置
儲存組態之後,使用您的串流協定的適當格式 URL 來測試串流:
-
範例:HLS
playback-endpoint/v1/master/hashed-account-id/origin-id/master.m3u8
-
範例:DASH
playback-endpoint/v1/dash/hashed-account-id/origin-id/manifest.mpd
其中:
-
playback-endpoint
是建立組態時 AWS Elemental MediaTailor 產生的唯一播放端點。範例
https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com
-
hashed-account-id
是您的 AWS 帳戶 身份證。範例
AKIAIOSFODNN7EXAMPLE
-
origin-id
是您在建立組態時提供的名稱。範例
myOrigin
-
master.m3u8
或manifest.mpd
是來自測試串流的資訊清單名稱加上其副檔名。定義此項目,使得當您將它附加到在步驟 4:建立組態中設定的影片內容來源時,可讓您取得完整識別的資訊清單。
使用來自上述範例的值,完整 URL 如下。
-
範例:HLS
https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8
-
範例:DASH
https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/myOrigin/manifest.mpd
您可以使用下列其中一個方法來測試串流。
-
如前述範例所示,輸入獨立播放器中的 URL。
-
在您自己的播放器環境中測試串流。
步驟 6:將播放請求發送到 AWS Elemental MediaTailor
設定下游播放器或 CDN 來傳送播放請求到 AWS Elemental MediaTailor提供之組態的播放端點。於步驟 3:設定 ADS 請求網址和查詢參數的 ADS 請求 URL 中使用之任何播放器定義的動態變數,必須在來自播放器的資訊清單請求中定義。
範例
假設您的範本 ADS URL 如下所示。
https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=[session.id]&cust_params=[player_params.cust_params]
然後通過[player_params.cust_params]
在鍵值對前面定義播放器請求。ads.
AWS Elemental MediaTailor 將前面沒有加上的參數傳遞ads.
給原始伺服器,而不是 ADS。
播放器請求 URL 是下列 HLS 和 DASH 範例的一些變化。
https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8?ads.cust_params=viewerinfo
https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/myOrigin/manifest.mpd?ads.cust_params=viewerinfo
當 AWS Elemental MediaTailor 收到播放器請求時,它會根據請求中的信息定義播放器變量。產生的 ADS 請求 URL 是此項目的一些變化。
https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=<filled_in_session_id>&cust_params=viewerinfo
如需設定索引鍵-值組以傳遞至 ADS 的詳細資訊,請參閱使用動態廣告變數 AWS Elemental MediaTailor。
步驟 7(可選):監視 AWS Elemental MediaTailor 活動
使用 Amazon CloudWatch 和 Amazon CloudWatch 日誌追蹤 AWS Elemental MediaTailor 活動,例如請求計數、錯誤和已填寫的廣告可用性。
如果這是您第一次 CloudWatch 搭配使用 AWS Elemental MediaTailor,請建立 AWS Identity and Access Management (IAM) 角色以允許服務之間的通訊。
允許 AWS Elemental MediaTailor 存取 CloudWatch (主控台)
開啟位於 https://console.aws.amazon.com/iam/
的 IAM 主控台。 -
在 IAM 主控台的導覽窗格中,選擇 Roles (角色),然後選擇 Create role (建立角色)。
-
選擇 [其他] AWS 帳戶角色類型。
-
在帳戶 ID 中,輸入您的 AWS 帳戶 ID。
-
選取 Require external ID (需要外部 ID),然後輸入
midas
。此選項會自動新增條件到信任政策,讓服務只在請求包含正確的sts:ExternalID
時才擔任該角色。 -
選擇 Next: Permissions (下一步:許可)。
-
新增指定此角色可以完成之動作的許可政策。選取以下其中一個選項,然後選擇 Next: Review (下一步:檢閱):
-
CloudWatchLogsFullAccess提供對 Amazon CloudWatch 日誌的完全訪問權限
-
CloudWatchFullAccess提供對 Amazon 的完全訪問 CloudWatch
-
-
針對角色名稱,輸入
MediaTailorLogger
,然後選擇建立角色。 -
在 Roles (角色) 頁面上,選取您剛剛建立的角色。
-
編輯信任關係以更新委託人:
-
在角色的 Summary (摘要) 頁面上,選擇 Trust relationship (信任關係) 標籤。
-
選擇「編輯信任關係」。
-
在政策文件中,將委託人變更為 AWS Elemental MediaTailor 服務。它應該如下所示。
"Principal": { "Service": "mediatailor.amazonaws.com" },
整個政策看起來應該如下所示。
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "mediatailor.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "sts:ExternalId": "Midas" } } } ] }
-
選擇 Update Trust Policy (更新信任政策)。
-
步驟 8:清除
為了避免產生額外的費用,請刪除所有不必要的組態。
刪除組態 (主控台)
-
在「 AWS Elemental MediaTailor 組態」頁面上,執行下列其中一項作業:
-
選擇您要刪除的組態的 Configuration name (組態名稱)。
-
在 Configuration name (組態名稱) 資料欄中,選擇名稱旁的選項按鈕,然後選擇 Delete (刪除)。
-
-
在 Delete configuration (刪除組態) 確認方塊中,輸入
Delete
,然後選擇 Delete (刪除)。AWS Elemental MediaTailor 移除組態。