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

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

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

静的値 - セッション間で変更されない値。たとえば、 MediaTailor が ADS に想定するレスポンスタイプです。
ドメイン変数 — URL http://my-ads-servermy-ads-server.com の .com 部分など、URL ドメインに使用できる動的変数。詳細については、「ドメイン変数の使用」を参照してください。
セッションデータ — セッション ID など、 MediaTailor セッションごとに提供される動的値。詳細については、「セッション変数の使用」を参照してください。
プレイヤーデータ - セッションごとにプレイヤーから提供される動的値。これらはコンテンツ視聴者を説明し、 MediaTailor どの広告をストリームに組み込むべきかをADSが判断するのに役立ちます。詳細については、「プレイヤー変数の使用」を参照してください。

動的ドメイン、セッション、およびプレイヤー変数の使用に関する詳細については、該当するトピックを選択してください。

トピック

ADS にパラメータを渡す

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

ADS を使用して、AWS Elemental MediaTailor からの広告クエリに応答するのに必要な情報を決定します。
ADS 要件を満たすテンプレート ADS リクエスト URL を使用する設定を作成します。 MediaTailor URL に、静的パラメータを含め、動的パラメータのプレースホルダーを含めます。設定の [Ad decision server (広告決定サーバー)] フィールドにテンプレートの URL を入力します。

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

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

サーバー側とクライアント側のどちらの広告追跡レポートが必要かどうかに応じて、以下のいずれかのタイプの呼び出しを行います。どちらの例の呼び出しでも、userID は ADS を対象とし、auth_token はオリジンを対象としています。
- (オプション) サーバー側の広告追跡レポートの呼び出し — ADS に送信するパラメーターのプレフィックスを付けます。 MediaTailor ads MediaTailor からオリジンサーバーに送信するパラメータの前には何も付けません。
  
  次の例は、HLS と DASH to の受信リクエストを示しています。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"
       }
    }
```

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

以下の例では、前のプレーヤーのセッション開始呼び出しの例に対応する、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]
```

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

広告トラッキングインテグレーション

ドメイン変数の使用