翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # MediaTailor 広告挿入の使用開始 を使用するには AWS Elemental MediaTailor、MediaTailor 設定にアクセス、表示、編集するための および アクセス AWS アカウント 許可が必要です。これを行う方法については、「[セットアップ AWS Elemental MediaTailor](setting-up.md)」を参照してください。 この入門チュートリアルでは、次のタスクの実行方法を示します。 + HLS または DASH コンテンツストリームを準備する + 広告決定サーバー (ADS) テンプレート URL を設定する + 再生エンドポイントが含まれる MediaTailor 設定を作成する + プレイヤーまたはコンテンツ配信ネットワーク (CDN) を使用して MediaTailor に再生リクエストを行う 動的変数とプレイヤーパラメータを使用した高度な ADS URL 設定については、「」を参照してください[ADS リクエストの MediaTailor 動的広告変数](variables.md)。CDNs「」を参照してください[MediaTailor マニフェストクエリパラメータ](manifest-query-parameters.md)。 これらを完了したら、ストリーム内のパーソナライズされた広告コンテンツに対する再生リクエストを MediaTailor に送信できるようになります。 **Topics** + [前提条件](#prerequisites) + [ステップ 1: アクセス AWS Elemental MediaTailor](#access-emt) + [ステップ 2: ストリームを準備する](#getting-started-prep-stream) + [ステップ 3: ADS リクエスト URL とクエリパラメータを設定する](#getting-started-configure-request) + [ステップ 4: 設定を作成する](#getting-started-add-mapping) + [ステップ 5: 設定をテストする](#getting-started-test-config) + [ステップ 6: 再生リクエストを に送信する AWS Elemental MediaTailor](#send-request-to-mediatailor) + [ステップ 7 (オプション): AWS Elemental MediaTailor アクティビティをモニタリングする](#monitor-step) + [ステップ 8: クリーンアップする](#clean-up) ## 前提条件 開始する前に、[セットアップ AWS Elemental MediaTailor](setting-up.md) の手順を完了するようにしてください。 ## ステップ 1: アクセス AWS Elemental MediaTailor IAM 認証情報を使用して、MediaTailor コンソール (**https://console.aws.amazon.com/mediatailor/home**) にサインインします。 ## ステップ 2: ストリームを準備する AWS Elemental MediaTailorと互換性のある HLS または DASH のマニフェストを生成するようにオリジンサーバーを設定します。オリジンサーバーは、標準の HTTP ポート (ポート 80) または HTTPS ポート (ポート 443) を使用する必要があります。MediaTailor は、オリジンサーバー通信のカスタムポートをサポートしていません。 ### HLS ストリームを準備する HLS マニフェストは以下の要件を満たす必要があります。 + マニフェストはパブリックインターネットでアクセス可能であることが必要です。 + マニフェストはライブまたはビデオオンデマンド (VOD) である必要があります。 + マニフェストに `3` 以降の `EXT-X-VERSION` があること。 + ライブコンテンツの場合は、マニフェストに ad avail を表すマーカーがあること。VOD コンテンツの場合、これはオプションで、代わりに VMAP timeoffset を使用できます。 マニフェストファイルには、以下のいずれかでマークされた広告スロットが必要です。 + **\$1EXT-X-CUE-OUT / \$1EXT-X-CUE-IN** (一般的) 継続時間は以下の例のようになります。 ``` #EXT-X-CUE-OUT:60.00 #EXT-X-CUE-IN ``` + **\$1EXT-X-DATERANGE** (一般的ではない) 継続時間は以下の例のようになります。 ``` #EXT-X-DATERANGE:ID="",START-DATE="",DURATION=30.000,SCTE35-OUT=0xF #EXT-X-DATERANGE:ID="",START-DATE="",DURATION=30.000,SCTE35-OUT=0xF ``` `#EXT-X-DATERANGE` にあるフィールドはすべて必須です。 マニフェストで広告マーカーを設定する方法は、広告がストリームに挿入されるか、ストリーム内の他のフラグメントに置き換えられるかに影響します。詳細については、「[AWS Elemental MediaTailor 広告挿入動作について](ad-behavior.md)」を参照してください。 + HLS マルチバリアントプレイリストは、[HTTP ライブストリーミング: マスタープレイリストタグ](https://tools.ietf.org/html/draft-pantos-http-live-streaming-21#section-4.3.4)に記載されている HLS 仕様に従う必要があります。特に、`#EXT-X-STREAM-INF` には `RESOLUTION`、`BANDWIDTH`、および `CODEC` の各フィールドを含める必要があります。 ストリームを設定したら、多変量プレイリストのコンテンツオリジン URL プレフィックスを書き留めます。このプレフィックスはこのチュートリアルの後半の AWS Elemental MediaTailorで設定を作成するのに必要です。 ### DASH ストリームを準備する DASH マニフェストは以下の要件を満たす必要があります。 + マニフェストはパブリックインターネットでアクセス可能であることが必要です。 + マニフェストはライブまたはビデオオンデマンド (VOD) である必要があります。 + マニフェストが、スプライス挿入マーカーまたはタイムシグナルマーカーを使用して、イベントを ad avail としてマークすること。広告マーカーは、平文の XML または base64 エンコードのバイナリで指定できます。スプライス挿入の場合は、ネットワーク外インジケータを有効にする必要があります。タイムシグナルマーカーの場合、セグメンテーション UPID 内にあるセグメンテーションタイプ ID は、 によって認識されるキューアウト値である必要があります AWS Elemental MediaTailor。Ad avail はイベントの開始時に開始され、イベント継続時間 (指定されている場合)、または次のイベントが開始されるまで続きます。 以下は、スプライス挿入マーカーを使用して ad avail として指定されたイベントの例です。この ad avail の継続時間はイベントの継続時間です。 ``` ``` + 広告表示の `AdaptationSet` および `Representation` は、コンテンツストリームの期間と同じ設定である必要があります。 AWS Elemental MediaTailor はこれらの設定を使用して、コンテンツストリームに合わせて広告をトランスコードし、コンテンツと広告間でスムーズに切り替わるようにします。 ストリームを設定したら、DASH マニフェストのコンテンツオリジン URL プレフィックスを書き留めておきます。このチュートリアルの後半にある で設定を作成するには AWS Elemental MediaTailor、これが必要です。 ## ステップ 3: ADS リクエスト URL とクエリパラメータを設定する ADS が必要とするクエリパラメータを判断するには、ADS から広告タグ URL を生成します。この URL は ADS に対するリクエストのテンプレートとして機能し、以下の値で構成されています。 + 静的値 + によって生成された値 AWS Elemental MediaTailor ( `session`または `avail` クエリパラメータで示される) + クライアントアプリケーションから取得した、プレイヤーによって生成された値 (`player_params.` クエリパラメータで表されます) **Example ADS からの広告タグ URL** ``` https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=[session.id]&cust_params=[player_params.cust_params] ``` 上記の中で、 + **output** と **content\$1id** は静的値です。 + **playerSession=[session.id]** は、 によって提供される動的値です AWS Elemental MediaTailor。**[session.id]** の値はプレイヤーセッションごとに変更されるため、VAST リクエストの URL はセッションごとに異なります。 + **cust\$1params** はプレイヤー提供の動的値です。 プレイヤーからの多変量プレイリストリクエストは、ADS リクエスト URL の`player_params.`クエリパラメータに対応するキーと値のペアを提供する必要があります。へのリクエストでキーと値のペアを設定する方法の詳細については AWS Elemental MediaTailor、「」を参照してください[ADS リクエストの MediaTailor 動的広告変数](variables.md)。 [ステップ 4: 設定を作成する](#getting-started-add-mapping) で、オリジンサーバー/ADS マッピングを MediaTailor で作成するときに、設定した「テンプレート」URL を入力します。 **テスト** テスト用に ADS からの静的 VAST レスポンスを使用できます。理想的には、VAST レスポンスは、 AWS Elemental MediaTailor がトランスコードできるメザニン品質の MP4 レンディションを返します。ADS からのレスポンスに複数の再生レンディションが含まれている場合、MediaTailor は品質と解像度が最高の MP4 レンディションを選択して、それをトランスコーダーに送信します。 ## ステップ 4: 設定を作成する AWS Elemental MediaTailor 設定には、オリジンサーバーと ADS のマッピング情報が保持されます。 **設定を作成する (コンソール)** 1. MediaTailor コンソール ([https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/)) を開きます。 1. [**設定**] ページで、[**Create configuration (設定の作成)**] を選択します。 1. ページ下部の [**設定**] セクションで、[**設定名**] に設定を説明する一意の名前を入力します。名前は設定の主な識別子です。許容される最大長は 512 文字です。 1. **動画コンテンツソース**には、HLS 多変量プレイリストの URL プレフィックスまたはこのストリームの DASH マニフェストをアセット ID を引いた値を入力します。たとえば、多変量プレイリスト URL が の場合`http://origin-server.com/a/master.m3u8`、 と入力します`http://origin-server.com/a/`。別の方法として `http://origin-server.com` のような短いプレフィックスを入力することもできますが、そうする場合は、コンテンツに対するプレイヤーリクエストのアセット ID に `/a/` を含める必要があります。最大長は 512 文字です。 **注記** コンテンツオリジンが HTTPS を使用している場合、その証明書は既知の認証機関からのものであることが必要です。(この目的に自己署名証明書を使用することはできません)。それ以外の場合、 はコンテンツオリジンへの接続に AWS Elemental MediaTailor 失敗し、プレイヤーのリクエストに応じてマニフェストを提供できません。 1. **[Ad decision server]** (広告決定サーバー) には、ADS の URL を入力します。これは、「[ステップ 3: ADS リクエスト URL とクエリパラメータを設定する](#getting-started-configure-request)」で説明されている変数を含む URL、またはテスト目的で使用している静的 VAST URL です。最大長は 25,000 文字です。 **注記** ADS が HTTPS を使用している場合、その証明書は既知の認証機関からのものであることが必要です。(この目的に自己署名証明書を使用することはできません)。これは、ADS によって返されるメザニン広告 URL についても同様です。そうではない場合、MediaTailor はコンテンツオリジンからの広告の取得とマニフェストへのステッチに失敗します。 1. (必要に応じて DASH に使用するオプション) MediaTailor マニフェストへのアクセスに CDN ルーティングルールをセットアップしており、クライアント側のレポートを使用している、またはプレイヤーがスティッキー HTTP リダイレクトをサポートする場合は、**[Location]** (ロケーション) に **[DISABLED]** (無効) を選択します。 **[Location]** (ロケーション) 機能の詳細については、「[DASH のロケーション機能](dash-location-feature.md)」を参照してください。 1. (オプション) オリジンサーバーがシングルピリオド DASH マニフェストを生成する場合は、**[DASH mpd manifest origin type]** (DASH mpd マニフェストオリジンタイプ)、**[SINGLE\$1PERIOD]** の順に選択します。デフォルトで、MediaTailor は DASH マニフェストをマルチピリオドマニフェストとして処理します。詳細については、「[MPEG-DASH ソースの統合](manifest-dash.md)」を参照してください。 1. **[Create configuration]** (設定を作成) をクリックします。 AWS Elemental MediaTailor は、設定ページに新しい**設定**を表示します。 ## ステップ 5: 設定をテストする 設定を保存したら、ストリーミングプロトコルに該当する形式の URL を使用してストリームをテストします。 + 例: HLS ``` playback-endpoint/v1/master/hashed-account-id/origin-id/master.m3u8 ``` + 例: DASH ``` playback-endpoint/v1/dash/hashed-account-id/origin-id/manifest.mpd ``` コードの説明は以下のとおりです。 + `playback-endpoint` は、設定を作成したときに AWS Elemental MediaTailor によって生成された固有の再生エンドポイントです。 例 ``` https://777788889999.mediatailor.us-east-1.amazonaws.com ``` + `hashed-account-id` は AWS アカウント ID です。 例 ``` 777788889999 ``` + `origin-id` は、設定を作成したときに付けた名前です。 例 ``` myOrigin ``` + `master.m3u8` または `manifest.mpd` は、テストストリームからのマニフェストの名前とそのファイル拡張子です。これは、[ステップ 4: 設定を作成する](#getting-started-add-mapping) で設定した動画コンテンツソースにマニフェストを付加するときに、マニフェストが完全に識別されるように定義します。 上記の例の値を使用すると、完全な URL は以下のようになります。 + 例: HLS ``` https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8 ``` + 例: DASH ``` https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/myOrigin/manifest.mpd ``` 以下のいずれかの方法でストリームをテストできます。 + 前の例に示したように、スタンドアロンプレイヤーに URL を入力します。 + ユーザー独自のプレイヤー環境でストリームをテストします。 ## ステップ 6: 再生リクエストを に送信する AWS Elemental MediaTailor AWS Elemental MediaTailorから渡された設定の再生エンドポイントに再生リクエストを送信するように、ダウンストリームプレーヤーまたは CDN を設定します。[ステップ 3: ADS リクエスト URL とクエリパラメータを設定する](#getting-started-configure-request) で ADS リクエスト URL に使用したプレイヤー定義の動的変数は、いずれもプレイヤーからのマニフェストリクエスト内で定義される必要があります。 **Example** 以下がテンプレートの ADS URL であるとします。 ``` https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=[session.id]&cust_params=[player_params.cust_params] ``` 次に、キーと値のペアに、ADS ではなくオリジンサーバー`ads.`に先行しない `ads.`. AWS Elemental MediaTailor passes パラメータをプレフィックスにして、プレイヤーリクエスト`[player_params.cust_params]`で を定義します。 プレイヤーリクエスト URL は以下の HLS と DASH 例のバリエーションになります。 ``` https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8?ads.cust_params=viewerinfo ``` ``` https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/myOrigin/manifest.mpd?ads.cust_params=viewerinfo ``` がプレイヤーリクエスト AWS Elemental MediaTailor を受け取ると、リクエスト内の情報に基づいてプレイヤー変数を定義します。結果として得られる ADS リクエスト URL は、このバリエーションになります。 ``` https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=&cust_params=viewerinfo ``` ADS に渡すキーバリューペアの設定に関する詳細については、「[ADS リクエストの MediaTailor 動的広告変数](variables.md)」を参照してください。 ## ステップ 7 (オプション): AWS Elemental MediaTailor アクティビティをモニタリングする Amazon CloudWatch と Amazon CloudWatch Logs を使用して、リクエスト数、エラー数、入力された広告表示数などの AWS Elemental MediaTailor アクティビティを追跡します。 で CloudWatch を初めて使用する場合は AWS Elemental MediaTailor、サービス間の通信を許可する AWS Identity and Access Management (IAM) ロールを作成します。 **CloudWatch AWS Elemental MediaTailor へのアクセスを許可するには (コンソール)** 1. IAM コンソール ([https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)) を開きます。 1. IAM コンソールのナビゲーションペインで、**[Roles]** (ロール)、**[Create role]** (ロールを作成) の順に選択します。 1. **別の AWS アカウント**ロールタイプを選択します。 1. **アカウント ID** に ID を入力します AWS アカウント 。 1. [**Require external ID (外部 ID を必須にする)**] を選択し、「**midas**」と入力します。このオプションにより、リクエストに正しい `sts:ExternalID` が含まれている場合にのみサービスがロールを引き受けることができるという条件が、信頼ポリシーに自動的に追加されます。 1. **[Next: Permissions]** (次のステップ: 許可) を選択します。 1. このロールが実行できるアクションを指定するアクセス許可ポリシーを追加します。以下のいずれかのオプションを選択した後、[**Next: Review (次へ: 確認)**] を選択します。 + Amazon CloudWatch Logs への完全なアクセス権を付与するための **CloudWatchLogsFullAccess** + Amazon CloudWatch への完全なアクセス権を付与するための **CloudWatchFullAccess** 1. [**ロール名**] に「**MediaTailorLogger**」と入力し、[**ロールの作成**] を選択します。 1. [**ロール**] ページで、作成したロールを選択します。 1. 信頼関係を編集してプリンシパルを更新します。 1. ロールの [**Summary (概要)**] ページで、[**Trust relationship (信頼関係)**] タブを選択します。 1. [**Edit trust relationship (信頼関係の編集)**] を選択します。 1. ポリシードキュメントで、プリンシパルを AWS Elemental MediaTailor サービスに変更します。以下のようになります。 ``` "Principal": { "Service": "mediatailor.amazonaws.com" }, ``` ポリシー全体は以下のようになります。 1. **信頼ポリシーの更新** を選択します。 ## ステップ 8: クリーンアップする 余分な料金が発生しないように、不要な設定をすべて削除します。 **設定を削除するには (コンソール)** 1. AWS Elemental MediaTailor **設定**ページで、次のいずれかを実行します。 + 削除する設定の [**設定名**] を選択します。 + [**設定名**] 列でラジオボタンを選択してから、[**Delete (削除)**] を選択します。 1. [**設定の削除**] 確認ボックスに **Delete** と入力し、もう一度 [**Delete (削除)**] を選択します。 AWS Elemental MediaTailor は設定を削除します。