

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

# ライブストリームの MediaTailor サーバーガイド広告挿入設定
<a name="sgai-live-configuration"></a>

AWS Elemental MediaTailor ライブコンテンツ用のサーバーガイド広告挿入は、キャッシュ可能なマニフェストを通じてパフォーマンスに大きなメリットをもたらします。ライブコンテンツ用に SGAI を設定すると、VOD と同じコアパラメータが使用されますが、ライブストリームの特性とリアルタイム処理に関する特定の考慮事項があります。

## ライブ SGAI の要件
<a name="sgai-live-requirements"></a>

ライブコンテンツの SGAI を有効にする前に、以下があることを確認してください。
+ ライブストリームに正しくフォーマットされた DATERANGE マーカーが含まれている
+ 広告時間枠の期間は一貫性があり、予測可能です
+ CDN は SGAI マニフェストを適切にキャッシュするように設定されています
+ プレイヤーがサーバーガイドの広告挿入ワークフローをサポート
+ 広告決定サーバーがライブコンテンツのリアルタイムリクエストを処理できる

### プレイヤーの要件
<a name="sgai-live-player-integration"></a>

プレイヤーは、SGAI ライブマニフェストを適切に処理するように設定する必要があります。
+ サーバーガイド広告挿入ワークフローのサポート
+ マニフェストからの広告挿入ガイダンスを処理する機能
+ ライブストリームのタイミングと同期の適切な処理
+ HLS コンテンツの場合: CLASS 属性を使用した HLS バージョン 8 と EXT-X-DATERANGE のサポート。サーバー側のビーコン用のバージョン 11。
+ HLS コンテンツの場合: EXT-X-DEFINE 変数置換のサポート

## ライブ再生設定
<a name="sgai-live-playback-config"></a>

ライブコンテンツの SGAI を有効にするには、以下の設定で再生設定を作成します。

**Example SGAI ライブ再生設定**  

```
{
  "Name": "LiveSGAIConfig",
  "VideoContentSourceUrl": "https://your-live-origin.com/live/stream.m3u8",
  "AdDecisionServerUrl": "https://your-ads.com/ads",
  "PersonalizationThresholdSeconds": 1,
  "InsertionMode": "PLAYER_SELECT"
}
```

以下は、ライブ SGAI 設定に関する重要な考慮事項です。

`VideoContentSourceUrl`  
適切にフォーマットされた SCTE-35 DATERANGE マーカーを持つライブ HLS ストリームを指す必要があります。ストリームは、一貫したセグメント期間とビットレートバリアントを維持する必要があります。

## SGAI ライブマニフェストリクエスト
<a name="sgai-live-manifest-requests"></a>

SGAI ライブマニフェストは、従来の広告挿入と同じ URL パターンを使用します。

```
https://your-config.mediatailor.region.amazonaws.com/v1/master/config-name/manifest.m3u8?aws.insertionMode=GUIDED
```

## ライブ SGAI のマニフェストベースのプリフェッチ
<a name="sgai-live-guided-prefetch"></a>

ライブ SGAI ワークフローでは、マニフェストベースのプリフェッチハートビートを有効にして、広告フィルレイテンシーを減らすことができます。マニフェストリクエスト`aws.guidedPrefetchMode=MANIFEST`に を追加します。

```
https://your-config.mediatailor.region.amazonaws.com/v1/master/config-name/manifest.m3u8?aws.insertionMode=GUIDED&aws.guidedPrefetchMode=MANIFEST
```

有効にすると、MediaTailor はセッション識別子 (`?aws.sessionId=<id>`) をクエリパラメータとして、多変量プレイリストの各インタースティシャルメディアマニフェスト (`/v1/i-media`) URL に追加します。プレイヤーが i メディアマニフェストを更新するたびに、リクエストはセッション ID で MediaTailor に到達します。これは、MediaTailor がセッションを識別し、今後の広告時間枠のプリフェッチリクエストをキューに入れるために使用されます。

**重要**  
**ガイド付きプリフェッチを使用する場合は、i メディアマニフェストを CDN にキャッシュしないでください。**プリフェッチハートビートメカニズムは、MediaTailor に直接到達するプレイヤーのマニフェスト更新リクエストによって異なります。CDN がキャッシュして`/v1/i-media`レスポンスを提供する場合、MediaTailor はハートビートリクエストを受信せず、プリフェッチをトリガーできません。`aws.guidedPrefetchMode=MANIFEST` が使用中のときに MediaTailor に`/v1/i-media/*`リクエストを渡すように CDN を設定します。

ガイド付きプリフェッチは、レポートモードから独立しています。サーバー側 (デフォルト) 追跡とクライアント側 (`aws.reportingMode=CLIENT`) 追跡のどちらを使用する場合でも、ビーコンは広告がプリフェッチされたときではなく再生時に発生します。MediaTailor での広告プリフェッチの仕組みに関する一般的な情報については、「」を参照してください[広告のプリフェッチ](prefetching-ads.md)。

## SGAI ライブ設定のテスト
<a name="sgai-live-testing"></a>

SGAI ライブセットアップを以下の検証ステップで検証します。

1. **テストマニフェストの生成**

   SGAI ライブマニフェスト URL をリクエストし、適切な広告挿入ガイダンスを使用してキャッシュ可能なコンテンツを返すことを確認します。

1. **CDN キャッシュの検証**

   CDN が設定された TTL 値に従って SGAI マニフェストをキャッシュしていることを確認します。

1. **広告挿入をテストする**

   SGAI マニフェストで提供されているガイダンスを使用して、プレイヤーが広告を正常に挿入できることを確認します。

1. **パフォーマンスのモニタリング**

   CloudWatch メトリクスを使用して、オリジン負荷の低減とキャッシュヒット率の向上を検証します。