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

# プリフェッチスケジュールの作成
<a name="creating-prefetch-schedules"></a>

以下は、MediaTailor コンソールを使用してプリフェッチスケジュールを作成する方法を説明する手順です。MediaTailor API を使用してプログラムでプリフェッチスケジュールを作成および管理する方法の詳細については、 *AWS Elemental MediaTailor API リファレンス*の[PrefetchSchedules](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PrefetchSchedule.html)」を参照してください。

**注記**  
MediaTailor でプリフェッチスケジュールを設定するときは、さまざまなタイプの変数がどのように処理されるかを理解することが重要です。  

**利用可能な一致基準**  
スケジュールで avail マッチング基準を使用する場合は、まず再生設定の ADS URL テンプレートを[動的セッション変数](variables-session.md)で設定してください。そうしないと、 avail マッチング基準は効果がありません。動的セッション変数の操作については、MediaTailor [ステップ 3: ADS リクエスト URL とクエリパラメータを設定する](getting-started-ad-insertion.md#getting-started-configure-request) 広告挿入の開始方法」トピックの「」を参照してください。

**プリフェッチスケジュールのプレイヤー変数**  
プリフェッチスケジュールを作成するときは、プレイヤー変数をプリフェッチ設定で動的変数として定義しないでください。代わりに、セッション開始時と同じようにプレイヤー変数を渡します。変数が ADS テンプレート URL にマッピングされている場合、MediaTailor はこれらの変数をプリフェッチ広告リクエストに自動的に含めます。

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

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

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

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

1. **[Prefetch schedule details]** (プリフェッチスケジュールの詳細) ペインで、以下を実行します。
   + **[Name]** (名前) には、プリフェッチスケジュールの識別子 (**my-prefetch-schedule** など) を入力します。
   + **[Stream ID]** (ストリーム ID) には、オプションで一意の ID を入力します。オリジンに複数の再生ストリームが含まれている場合は、この ID を使用して、特定のストリームに広告を配置するよう MediaTailor に指示することができます。たとえば、再生設定にスポーツストリームとテレビ番組ストリームがある場合、ストリーム ID を使用してプリフェッチスケジュールを作成し、スポーツストリームを対象とした広告を挿入できます。ストリーム ID 値は、クライアントのセッション開始またはマニフェストリクエストで MediaTailor に渡します。詳細については、以下の例を参照してください。
     + *サーバー側の追跡*の場合は、MediaTailor エンドポイントに対するクライアントの `GET HTTP` リクエストに `?aws.streamId` クエリパラメータと値を含めます。サーバー側の追跡に関する一般情報については、「[MediaTailor サーバー側の広告の追跡とレポート](ad-reporting-server-side.md)」を参照してください。ストリーム ID が含まれた HLS エンドポイントに対するマニフェストリクエストは以下のようになります。`myStreamId` はストリーム ID の名前です。

       ```
       GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.streamId=myStreamId
       ```
     + *クライアント側の追跡*の場合は、**MediaTailor /v1/Session** エンドポイントに対するクライアントの `POST HTTP` セッション開始リクエストボディに `streamId` キーと値を含めます。クライアント側の追跡に関する一般情報については、「[クライアント側の広告追跡](ad-reporting-client-side.md)」を参照してください。ストリーム ID が含まれたセッション開始リクエストは以下のようになります。`myStreamId` はストリーム ID の名前です。

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

1. **プリフェッチタイプ**では、選択し、対応するセクションを選択して、追加のフィールドについてサポートします。
   + イベントで 1 つの広告時間枠に対して 1 つのプリフェッチスケジュールを作成する場合は、**シングル** を選択します。
   + イベントの各広告ブレークの前に広告を自動的にプリフェッチするスケジュールを作成する場合は、**繰り返し**を選択します。

## 単一のプリフェッチスケジュール
<a name="single-prefetch"></a>

イベントで 1 つの広告表示の前に広告をプリフェッチするスケジュールを作成するには。

1. **[Retrieval]** (取得) ペインで、使用する取得設定を指定します。これらの設定は、MediaTailor が ADS から広告をプリフェッチするタイミングを決定します。また、ADS へのリクエストに含める動的セッション変数があれば決定します。
   + **[Start time]** (開始時間) には、MediaTailor がこの広告ブレーク用のプリフェッチ取得を開始できる時刻を入力します。MediaTailor は、この時刻以降にクライアントによって行われるマニフェストリクエストのための広告のプリフェッチを試みます。デフォルト値は現在の時刻です。値を指定しない場合、サービスは可能な限り速やかにプリフェッチ取得を開始します。
   + **[End time]** (終了時間) には、MediaTailor がこの広告ブレーク用のプリフェッチ取得を停止する時刻を入力します。MediaTailor は、この時刻以前に行われるマニフェストリクエストのための広告のプリフェッチを試みます。取得時間枠は、消費時間枠と重複させることができます。
   + 必要に応じて、一度に ADS へのリクエスト数を制限するようにトラフィックシェーピングを設定します。次のいずれかのアプローチを選択します。

     *タイムウィンドウアプローチ*: **トラフィックシェーピングウィンドウ期間**には、MediaTailor が ADS にリクエストを配信する秒数を入力します。詳細については、[「シングルプリフェッチスケジュールの取得の説明](understanding-prefetching.md#avail-matching-criteria-retr)」を参照してください。

     *TPS ベースのアプローチ*: **ピーク TPS** と**ピーク同時ユーザー**を設定し、1 秒あたりのトランザクションと同時ユーザーに基づいてリクエストを制限します。詳細については、「[TPS ベースのトラフィックシェーピング](tps-traffic-shaping.md)」を参照してください。
   + [**動的変数**](variables.md) セクションに、最大 100 個の動的セッション変数を入力します。MediaTailor は、ADS に送信するプリフェッチリクエストでの代入にこれらの変数を使用します。動的セッション変数を入力しない場合、MediaTailor は [ADS URL ](configurations-create.md#configurations-create-main)に含まれる動的変数の値を補間するよう最善を尽くします。
     + **[Add dynamic variable]** (動的変数を追加) をクリックします。
     + Key には****、 などの動的セッション変数キーを入力します`scte.event_id`。これには、MediaTailor がサポートする任意の動的変数を使用できます。動的セッション変数の詳細については、「」を参照してください[ADS リクエストの MediaTailor セッション変数](variables-session.md)。
     + **[Value]** (値) には、*my-event* などの動的変数値を入力します。
     + 別の動的変数を追加するには、**[Add dynamic variable]** (動的変数を追加) をクリックします。

1. **[Consumption]** (消費) ペインで、消費時間枠に使用する設定を指定します。これらの設定は、MediaTailor が広告ブレークに広告を配置するタイミングを決定します。また、使用する avail 使用条件も決定します。
   + **[Start time]** (開始時間) には、MediaTailor がプリフェッチされた広告の広告ブレークへの配置を開始する時刻を入力します。デフォルト値は現在の時刻です。時刻を指定しない場合、サービスは可能な限り速やかにプリフェッチ消費を開始します。
   + **[End time]** (終了時間) には、MediaTailor がプリフェッチされた広告の広告ブレークへの配置を停止する時刻を入力します。MediaTailor は、この時刻以前に行われるクライアントのマニフェストリクエストのための広告のプリフェッチを試みます。終了時刻は、開始時刻の後、かつ現時点から 1 日未満の時刻にする必要があります。消費時間枠は、取得時間枠と重複させることができます。
   + [**[Avail matching criteria]**](variables.md) (Avail 一致条件) セクションで **[Add avail criteria]** (avail 条件を追加) をクリックし、スケジュールに最大 5 個の avail 一致条件を追加します。その後、**[Dynamic variable key]** (動的変数キー) で、`scte.event_id` などの動的変数キーを追加します。MediaTailor は、クライアントが MediaTailor に渡す動的変数値、または MediaTailor がセッションデータなどの情報から推測する動的変数値で定義された基準を満たしている*場合にのみ*MediaTailor 、プリフェッチされた広告を広告ブレークに配置します。広告時間枠が指定された一致基準を満たしていない場合、MediaTailor はその時間枠のプリフェッチをスキップします。詳細については、[「 Single prefetch schedule consumption explanation](understanding-prefetching.md#avail-matching-criteria)」を参照してください。

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

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

### クライアントが CreatePrefetchSchedule API を呼び出す頻度の決定
<a name="how-often"></a>

広告ブレークが配信される正確なタイミングをユーザーが把握している場合、クライアントは 1 日 1 回 [CreatePrefetchSchedule](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_CreatePrefetchSchedule.html) API をプログラム的に呼び出して、取得と消費をセットアップできます。クライアントは、一日中何度も API を呼び出して、取得と消費を定義することもできます。API コールの頻度を選択するときは、[アクティブなプリフェッチスケジュールの最大数](quotas.md#prefetch-schedules-limit)と、プリフェッチスケジュールの作成後に広告時間枠スケジュールが変更される可能性を考慮してください (複数可）。プリフェッチスケジュールの作成後に広告ブレークスケジュールが変更される可能性が高い場合は、API をより頻繁に呼び出すことをお勧めします。

## 定期的なプリフェッチスケジュール
<a name="recurring-prefetch"></a>

イベントの各広告表示の前に広告をプリフェッチするスケジュールを作成するには。

1. **定期的な取得**ペインで、使用する取得設定を指定します。これらの設定は、MediaTailor が ADS から広告をプリフェッチするタイミングを決定します。また、ADS へのリクエストに含める動的セッション変数があれば決定します。
   + **定期的なプリフェッチウィンドウ**には、MediaTailor がこの広告時間枠のプリフェッチ取得を開始できる時間を入力します。MediaTailor は、この時刻以降にクライアントによって行われるマニフェストリクエストのための広告のプリフェッチを試みます。デフォルト値は現在の時刻です。値を指定しない場合、サービスは可能な限り速やかにプリフェッチ取得を開始します。
   + **表示終了後の遅延**には、次の表示の広告をプリフェッチする前に MediaTailor が表示終了後に待機する秒数を入力します。値を指定しない場合、MediaTailor はデフォルトで遅延なしになります。
   + 必要に応じて、一度に ADS へのリクエスト数を制限するようにトラフィックシェーピングを設定します。次のいずれかのアプローチを選択します。

     *タイムウィンドウアプローチ*: **トラフィックシェーピングウィンドウ期間**には、MediaTailor が ADS にリクエストを配信する秒数を入力します。詳細については、[「定期的なプリフェッチスケジュールの取得の説明](understanding-prefetching.md#avail-matching-criteria-recurring-retr)」を参照してください。

     *TPS ベースのアプローチ*: **ピーク TPS** と**ピーク同時ユーザー**を設定し、1 秒あたりのトランザクションと同時ユーザーに基づいてリクエストを制限します。詳細については、「[TPS ベースのトラフィックシェーピング](tps-traffic-shaping.md)」を参照してください。
   + [**動的変数**](variables.md)セクションには、最大 100 個の動的セッション変数を入力します。MediaTailor は、ADS に送信するプリフェッチリクエストでの代入にこれらの変数を使用します。動的セッション変数を入力しない場合、MediaTailor は [ADS URL ](configurations-create.md#configurations-create-main)に含まれる動的変数の値を補間するよう最善を尽くします。
     + **[Add dynamic variable]** (動的変数を追加) をクリックします。
     + **Key** には、 などの動的セッション変数キーを入力します`scte.event_id`。これには、MediaTailor がサポートする任意の動的変数を使用できます。動的セッション変数の詳細については、「」を参照してください[ADS リクエストの MediaTailor セッション変数](variables-session.md)。
     + **[Value]** (値) には、*my-event* などの動的変数値を入力します。
     + 別の動的変数を追加するには、**[Add dynamic variable]** (動的変数を追加) をクリックします。

1. **[Consumption]** (消費) ペインで、消費時間枠に使用する設定を指定します。これらの設定は、MediaTailor が広告ブレークに広告を配置するタイミングを決定します。また、使用する avail 使用条件も決定します。
   + **取得済み広告の有効期限**については、取得後広告を挿入できる期間を指定します。
   + [**[Avail matching criteria]**](variables.md) (Avail 一致条件) セクションで **[Add avail criteria]** (avail 条件を追加) をクリックし、スケジュールに最大 5 個の avail 一致条件を追加します。その後、**[Dynamic variable key]** (動的変数キー) で、`scte.event_id` などの動的変数キーを追加します。MediaTailor は、クライアントが MediaTailor に渡す動的変数値、または MediaTailor がセッションデータなどの情報から推測する動的変数値で定義された基準を満たしている*場合にのみ*MediaTailor 、プリフェッチされた広告を広告ブレークに配置します。広告時間枠が指定された一致基準を満たしていない場合、MediaTailor はその時間枠のプリフェッチをスキップします。詳細については、[「定期的なプリフェッチスケジュールの消費の説明](understanding-prefetching.md#avail-matching-criteria-recur)」を参照してください。

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

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