での動的広告変数の使用 MediaTailor - AWS Elemental MediaTailor
へのパラメータの受け渡し ADS高度な使用法

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

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

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

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

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

  • ドメイン変数 – http://.my-ads-servercom の .com URL 部分など、URLドメインに使用できる動的変数my-ads-server。詳細については、「ドメイン変数を使用して複数のコンテンツと広告ソースを設定する」を参照してください。

  • セッションデータ – セッション ID など、セッション 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で ADSを使用し、オリジンサーバーへのリクエストauth_tokenで MediaTailor を使用します。

      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"
       }
    }

プレイヤーがセッションを開始すると、 AWS Elemental MediaTailor は、テンプレートADSリクエストの変数をURLセッションデータとプレイヤーのadsパラメータに置き換えます。プレイヤーからの残りのパラメータは、オリジンサーバーに渡されます。

次の例は、 からの ADSおよびオリジンサーバーへの呼び出しを示しています。 AWS Elemental MediaTailor 前のプレイヤーのセッション初期化呼び出しの例に対応する 。

  • 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

以下のセクションでは、セッションデータとプレイヤーデータの設定を詳しく説明します。

高度な使用法

プレイヤーとセッションデータを使用して、さまざまな方法で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]