使用動態廣告變數 AWS Elemental MediaTailor - AWS Elemental MediaTailor

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

使用動態廣告變數 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
  1. 使用 ADS 來判斷所需的資訊,使它能夠回應來自 AWS Elemental MediaTailor 的廣告查詢。

  2. 在中建立使用 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]
  3. 在播放器上,設定 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]