MediaTailor が ADS にパラメータを渡す - AWS Elemental MediaTailor
高度な使用法

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

MediaTailor が ADS にパラメータを渡す

AWS Elemental MediaTailor は、次の手順を使用して ADS への MediaTailor リクエストで動的変数の設定をサポートします。

セッションの初期化方法

MediaTailor は、セッションの初期化とパラメータの受け渡しに複数の方法をサポートしています。

  1. リクエスト本文を含む POST:

    POST <master>.m3u8
{
    "adsParams": {"param1": "value1", "param2": "value2"},
    "playerParams": {"param3": "value3"}
}

  2. URL のクエリパラメータ：

    GET <master>.m3u8?ads.param1=value1&ads.param2=value2&playerParams.param3=value3
重要

初期化時に指定できるパラメータは 1 回のみです。設定エイリアスは、転送前に実際の値に解決されます。

セッションとプレイヤーの情報を ADS に渡す

  1. ADS と連携して、広告クエリに応答するために必要な情報を決定します AWS Elemental MediaTailor。

  2. MediaTailor で、ADS 要件を満たすテンプレート ADS リクエスト URL を使用する設定を作成します。URL に、静的パラメータを含め、動的パラメータのプレースホルダーを含めます。設定の [Ad decision server (広告決定サーバー)] フィールドにテンプレートの 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。MediaTailor は、ADS に対するリクエストでは deviceType、オリジンサーバーに対するリクエストでは 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

高度な使用法

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