プリフェッチスケジュールの作成

次の手順では、 コンソールを使用して MediaTailorプリフェッチスケジュールを作成する方法について説明します。を使用してプログラムPrefetchSchedulesでプリフェッチスケジュールを作成および管理する方法の詳細については MediaTailor API、「」の「」を参照してください。 AWS Elemental MediaTailor API リファレンス 。

注記

スケジュールで avail 一致基準を使用する場合は、まず再生設定のADSURLテンプレートを動的変数 で設定してください。そうしないと、avail 一致基準は効果がありません。動的変数の操作については、ステップ 3: ADSリクエストパラメータURLとクエリパラメータを設定する「広告挿入の開始方法」トピックの MediaTailor「」を参照してください。

コンソールを使用して新しいプリフェッチスケジュールを作成する

1. で MediaTailor コンソールを開きますhttps://console.aws.amazon.com/mediatailor/。

2. ナビゲーションペインで [Configurations] (設定) をクリックします。プリフェッチスケジュールを作成する再生設定を選択します。

3. [Prefetch schedules] (プリフェッチのスケジュール) タブで、[Add prefetch schedule] (プリフェッチスケジュールを追加) をクリックします。

4. [Prefetch schedule details] (プリフェッチスケジュールの詳細) ペインで、以下を実行します。

   • 名前 には、 などのプリフェッチスケジュールの識別子を入力しますmy-prefetch-schedule。

   • [Stream ID] (ストリーム ID) には、オプションで一意の ID を入力します。オリジンに複数の再生ストリームが含まれている場合は、この ID を使用して、特定のストリームに広告を配置 MediaTailor するように に指示できます。例えば、オリジンにスポーツストリームとテレビ番組ストリームがある場合は、ストリーム ID を使用して、スポーツストリームを対象とした広告を挿入するためのプリフェッチスケジュールを作成できます。クライアントのセッション初期化またはマニフェストリクエスト MediaTailor で、ストリーム ID 値を に渡します。詳細については、以下の例を参照してください。

     • サーバー側の追跡の場合、 MediaTailor エンドポイントへのクライアントのGET HTTPリクエストに?aws.streamIdクエリパラメータと値を含めます。サーバー側の追跡に関する一般情報については、「サーバー側の広告追跡」を参照してください。ストリーム ID を含むHLSエンドポイントへのマニフェストリクエストは次のようになります。ここで、 myStreamIdはストリーム ID の名前です。

       GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.streamId=myStreamId

     • クライアント側の追跡 の場合、/MediaTailorv1/session エンドポイントへのクライアントのPOST HTTPセッション初期化リクエスト本文にstreamIdキーと値を含めます。クライアント側の追跡に関する一般情報については、「クライアント側の広告追跡」を参照してください。ストリーム ID が含まれたセッション開始リクエストは以下のようになります。myStreamId はストリーム ID の名前です。

       POST <mediatailorURL>/v1/session/<hashed-account-id>/<origin-id>/<asset-id>
       {
           'streamId': 'myStreamId'
       }

     表示を増やす表示を減らす

5. [Retrieval] (取得) ペインで、使用する取得設定を指定します。これらの設定により、 が から広告を MediaTailor プリフェッチするタイミングが決まりますADS。また、 へのリクエストに含める動的変数があればADS、それも決定します。

   • 開始時刻 には、 がこの広告ブレークのプリフェッチ取得を開始 MediaTailor できる時刻を入力します。 MediaTailor は、この時刻以降にクライアントによって行われたマニフェストリクエストの広告をプリフェッチしようとします。デフォルト値は現在の時刻です。値を指定しない場合、サービスは可能な限り速やかにプリフェッチ取得を開始します。

   • 終了時刻 には、この広告ブレークの広告のプリフェッチを停止 MediaTailor する時刻を入力します。 MediaTailor は、この時刻以前に発生したマニフェストリクエストの広告のプリフェッチを試みます。取得時間枠は、消費時間枠と重複させることができます。

   • 動的変数 セクションには、最大 100 個の動的変数を入力します。 は、 に送信するプリフェッチリクエストでこれらの変数を置き換えるために MediaTailor 使用しますADS。動的変数を入力しない場合、 MediaTailor は、 に含まれる動的変数の値を補間するよう最善を尽くしますADSURL。

     • [Add dynamic variable] (動的変数を追加) をクリックします。

     • [Key] (キー) には、scte.event_id などの動的変数キーを入力します。が MediaTailor サポートする任意の動的変数を使用できます。動的変数については、「での動的広告変数の使用 MediaTailor」を参照してください。

     • 値 には、次のような動的変数値を入力します。my-event.

     • 別の動的変数を追加するには、[Add dynamic variable] (動的変数を追加) をクリックします。

6. [Consumption] (消費) ペインで、消費時間枠に使用する設定を指定します。これらの設定は、広告を広告ブレークにいつ MediaTailor 配置するかを決定します。また、使用する avail 使用条件も決定します。

   • 開始時刻 MediaTailor には、プリフェッチされた広告を広告ブレークに配置し始める時刻を入力します。デフォルト値は現在の時刻です。時刻を指定しない場合、サービスは可能な限り速やかにプリフェッチ消費を開始します。

   • 終了時刻 には、事前にフェッチされた広告を広告ブレークに配置 MediaTailor しないようにする時刻を入力します。 MediaTailor は、この時刻以前に発生したクライアントのマニフェストリクエストの広告をプリフェッチしようとします。終了時刻は、開始時刻の後、かつ現時点から 1 日未満の時刻にする必要があります。消費時間枠は、取得時間枠と重複させることができます。

   • [Avail matching criteria] (Avail 一致条件) セクションで [Add avail criteria] (avail 条件を追加) をクリックし、スケジュールに最大 5 個の avail 一致条件を追加します。次に、動的変数キー で、 などの動的変数キーを追加しますscte.event_id。 MediaTailor は、クライアントが に渡す動的変数値、またはセッションデータなどの情報から MediaTailor 推測する動的変数値で定義された基準を満たしている場合にのみ MediaTailor、プリフェッチされた広告を広告ブレークに配置します。条件については、上記の「avail-matching-criteria」セクションを参照してください。

7. [Add avail criteria] (Avail 条件を追加) をクリックします。

プリフェッチスケジュールは、消費時間枠の終了時間後、自動的に期限が切れます。診断目的では、少なくとも 7 日間表示され、その後 MediaTailor 自動的に削除されます。また、プリフェッチスケジュールはいつでも手動で削除できます。プリフェッチスケジュールを手動で削除する方法については、以下の「プリフェッチスケジュールの削除」セクションを参照してください。

クライアントが を呼び出す頻度の確認 CreatePrefetchSchedule API

広告ブレークが発生する正確なタイミングがわかっている場合、クライアントはプログラムで を 1 日に CreatePrefetchScheduleAPI1 回呼び出して、取得と消費を設定できます。または、クライアントは 1 日を通してAPI何回も を呼び出して、取得と消費を定義できます。API 呼び出し頻度を選択するときは、 MediaTailorのアクティブなプリフェッチスケジュールの最大数 と、プリフェッチスケジュールの作成後に広告ブレークスケジュールが変更される可能性 (複数可) を考慮してください。プリフェッチスケジュールを作成した後に広告ブレークスケジュールが変更される可能性がある場合は、 API をより頻繁に呼び出すことをお勧めします。