MediaTailor parameter reference and limitations - AWS Elemental MediaTailor

MediaTailor parameter reference and limitations

Before configuring dynamic ad variables, understand the parameter formatting requirements and limitations that apply to all MediaTailor configurations.

AWS Elemental MediaTailor provides comprehensive information about parameter character restrictions, length limitations, and supported formats for both manifest query parameters and ADS parameters.

Manifest query parameter character restrictions

Manifest query parameters support specific characters and have defined length limitations.

Supported characters (without URL-encoding)

You can use the following characters directly in manifest query parameters:

  • Alphanumeric characters (A-Z, a-z, 0-9)

  • Periods (.)

  • Hyphens (-)

  • Underscores (_)

  • Backslashes (\)

Supported characters with URL-encoding

The following special characters are supported when URL-encoded:

  • period (.) = %2E

  • dash (-) = %2D

  • underscore (_) = %5F

  • percent (%) = %25

  • tilde (~) = %7E

  • forward slash (/) = %2F

  • asterisk (*) = %2A

  • equals (=) = %3D

  • question (?) = %3F

URL-encoding support

MediaTailor supports the percent (%) sign when you use it in URL-encoding (for example, hello%20world = hello world). You can use any URL-encoded characters, as long as they are valid URL-encodings according to the HTTP specification.

Unsupported characters

You cannot use the following characters in manifest query parameters without URL-encoding: :, ?, &, =, %, / (forward slash).

Important

MediaTailor doesn't support double characters such as %%% or ==. You can't use full URLs as manifest query parameter values due to character restrictions.

Length limitations

The total length of all manifest query parameters (keys and values combined) must not exceed 2000 characters.

ADS parameter length limitations

The following length limitations apply to parameters used in requests to the ADS:

  • ADS parameter name: Maximum 10,000 characters

  • ADS parameter value: Maximum 25,000 characters

  • ADS URL: Maximum 25,000 characters