選取您的 Cookie 偏好設定

我們使用提供自身網站和服務所需的基本 Cookie 和類似工具。我們使用效能 Cookie 收集匿名統計資料,以便了解客戶如何使用我們的網站並進行改進。基本 Cookie 無法停用,但可以按一下「自訂」或「拒絕」以拒絕效能 Cookie。

如果您同意,AWS 與經核准的第三方也會使用 Cookie 提供實用的網站功能、記住您的偏好設定,並顯示相關內容,包括相關廣告。若要接受或拒絕所有非必要 Cookie,請按一下「接受」或「拒絕」。若要進行更詳細的選擇,請按一下「自訂」。

在 MediaTailor 中使用動態廣告變數

焦點模式
在 MediaTailor 中使用動態廣告變數 - AWS Elemental MediaTailor

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

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

對廣告決策伺服器 (ADS) 的 AWS Elemental MediaTailor 請求包含有關目前檢視工作階段的資訊,這有助於 ADS 選擇在其回應中提供的最佳廣告。當您在 MediaTailor 組態中設定 ADS 範本時,您可以包含動態變數,也稱為巨集。動態變數是可取代的字串。

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

  • 靜態值 – 不會從一個工作階段變更為下一個工作階段的值。例如,MediaTailor 從 ADS 預期的回應類型。

  • 網域變數 – 可用於 URL 網域的動態變數,例如 URL https://my-ads-server.comhttp://my-ads-server.com 。如需詳細資訊,請參閱 使用網域變數

  • 工作階段資料 – MediaTailor 為每個工作階段提供的動態值,例如工作階段 ID。如需詳細資訊,請參閱 使用工作階段變數

  • 玩家資料 – 玩家為每個工作階段提供的動態值。這些說明內容檢視器,並協助 ADS 判斷 MediaTailor 應該接合至串流的廣告。如需詳細資訊,請參閱 使用玩家變數

將參數傳遞至 ADS

下列步驟說明如何在對 ADS 的 MediaTailor 請求中設定動態變數。

將工作階段和播放器資訊傳遞至 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 會在對 ADS 的請求deviceType中使用 ,並在對原始伺服器的請求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" } }

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

範例 具有廣告變數的 MediaTailor 請求

以下範例顯示從對應於前述播放器的工作階段初始化呼叫範例的 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

資訊清單查詢參數支援的字元和限制

您可以在資訊清單請求中使用的查詢參數中使用下列字元:

  • 英數字元 (A-Z、a-z、0-9)

  • 期間 (.)

  • 連字號 (-)

  • 底線 (_)

  • 反斜線 (\)

長度限制

所有資訊清單查詢參數 (合併索引鍵和值) 的總長度不得超過 2000 個字元。

不支援的字元

您無法在資訊清單查詢參數中使用下列字元::?&=%/(正斜線)

ADS 查詢參數長度限制

下列長度限制適用於 ADS 請求中使用的查詢參數:

  • ADS 參數名稱:10000 個字元

  • ADS 參數值:25000 個字元

  • ADS URL:25000 個字元

進階用量

您可以用多種方式來自訂 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]

如需使用動態網域、工作階段和玩家變數的詳細資訊,請選取適用的主題。

在本頁面

隱私權網站條款Cookie 偏好設定
© 2025, Amazon Web Services, Inc.或其附屬公司。保留所有權利。