プレイヤー変数の使用 - AWS Elemental MediaTailor

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

プレイヤー変数の使用

プレイヤーから受信したデータを に送信する AWS Elemental MediaTailor ように を設定するにはADS、テンプレート ADS でplayer_params.<query_parameter_name>変数URLを指定します。例えば、プレイヤーがリクエストuser_idで という名前のクエリパラメータを に送信し MediaTailor、そのデータをADSリクエストに渡す場合は、ADSURL設定[player_params.user_id]に を含めます。

これにより、ADSリクエストに含まれるクエリパラメータを制御できます。通常、 がADS認識する特別なクエリパラメータをADSリクエストに追加URLし、キーと値のペアを パラメータの値として指定します。

この後の手順で使用されている例では、以下のキーと値のペアを使用しています。

  • param1 と値 value1:

  • param2 と値 value2:

クエリパラメータをキーバリューペアとして追加する

  1. で AWS Elemental MediaTailor、パラメータを参照URLするようにADSリクエストテンプレートを設定します。以下は、パラメータの例を含める方法URLを示しています。

    https://my.ads.com/path?param1=[player_params.param1]&param2=[player_params.param2]

  2. （オプション) サーバー側の広告追跡レポートの場合は、プレイヤーのキーと値のペアをURLエンコードします。がセッション初期化リクエスト MediaTailor を受信すると、 は値をADSリクエスト URLに置き換える前に 1 回デコードしますURL。

    注記

    で URLエンコードされた値ADSが必要な場合は、プレイヤーで URL2 回値をエンコードします。これにより、 によってデコードされると MediaTailor 、 の値が 1 回エンコードされますADS。

    例えば、 に送信される値のデコードされた表現ADSが の場合param1=value1:&param2=value2:、 URLエンコードされた表現は ですparam1=value1%3A&param2=value2%3A。

  3. プレイヤーからのセッション初期化呼び出しで、キーと値のペアを単一のクエリパラメータの値 MediaTailor として に渡します。以下のサンプルの呼び出しでは、サーバー側とクライアント側の広告追跡レポートに使用されるキーと値のペアの例を示しています。

    • サーバー側の広告追跡レポートのリクエスト例 - URLエンコードされたペアを使用する

      HLS:

      <master>.m3u8?ads.param1=value1%3A&ads.param2=value2%3A

      DASH:

      <manifest>.mpd?ads.param1=value1%3A&ads.param2=value2%3A

    • クライアント側の広告追跡レポートのリクエスト例 - URLエンコードなし

      HLS:

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

      DASH:

      POST <manifest>.mpd
    {
        "adsParams": {
           "param1": "value1:",
           "param2": "value2:"
       }
    }

サーバー側のレポートの場合、 はプレイヤーリクエストが受信されたときにパラメータを MediaTailor デコードします。クライアント側のレポートでは、JSONペイロードで受信したパラメータは変更されません。 は次のリクエストを MediaTailor に送信しますADS。

https://my.ads.com/<path>?param1=value1:&param2=value2:

このようにして、 param1と のparam2キーと値のペアはADS、リクエストにファーストクラスのクエリパラメータとして含まれます。