翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
広告決定サーバー (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 クエリパラメータの長さの制限。
-
ADS リクエストのその他のカスタマイズについては、「」を参照してください高度な使用法。
セッションおよびプレイヤー情報を に渡すには ADS
-
を使用して、広告クエリに応答するために必要な情報ADSを決定します AWS Elemental MediaTailor。
-
ADS 要件を満たすテンプレートADSリクエスト MediaTailor を使用する設定を URL に作成します。でURL、静的パラメータと動的パラメータのプレースホルダーを含めます。設定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
はオリジンを対象としています。-
(オプション) サーバー側の広告追跡レポートの呼び出し – に送信するパラメータ 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]
動的ドメイン、セッション、およびプレイヤー変数の使用に関する詳細については、該当するトピックを選択してください。