使用動態廣告變數 MediaTailor

所以此 AWS Elemental MediaTailor 請求到廣告決策服務器（ADS）包括有關當前觀看會話的信息，這有助於ADS選擇在其響應中提供的最佳廣告。當您在 MediaTailor 組態中設定ADS範本時，您可以包含動態變數，也稱為巨集。動態變數是可取代的字串。

動態變數可採用下列形式：

靜態值 — 不會從一個工作階段變更到下一個工作階段的值。例如， MediaTailor預期的回應類型ADS。
網域變數 — 可用於URL網域的動態變數，例如 URL http://my-ads-server.com 的 .com 部分。my-ads-server如需詳細資訊，請參閱使用網域變數設定多個內容和廣告來源。
工作階段資料 — 每個階段作業所 MediaTailor 提供的動態值，例如階段作業 ID。如需詳細資訊，請參閱使用會話變量。
玩家資料 — 玩家針對每個工作階段提供的動態值。這些內容描述了內容查看器，並幫助確定哪些廣告 MediaTailor 應該拼接到流中。ADS如需詳細資訊，請參閱使用播放器變數。

如需有關使用動態網域、工作階段和播放程式變數的詳細資訊，請選取適用的主題。

主題

將參數傳遞給 ADS

將工作階段和玩家資訊傳遞至 ADS

使用ADS來判斷所需的資訊，以便它能夠回應來自的廣告查詢 AWS Elemental MediaTailor.
在中建立使用 MediaTailor 符合需ADS求URL的範本ADS要求的組態。在中URL，包括靜態參數，並包括動態參數的預留位置。URL在設定的「廣告決策伺服器」欄位中輸入範本。

在下列範例範本中URL，correlation提供工作階段資料，並deviceType提供播放程式資料：
```
https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]
```
在播放程式上，設定工作階段啟動要求 AWS Elemental MediaTailor 提供玩家資料的參數。在工作階段啟動請求中包含您的參數，並在工作階段的後續請求中省略它們。

播放程式為初始化工作階段所做的呼叫類型，會決定播放程式 (用戶端) 或 MediaTailor (伺服器) 是否提供工作階段的廣告追蹤報告。如需關於這兩個選項的詳細資訊，請參閱報告廣告追蹤資料。

根據您需要的是伺服器或用戶端廣告追蹤報告，進行以下其中一個類型的呼叫。在這兩個範例呼叫中，userID都適用auth_token於ADS和適用於原點：
- (選項) 呼叫伺服器端廣告追蹤報告 — 為您要傳送 MediaTailor 至的參數前綴。ADS ads保留您要傳送 MediaTailor 至原始伺服器之參數的前置字元：
  
  下列範例顯示HLS與DASH寄件者的傳入要求 AWS Elemental MediaTailor。 MediaTailor deviceType在對原始伺服器的要求auth_token中使用在其要求中的ADS和。
  
  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 URL用會話數據和播放器的ads參數替換模板ADS請求中的變量。它會從播放器將其餘的參數傳遞至原始伺服器。

下列範例顯示來自ADS和原始伺服器的呼叫 AWS Elemental MediaTailor 對應於前面玩家的會話初始化調用示例：

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]
```

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

廣告追蹤整合

使用網域變數