ドメイン変数を使用して複数のコンテンツと広告ソースを設定する - AWS Elemental MediaTailor
動的変数として使用する設定エイリアスの作成セッションのドメインを動的に設定するための設定エイリアスの使用

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ドメイン変数を使用して複数のコンテンツと広告ソースを設定する

動的ドメイン変数を使用すると、http://.my-ads-servercom の .my-ads-servercom URL 部分など、設定内のプレイヤーパラメータで複数のドメインを使用できます。これにより、1 つの設定で複数のコンテンツソースまたは広告決定サーバー (ADS) を使用できます。

ドメイン変数は、 を含む任意のパラメータで使用できますURI。

  • AdDecisionServerUrl

  • AdSegmentUrlPrefix

  • ContentSegmentUrlPrefix

  • LivePreroll.AdDecisionServerUrl

  • VideoContentSourceUrl

ドメイン変数は、動的変数置換を実行するために、設定のエイリアスと共に使用されます。設定エイリアスは、動的ドメイン設定に使用されるプレイヤーパラメータに一連のエイリアスと値をマップします。

動的変数として使用する設定エイリアスの作成

ドメイン変数の使用を開始する前に、設定のための設定エイリアスを作成します。設定エイリアスは、セッション開始時のドメイン置換変数として使用します。例えば、設定エイリアスを使用して、セッションの初期化URL中にオリジンを動的に設定できます。

設定エイリアスの作成

コンソールを使用して MediaTailorドメイン置換に使用する設定エイリアスを作成するには、次の手順を実行します。

コンソールを使用して設定エイリアスを作成する

  1. で MediaTailor コンソールを開きますhttps://console.aws.amazon.com/mediatailor/。

  2. [Configurations] (設定) ページの [Configuration aliases] (設定エイリアス) ページで、[Add player parameter] (プレイヤーパラメータを追加) をクリックします。

  3. ドメイン置換の動的変数として使用するプレイヤーパラメータ名を入力します。名前の前には、player_params. を付ける必要があります。

  4. [OK] を選択します。

    AWS Elemental MediaTailor は、設定エイリアスセクションのテーブルに新しいパラメータを表示します。

  5. 次に、エイリアスと値を追加します。先ほど名前を付けたプレイヤーパラメータを選択します。選択すると、パラメータ名の下のセクションが展開されます。

    [Add new alias] (新しいエイリアスを追加) をクリックします。

  6. エイリアスキーを入力し、Value. MediaTailor uses Value をドメイン変数の置き換え値として使用します。

セッションのドメインを動的に設定するための設定エイリアスの使用

設定エイリアスをセットアップしたら、セッション開始リクエスト内のドメイン用の置換変数としてそれらを使用できます。これは、セッションのドメインを動的に設定することを可能にします。

制限事項

設定エイリアスの使用時は、以下の制限に注意してください。

  • ドメインで使用される動的変数は、すべて ConfigurationAliases 動的変数として定義される必要があります。

  • プレイヤーパラメータ変数の前に player_params. を付ける必要があります。例えば、player_params.origin_domain と指定します。

  • エイリアス化された値のリストは、すべてのプレイヤーパラメータに対する包括的なリストである必要があります。

  • ドメインで使用されている動的値に対してリクエストが行われ、そのリクエストで動的変数またはその変数に事前設定されたエイリアスのいずれかが指定されていない場合、リクエストは HTTP400ステータスコードで失敗します。

例 使用例

以下は、設定エイリアスと動的ドメイン変数が含まれる設定の例です。AdDecisionServerUrl および VideoContentSourceUrl パラメータドメイン内のプレイヤーパラメータ変数 ([player_params.origin_domain] など) に特に注意してください。

PUT /playbackConfiguration
   {
       "Name": "aliasedConfig",
       ...
       "AdDecisionServerUrl": "https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=[player_params.ad_type]",
       "VideoContentSourceUrl": "https://[player_params.origin_domain].mediapackage.[player_params.region].amazonaws.com/out/v1/[player_params.endpoint_id]",
       ...
       "ConfigurationAliases": {
           "player_params.origin_domain": {
               "pdx": "abc",
               "iad": "xyz"
           },
           "player_params.region": {
               "pdx": "us-west-2",
               "iad": "us-east-1"
           },
           "player_params.endpoint_id": {
               "pdx": "abcd",
               "iad": "wxyz"
           },
           "player_params.ad_type": {
               "customized": "abc12345",
               "default": "defaultAdType"
           },
       },
       ...
   }

上記の設定を使用して、プレイヤー変数とエイリアスを指定するセッション開始リクエストを作成します。

POST master.m3u8
   {
       "playerParams": {
           "origin_domain": "pdx",
           "region": "pdx",
           "endpoint_id": "pdx",
           "ad_type": "customized"
       }
   }

MediaTailor は、エイリアス文字列を設定エイリアス設定のマッピングされた値に置き換えます。

ADS に対するリクエストは以下のようになります。

https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345

VideoContentSource に対するリクエストは以下のようになります。

https://777788889999.mediapackage.us-west-2.amazonaws.com/out/v1/abcd