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 エンコードのサポート

MediaTailor は、URL エンコード (hello%20world = hello world など) で使用すると、パーセント (%) 記号をサポートします。HTTP 仕様に従って有効な URL エンコードである限り、任意の URL エンコード文字を使用できます。

サポートされていない文字

URL エンコードなしでマニフェストクエリパラメータに次の文字を使用することはできません: :、?、&、=%、、 / (スラッシュ）。

重要

MediaTailor は、%%% や == などの二重文字をサポートしていません。文字制限のため、マニフェストクエリパラメータ値として完全な URLs を使用することはできません。

長さの制限

すべてのマニフェストクエリパラメータ (キーと値の組み合わせ) の合計長は 2000 文字を超えることはできません。

ADS パラメータの長さの制限

ADS へのリクエストで使用されるパラメータには、次の長さ制限が適用されます。

• ADS パラメータ名: 最大 10,000 文字

• ADS パラメータ値: 最大 25,000 文字

• ADS URL: 最大 25,000 文字