本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用動態廣告變數 AWS Elemental MediaTailor
對廣告決策伺服器 (ADS) 的 AWS Elemental MediaTailor 請求包含有關目前檢視工作階段的資訊,可幫助 ADS 選擇要在回應中提供的最佳廣告。在設定中設定 ADS 範本時,您 MediaTailor 可以加入動態變數,也稱為巨集。動態變數是可取代的字串。
動態變數可採用下列形式:
-
靜態值 — 不會從一個工作階段變更到下一個工作階段的值。例如, MediaTailor 預期 ADS 提供的回應類型。
-
網域變數 — 可用於 URL 網域的動態變數,例如網址 http://my-ads-server.com 的 .com 部分。my-ads-server如需詳細資訊,請參閱 使用網域變數。
-
工作階段資料 — 每個階段作業所 MediaTailor 提供的動態值,例如階段作業 ID。如需詳細資訊,請參閱 使用會話變量。
-
玩家資料 — 玩家針對每個工作階段提供的動態值。這些內容描述了內容查看器,並幫助 ADS 確定 MediaTailor 應該將哪些廣告拼接到流中。如需詳細資訊,請參閱 使用播放器變數。
如需有關使用動態網域、工作階段和播放程式變數的詳細資訊,請選取適用的主題。
將參數傳遞給 ADS
將工作階段和播放器資訊傳遞至 ADS
-
使用 ADS 來判斷所需的資訊,使它能夠回應來自 AWS Elemental MediaTailor 的廣告查詢。
-
在中建立使用 MediaTailor 符合 ADS 需求範本 ADS 要求 URL 的設定。在 URL 中,包括靜態參數並包括動態參數的預留位置。在組態的 Ad decision server (廣告決策伺服器) 欄位中輸入您的範本 URL。
在下列範例範本 URL 中,
correlation
會提供工作階段資料,並且deviceType
提供播放器資料:https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]
-
在播放器上,設定 AWS Elemental MediaTailor 的工作階段啟動請求,以提供播放器資料的參數。在工作階段啟動請求中包含您的參數,並在工作階段的後續請求中省略它們。
播放程式為初始化工作階段所做的呼叫類型,會決定播放程式 (用戶端) 或 MediaTailor (伺服器) 是否提供工作階段的廣告追蹤報告。如需關於這兩個選項的詳細資訊,請參閱報告廣告追蹤資料 。
根據您需要的是伺服器或用戶端廣告追蹤報告,進行以下其中一個類型的呼叫。在這兩個範例呼叫中,
userID
預期用於 ADS 和auth_token
預期用於來源:-
(選項)呼叫服務器端廣告跟踪報告 — 在您要發送 MediaTailor 給 ADS 的參數前綴。
ads
對您要 MediaTailor 傳送至原始伺服器的參數略過該字首:下列範例顯示 HLS 和 DASH 至AWS Elemental MediaTailor的傳入要求。 MediaTailor
deviceType
在對 ADS 的請求中使用,並auth_token
在其對原始服務器的請求中使用。HLS 範例:
GET master.m3u8?ads.deviceType=ipad&auth_token=kjhdsaf7gh
DASH 範例:
GET manifest.mpd?ads.deviceType=ipad&auth_token=kjhdsaf7gh
-
(選項) 呼叫用戶端廣告追蹤報告 — 提供
adsParams
物件內 ADS 的參數。HLS 範例:
POST master.m3u8 { "adsParams": { "deviceType": "ipad" } }
DASH 範例:
POST manifest.mpd { "adsParams": { "deviceType": "ipad" } }
-
當播放器啟動工作階段時,AWS Elemental MediaTailor 會將範本 ADS 請求 URL 中的變數以工作階段變數資料和播放器的 ads
參數取代。它會從播放器將其餘的參數傳遞至原始伺服器。
以下範例顯示從對應於前述播放器的工作階段初始化呼叫範例的 AWS Elemental MediaTailor 對 ADS 和原始伺服器的呼叫:
-
MediaTailor 使用會話數據和播放器的設備類型調用 ADS:
https://my.ads.server.com/path?correlation=896976764&deviceType=ipad
-
MediaTailor 使用播放器的授權令牌調用源服務器。
-
HLS 範例:
https://my.origin.server.com/master.m3u8?auth_token=kjhdsaf7gh
-
DASH 範例:
https://my.origin.server.com/manifest.mpd?auth_token=kjhdsaf7gh
-
以下小節提供用於設定工作階段和播放器資料的詳細資訊。
進階使用
您可以用多種方式來自訂 ADS 請求,以搭配播放器和工作階段資料。唯一的需求是包含 ADS 主機名稱。
以下範例顯示您可以自訂您的請求的一些方式:
-
串聯播放器參數和工作階段參數來建立新的參數。範例:
https://my.ads.com?key1=[player_params.value1][session.id]
-
使用播放器參數做為路徑元素的一部分。範例:
https://my.ads.com/[player_params.path]?key=value
-
使用播放器參數來同時傳遞路徑元素和索引鍵本身,而不只是值。範例:
https://my.ads.com/[player_params.path]?[player_params.key1]=[player_params.value1]