在 AWS Elemental 中使用動態廣告變量 MediaTailor - AWS Elemental MediaTailor

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

在 AWS Elemental 中使用動態廣告變量 MediaTailor

AWS Elemental Elemental MediaTailor 廣告決策伺服器 (ADS) 的請求包含有關當前查看工作階段的資訊,可幫助 ADS 選擇要在回應中提供的最佳廣告。當您在 MediaTailor 配置,則可以包含動態變量,也稱為宏。動態變量是可替換的字符串。

動態變數可能會採用以下形式:

  • 靜態值— 不會在不同工作階段間變更的值。例如, MediaTailor 預期 ADS 提供的回應類型。

  • 域變數— 可用於 URL 域的動態變量,例如my-ads-server.com網址的一部分 HTTP://my-ads-server.com。如需詳細資訊,請參閱 使用域變數

  • 會話數據— 動態值由 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 發送到 ADSads。對您要 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
    • (選項) 用户端廣告追蹤報告的呼叫 — 提供範本內 ADS 的參數adsParams物件。

      HLS 範例:

      POST master.m3u8 { "adsParams": { "deviceType": "ipad" } }

      DASH 範例:

      POST manifest.mpd { "adsParams": { "deviceType": "ipad" } }

當玩家啟動會話時,AWS Elemental MediaTailor 會將範本 ADS 請求 URL 中的變數替換為工作階段資料,而播放器的ads參數。它會從播放器將其餘的參數傳遞至原始伺服器。

以下範例顯示從 AWS Elemental 對 ADS 和原始伺服器的呼叫 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]