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

# MediaTailor サーバーガイド広告挿入の概要と実装
<a name="server-guided"></a>

AWS Elemental MediaTailor サーバーガイド広告挿入 (SGAI) は、広告をメディアプレイリストに直接ステッチするのではなく、個別のプレイリストとして参照することで、サーバー側の広告挿入に代わる手段を提供します。このアプローチにより、キャッシュ可能なマニフェストによるパフォーマンスが向上し、スケーラビリティが向上します。

MediaTailor でサーバーガイド広告挿入を使用する方法については、次のリストから該当するトピックを選択してください。

## 再生設定で を有効にする
<a name="enable-in-config"></a>

プレイヤーがサーバーガイド広告挿入を使用できるようにするには、MediaTailor 再生設定`PLAYER_SELECT`で を `Insertion Mode`に設定する必要があります。これにより、プレイヤーはセッション初期化時にステッチまたはガイド付き広告挿入を選択できます。

## サーバーガイドセッションを作成する
<a name="create-guided-session"></a>

再生セッションを作成するときは、ガイドモードを選択します。これを行う方法は、プレイヤーが暗黙的なセッションを使用するか明示的なセッションを使用するかによって異なります。

### 暗黙的に作成されたサーバーガイド付きセッション
<a name="create-implicit-guided-session"></a>

HLS マルチバリアントプレイリストリクエスト`aws.insertionMode=GUIDED`に追加します。例:

```
playback-endpoint/v1/master/hashed-account-id/origin-id/index.m3u8?aws.insertionMode=GUIDED
```

コードの説明は以下のとおりです。
+ `playback-endpoint` は、設定を作成したときに AWS Elemental MediaTailor によって生成された固有の再生エンドポイントです。

  例

  ```
  https://777788889999.mediatailor.us-east-1.amazonaws.com
  ```
+ `hashed-account-id` は AWS アカウント ID です。

  例

  ```
  777788889999
  ```
+ `origin-id` は、設定を作成したときに付けた名前です。

  例

  ```
  myOrigin
  ```
+ `index.m3u8` または は、テストストリームからのマニフェストの名前とそのファイル拡張子です。これは、[ステップ 4: 設定を作成する](getting-started-ad-insertion.md#getting-started-add-mapping) で設定した動画コンテンツソースにマニフェストを付加するときに、マニフェストが完全に識別されるように定義します。

上記の例の値を使用すると、完全な URL は以下のようになります。
+ 例:

  ```
  https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/777788889999/myOrigin/index.m3u8?aws.insertionMode=GUIDED
  ```

### 明示的に作成されたサーバーガイドセッション
<a name="create-explicit-guided-session"></a>

プレイヤーが MediaTailor 設定のセッション初期化プレフィックスエンドポイント`POST`に HTTP で送信する JSON メタデータ`insertionMode=GUIDED`に を追加します。

次の例は、JSON メタデータの構造を示しています。

```
{
  # other keys, e.g. "adsParams"
  "insertionMode": "GUIDED"       # this can be either GUIDED or STITCHED
}
```

この初期化メタデータでは、再生セッションはセラーガイド付き広告挿入を使用します。