Cookie の設定を選択する

当社は、当社のサイトおよびサービスを提供するために必要な必須 Cookie および類似のツールを使用しています。当社は、パフォーマンス Cookie を使用して匿名の統計情報を収集することで、お客様が当社のサイトをどのように利用しているかを把握し、改善に役立てています。必須 Cookie は無効化できませんが、[カスタマイズ] または [拒否] をクリックしてパフォーマンス Cookie を拒否することはできます。

お客様が同意した場合、AWS および承認された第三者は、Cookie を使用して便利なサイト機能を提供したり、お客様の選択を記憶したり、関連する広告を含む関連コンテンツを表示したりします。すべての必須ではない Cookie を受け入れるか拒否するには、[受け入れる] または [拒否] をクリックしてください。より詳細な選択を行うには、[カスタマイズ] をクリックしてください。

での動的広告変数の使用 MediaTailor

フォーカスモード

このページの内容

での動的広告変数の使用 MediaTailor - AWS Elemental MediaTailor

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

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

広告決定サーバー (ADS) への AWS Elemental MediaTailor リクエストには、現在の表示セッションに関する情報が含まれており、 がレスポンスで提供する最適な広告ADSを選択するのに役立ちます。 MediaTailor 設定でADSテンプレートを設定するときに、マクロとも呼ばれる動的変数を含めることができます。動的変数は置き換え可能な文字列です。

動的変数は、以下の形態にすることができます。

  • 静的値 - セッション間で変更されない値。例えば、 が MediaTailor に期待するレスポンスタイプですADS。

  • ドメイン変数 – http://.my-ads-servercom の .my-ads-servercom URL 部分など、URLドメインに使用できる動的変数。詳細については、「ドメイン変数の使用」を参照してください。

  • セッションデータ – セッション ID など、セッション MediaTailor ごとに によって提供される動的な値。詳細については、「セッション変数の使用」を参照してください。

  • プレイヤーデータ - セッションごとにプレイヤーから提供される動的値。これらはコンテンツビューワーを記述し、 ADSがどの広告をストリームに MediaTailor ステッチするかを判断するのに役立ちます。詳細については、「プレイヤー変数の使用」を参照してください。

にパラメータを渡す ADS

次の手順では、 への MediaTailor リクエストで動的変数を設定する方法について説明しますADS。

セッションおよびプレイヤー情報を に渡すには ADS
  1. を使用して、広告クエリに応答するために必要な情報ADSを決定します AWS Elemental MediaTailor。

  2. ADS 要件を満たすテンプレートADSリクエスト MediaTailor を使用する設定を URL に作成します。でURL、静的パラメータと動的パラメータのプレースホルダーを含めます。設定URLの広告決定サーバーフィールドにテンプレートを入力します。

    次のテンプレート例ではURL、 correlationはセッションデータを提供し、 はプレイヤーデータdeviceTypeを提供します。

    https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]
  3. プレーヤーで、プレーヤーデータのパラメータを渡すように AWS Elemental MediaTailor のセッション開始リクエストを設定します。セッション開始リクエストにお客様のパラメータを含め、セッションに対する後続のリクエストからそれらのパラメータを省きます。

    プレイヤーがセッションを初期化するために行う呼び出しのタイプによって、プレイヤー (クライアント) または MediaTailor (サーバー) がセッションの広告追跡レポートを提供するかどうかが決まります。これらの 2 つのオプションについては、「広告追跡データの報告 」を参照してください。

    サーバー側とクライアント側のどちらの広告追跡レポートが必要かどうかに応じて、以下のいずれかのタイプの呼び出しを行います。どちらの呼び出し例でも、 userIDは を対象としADSており、 auth_tokenはオリジンを対象としています。

    • (オプション) サーバー側の広告追跡レポートの呼び出し – に送信するパラメータ MediaTailor の前に ADS を付けますads。 MediaTailor からオリジンサーバーに送信するパラメータの前には何も付けません。

      次の例は、 への HLSおよび DASHへの受信リクエストを示しています AWS Elemental MediaTailor。 は へのリクエストdeviceTypeで MediaTailor を使用しADS、 はオリジンサーバーへのリクエスト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セッションデータとプレイヤーのadsパラメータ AWS Elemental MediaTailor に置き換えます。プレイヤーからの残りのパラメータは、オリジンサーバーに渡されます。

例 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 パラメータ名: 10,000 文字

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

  • ADS URL: 25,000 文字

高度な使用法

プレイヤーとセッションのデータを使用して、さまざまな方法で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. or its affiliates.All rights reserved.