MediaTailor 參數參考和限制

設定動態廣告變數之前，請了解適用於所有 MediaTailor 組態的參數格式化需求和限制。

AWS Elemental MediaTailor 提供資訊清單查詢參數和 ADS 參數的參數字元限制、長度限制和支援格式的完整資訊。

資訊清單查詢參數字元限制

資訊清單查詢參數支援特定字元，並已定義長度限制。

支援的字元 （不含 URL 編碼）

您可以直接在資訊清單查詢參數中使用下列字元：

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

• 期間 (.)

• 連字號 (-)

• 底線 (_)

• 反斜線 (\)

支援 URL 編碼的字元

URL 編碼時支援下列特殊字元：

• 期間 (.) = %2E

• 破折號 (-) = %2D

• 底線 (_) = %5F

• 百分比 (%) = %25

• 波浪 (~) = %7E

• 正斜線 (/) = %2F

• 星號 (*) = %2A

• 等於 (=) = %3D

• 問題 (？) = %3F

URL 編碼支援

當您在 URL 編碼中使用 MediaTailor 時，支援百分比 (%) 符號 （例如 hello%20world = hello world)。您可以使用任何 URL 編碼字元，只要它們是根據 HTTP 規格有效的 URL 編碼即可。

不支援的字元

您無法在沒有 URL 編碼的情況下，在資訊清單查詢參數中使用下列字元：:、?、&、=%、、 /（正斜線）。

重要

MediaTailor 不支援雙字元，例如 %%% 或 ==。由於字元限制，您無法使用完整 URLs 做為資訊清單查詢參數值。

長度限制

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

ADS 參數長度限制

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

• ADS 參數名稱：最多 10，000 個字元

• ADS 參數值：最多 25，000 個字元

• ADS URL：最多 25，000 個字元