プリフェッチスケジュールの作成 - AWS Elemental MediaTailor

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

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

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

注記

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

使用可能な一致基準

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

プリフェッチスケジュールのプレイヤー変数

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

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

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

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

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

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

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

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

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

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

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

        POST <mediatailorURL>/v1/session/<hashed-account-id>/<origin-id>/<asset-id>
{
    'streamId': 'myStreamId'
}
      表示を増やす表示を減らす

  5. プリフェッチタイプでは、選択を行い、対応するセクションを選択して、追加のフィールドについてサポートします。

    • イベントで 1 つの広告時間枠に 1 つのプリフェッチスケジュールを作成する場合は、Single を選択します。

    • イベントの各広告ブレークの前に広告を自動的にプリフェッチするスケジュールを作成する場合は、繰り返しを選択します。

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

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

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

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

    • トラフィックシェーピングウィンドウの期間には、MediaTailor が ADS にリクエストを配信する秒数を入力します。詳細については、「シングルプリフェッチスケジュールの取得の説明」を参照してください。

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

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

      • Key には、 などの動的セッション変数キーを入力しますscte.event_id。これには、MediaTailor がサポートする任意の動的変数を使用できます。動的セッション変数の詳細については、「」を参照してくださいセッション変数の使用。

      • [Value] (値) には、my-event などの動的変数値を入力します。

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

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

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

    • [End time] (終了時間) には、MediaTailor がプリフェッチされた広告の広告ブレークへの配置を停止する時刻を入力します。MediaTailor は、この時刻以前に行われるクライアントのマニフェストリクエストのための広告のプリフェッチを試みます。終了時刻は、開始時刻の後、かつ現時点から 1 日未満の時刻にする必要があります。消費時間枠は、取得時間枠と重複させることができます。

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

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

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

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

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

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

  1. 定期的な取得ペインで、使用する取得設定を指定します。これらの設定は、MediaTailor が ADS から広告をプリフェッチするタイミングを決定します。また、ADS へのリクエストに含める動的セッション変数があれば決定します。

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

    • 表示終了後の遅延 には、表示が終了してから次の表示の広告をプリフェッチするまで MediaTailor が待機する秒数を入力します。値を指定しない場合、MediaTailor はデフォルトで遅延なしになります。

    • トラフィックシェーピングウィンドウの期間には、MediaTailor が ADS にリクエストを配信する秒数を入力します。詳細については、「定期的なプリフェッチスケジュールの取得の説明」を参照してください。

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

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

      • Key には、 などの動的セッション変数キーを入力しますscte.event_id。これには、MediaTailor がサポートする任意の動的変数を使用できます。動的セッション変数の詳細については、「」を参照してくださいセッション変数の使用。

      • [Value] (値) には、my-event などの動的変数値を入力します。

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

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

    • 取得済み広告の有効期限については、取得済み広告を挿入できる期間を指定します。

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

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

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