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

# 広告ブレーク抑制による広告ブレーク動作のカスタマイズ
<a name="ad-rules"></a>

で設定を作成するときに AWS Elemental MediaTailor、広告ブレークの抑制を設定する機能など、広告ブレークの動作を管理するオプションの広告ブレーク設定を指定できます。これにより、特定の要件を満たすように動画コンテンツの広告ブレークエクスペリエンスを調整できます。

**互換性の制限**  
以下では広告ブレーク抑制を使用できません。
+  VOD および live-to-VOD ワークフロー。ライブワークフローのみがサポートされています。
+ サーバーガイド広告挿入 (SGAI) メソッド。サーバーガイド方式は広告決定を異なる方法で処理し、抑制設定を必要としません。

**Topics**
+ [広告ブレーク抑制の設定](#ad-suppression)

## 広告ブレーク抑制の設定
<a name="ad-suppression"></a>

ライブコンテンツ用の広告ブレークのパーソナライゼーションをスキップするように MediaTailor を設定できます。これは、*広告ブレーク抑制*、または*表示抑制*と呼ばれます。このトピックでは、 の使用方法と、広告時間枠抑制の設定の仕組みについても説明します。

広告ブレーク抑制は、次のユースケースに使用できます。
+ **長いマニフェストルックバックウィンドウ** - 視聴者がマニフェストのライブエッジで再生を開始するが、ルックバックウィンドウが長いという場合は、視聴者による視聴の開始後のみに広告を挿入することが推奨されます。または、マニフェストのルックバックウィンドウ全体の一部に広告を挿入します。広告抑制は、MediaTailor がライブエッジより前の指定時間、または指定時間範囲内の広告ブレークをパーソナライズするように設定できます。
+ **ブレーク中の参加** – 視聴者が広告ブレークの途中でライブビデオストリームの視聴を開始した場合、そのユーザーはチャネルを変更して広告を視聴しない可能性が高くなります。広告抑制を使用すると、視聴者がストリームに参加する前に広告時間枠が開始された場合に、広告時間枠のパーソナライズをスキップできます。

### 広告抑制の設定
<a name="working-with-ad-suppression"></a>

広告抑制を使用するには、次の方法で **avail 抑制モード**、**avail 抑制値**、**avail 抑制フィルポリシー**を設定します。
+ MediaTailor コンソールで
+  AWS Command Line Interface (AWS CLI) の使用
+ MediaTailor API を使用するか、クライアントの再生セッションリクエストのパラメータとして使用する

パラメータを使用した設定の詳細については、「」を参照してください[広告抑制パラメータの設定 – 再生セッションリクエスト](#configuring-ad-suppression-parameters-playback-session-request)。

#### 広告抑制設定パラメータ
<a name="ad-suppression-configuration-parameters"></a>

広告抑制のオンとオフを選択できます。広告抑制を有効にする場合は、その抑制がライブ再生エッジの後か、ライブストリームのライブ再生エッジの前かを指定します。いずれの場合も、MediaTailor が広告をパーソナライズしないライブエッジを基準にした時間も指定します。表示抑制を有効にすると、セッションが中断の途中で開始したときに MediaTailor が部分的な広告ブレークフィルに使用する表示抑制ポリシーを指定できます。

広告抑制の設定パラメータは次のとおりです。
+ **[Avail suppression mode]** (Avail 抑制モード) – 広告抑制モードを設定します。広告抑制は、デフォルトで無効になっています。**使用できる値**: `OFF`、`BEHIND_LIVE_EDGE`、または `AFTER_LIVE_EDGE`。
  + `OFF`: 広告抑制はなく、MediaTailor はすべての広告ブレークをパーソナライズします。
  + `BEHIND_LIVE_EDGE`: MediaTailor は、ライブエッジより前に開始する広告ブレークを、**Avail 抑制値を**引いてパーソナライズしません。これは、個々の広告表示だけでなく、広告時間枠全体に影響します。
  + `AFTER_LIVE_EDGE`: MediaTailor は、ライブエッジ内の広告ブレークに **Avail 抑制値**を加えたパーソナライズを行いません。これは、広告時間枠全体に影響を与えるか、広告表示の部分的なフィルを許可するように設定できます。
+ **Avail suppression value** (Avail 抑制値) – ライブストリーム内のライブエッジに相対する時間。**使用できる値**: `HH:MM:SS` 形式の時間値。
+ **Avail suppression fill policy** – MediaTailor が **Avail suppression モード**に適用するポリシー を定義します。**許容値**: `PARTIAL_AVAIL`、`FULL_AVAIL_ONLY`。
  + `BEHIND_LIVE_EDGE` モードは常に`FULL_AVAIL_ONLY`抑制ポリシーを使用します。
  + `AFTER_LIVE_EDGE` モードを使用すると、セッションがブレークの途中で開始したときに`PARTIAL_AVAIL`広告ブレークフィルを呼び出すことができます。

#### 広告抑制設定の例
<a name="ad-suppression-settings-examples"></a>

[広告抑制設定パラメータ](#ad-suppression-configuration-parameters)が相互にやり取りする方法により、ライブストリームのライブエッジの前、とき、または後に広告抑制と表示フィルを処理するいくつかの異なる方法を指定できます。このセクションでは、これらのやり取りの一部を示す例を示します。これらの例を使用して、特定の状況の設定パラメータを設定します。

以下は、広告抑制設定の例です。

**Example 1: 広告抑制なし**  
**表示抑制モード**が の場合`OFF`、広告抑制はなく、MediaTailor はすべての広告ブレークをパーソナライズします。  
次の図では、さまざまなブロックが、左から右に進行するタイムラインに沿って水平に配置されています。各ブロックは、ライブストリームまたはパーソナライズされた広告ブレークのコンテンツが再生される時間の一部を表します。点線は、ライブストリームの現在のライブエッジを表します。ライブエッジの前に 2 つの広告ブレークが発生し、ライブエッジで別の広告ブレークが進行中です。図に示すように、表示抑制モードが の場合`OFF`、MediaTailor はタイムラインのライブエッジの前に発生するすべての広告ブレークをパーソナライズします。MediaTailor は、ライブエッジで進行中の広告ブレークもパーソナライズします。  

![\[表示抑制モードを に設定して MediaTailor 広告ブレークのパーソナライゼーションを行いますOFF。\]](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/images/no_ad_suppression.png)


**Example 2: ライブエッジと同期した値を持つ`BEHIND_LIVE_EDGE`広告抑制**  
**avail 抑制モード**が に設定`BEHIND_LIVE_EDGE`され、**avail 抑制値が** に設定されている場合`00:00:00`、avail 抑制値はライブエッジと同期されます。MediaTailor は、ライブエッジまたはその前に開始される広告ブレークをパーソナライズしません。  
次の図では、さまざまなブロックが、左から右に進行するタイムラインに沿って水平に配置されています。各ブロックは、ライブストリームのコンテンツ、パーソナライズされた広告時間枠、またはパーソナライズされていない広告時間枠が再生される時間の一部を表します。点線は、ライブストリームの現在のライブエッジを表します。に設定された表示抑制値を表す別の点線は`00:00:00`、ライブエッジの点線と重複しています。ライブエッジの前に 2 つの広告ブレークが発生し、ライブエッジの後に別の広告ブレークが発生します。図に示すように、avail 抑制モードを に設定し`BEHIND_LIVE_EDGE`、avail 抑制値を に設定`00:00:00`してライブエッジと同期させると、MediaTailor はタイムラインのライブエッジの前に発生する広告ブレークをパーソナライズしません。MediaTailor は、ライブエッジの*後に*発生する広告ブレークをパーソナライズします。  

![\[MediaTailor 広告ブレークのパーソナライゼーション。avail 抑制モードを に設定BEHIND_LIVE_EDGEし、avail 抑制値を に設定します00:00:00。\]](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/images/ad_supp_value_sync_live_edge.png)


**Example 3: ライブエッジの背後にある値を持つ`BEHIND_LIVE_EDGE`広告抑制**  
**表示抑制モード**が に設定されている場合`BEHIND_LIVE_EDGE`、MediaTailor はその時間以前に広告時間枠をパーソナライズしません。この例では、MediaTailor はライブエッジから最大 45 分遅れて開始する広告ブレークをパーソナライズします。MediaTailor *は、ライブエッジから 45 分以上遅れて開始する広告ブレークを*パーソナライズしません。  
次の図では、さまざまなブロックが、左から右に進行するタイムラインに沿って水平に配置されています。各ブロックは、ライブストリームのコンテンツ、パーソナライズされた広告時間枠、またはパーソナライズされていない広告時間枠が再生される時間の一部を表します。点線は、ライブストリームの現在のライブエッジを表します。に設定された表示抑制値を表す別の点線は、ライブエッジの点線に関してタイムラインの 45 分前に`00:45:00`発生します。点線の間の 45 分間は、表示抑制期間を表します。広告時間枠は、表示抑制期間の開始時に進行中です。その他の 2 つの広告時間枠は、表示抑制期間中に発生します。図に示すように、表示抑制モードを に設定し`BEHIND_LIVE_EDGE`、表示抑制値をライブエッジの`00:45:00`背後に設定すると、MediaTailor は表示抑制期間内に発生した広告ブレークをパーソナライズします。MediaTailor *は、表示抑制期間の開始時に進行中の広告ブレークを*パーソナライズしません。  

![\[MediaTailor 広告ブレークのパーソナライゼーション。avail 抑制モードを に設定BEHIND_LIVE_EDGEし、avail 抑制値を に設定します00:45:00。\]](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/images/ad_supp_value_offset_live_edge.png)


**Example 4: 表示抑制期間中に`AFTER_LIVE_EDGE`広告中断が発生しない広告抑制**  
**avail 抑制モード**が に設定`AFTER_LIVE_EDGE`され、**avail 抑制値が** 0 より大きい場合、MediaTailor はセッションの経過時間がその値に達するまで広告ブレークをパーソナライズしません。  
次の図では、さまざまなブロックが、左から右に進行するタイムラインに沿って水平に配置されています。各ブロックは、ライブストリームまたはパーソナライズされた広告ブレークのコンテンツが再生される時間の一部を表します。点線は、ライブストリームの現在のライブエッジを表します。に設定された表示抑制値を表す別の点線は、ライブエッジの点線に関してタイムラインの 30 分後に`00:30:00`発生します。セッションの初期化を表す 3 番目の点線は、ライブエッジの点線に関してタイムラインの前半で発生します。ライブエッジ時間と avail-suppression-value 時間の間の 30 分の期間は、avail 抑制期間を表します。広告時間枠は、表示抑制期間の後に発生します。図に示すように、avail 抑制モードが に設定されている場合`AFTER_LIVE_EDGE`、avail 抑制値はライブエッジ`00:30:00`の後に に設定され、セッションの初期化はライブエッジの前に行われます。MediaTailor は、avail 抑制期間*後に*発生する広告ブレークをパーソナライズします。  

![\[MediaTailor 広告ブレークのパーソナライゼーション。avail 抑制モードを に設定しAFTER_LIVE_EDGE、avail 抑制値を に設定し00:30:00、ライブエッジの前にセッションを初期化します。\]](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/images/ad_supp_after_no_ad_break.png)


**Example 5: `PARTIAL_AVAIL` フィルポリシーによる`AFTER_LIVE_EDGE`広告抑制と、表示抑制期間の終了時に進行中の広告ブレーク**  
**avail 抑制モード**が に設定`AFTER_LIVE_EDGE`され、**avail 抑制値が** 0 より大きい場合、MediaTailor はセッションの経過時間がその値に達するまで広告ブレークをパーソナライズしません。  
次の図では、さまざまなブロックが、左から右に進行するタイムラインに沿って水平に配置されています。各ブロックは、ライブストリームのコンテンツ、パーソナライズされた広告時間枠、またはパーソナライズされていない広告時間枠が再生される時間の一部を表します。点線は、ライブストリームの現在のライブエッジを表します。に設定された表示抑制値を表す別の点線は、ライブエッジの点線に関してタイムラインの 30 分後に`00:30:00`発生します。セッションの初期化を表す 3 番目の点線は、ライブエッジの点線に関してタイムラインの前半で発生します。ライブエッジ時間と avail-suppression-value 時間の間の 30 分の期間は、avail 抑制期間を表します。広告時間枠は、表示抑制期間の終了時に進行中です。図に示すように、avail 抑制モードが に設定されている場合`AFTER_LIVE_EDGE`、avail 抑制値はライブエッジ`00:30:00`の後に に設定され、avail 抑制フィルポリシーは に設定され`PARTIAL_AVAIL`、セッションの初期化はライブエッジの前に行われます。MediaTailor は、avail 抑制期間*後に*発生する広告ブレークをパーソナライズします。表示抑制期間の終了時に進行中の広告ブレークの場合、MediaTailor は表示抑制期間の*後に*発生する広告ブレークの部分をパーソナライズしますが、**表示抑制期間中に発生する広告ブレークの部分はパーソナライズしません。  

![\[avail 抑制モードを に設定しAFTER_LIVE_EDGE、avail 抑制値を に設定し00:30:00、avail 抑制フィルポリシーを に設定しPARTIAL_AVAIL、ライブエッジの前にセッション初期化を行い、avail 抑制期間の終了時に広告ブレークが進行中の MediaTailor 広告ブレークパーソナライゼーション。\]](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/images/ad_supp_after_ending_ad_break.png)


**Example 6: `PARTIAL_AVAIL`フィルポリシーによる`AFTER_LIVE_EDGE`広告抑制と、セッションの初期化前から表示抑制期間終了後まで進行中の広告ブレーク**  
**avail 抑制モード**が に設定`AFTER_LIVE_EDGE`され、**avail 抑制値が** 0 より大きい場合、MediaTailor はセッションの経過時間がその値に達するまで広告ブレークをパーソナライズしません。  
次の図では、さまざまなブロックが、左から右に進行するタイムラインに沿って水平に配置されています。各ブロックは、ライブストリームのコンテンツ、パーソナライズされた広告時間枠、またはパーソナライズされていない広告時間枠が再生される時間の一部を表します。点線は、ライブストリームの現在のライブエッジを表します。に設定された表示抑制値を表すもう 1 つの点線は`00:30:00`、ライブエッジの点線に関してタイムラインの 30 分後に発生します。セッションの初期化を表す 3 番目の点線は、ライブエッジの点線に関してタイムラインの早い段階で発生します。ライブエッジ時間と avail-suppression-value 時間の間の 30 分の期間は、avail 抑制期間を表します。広告ブレークは、セッションの初期化前から表示抑制期間の後まで進行中です。図に示すように、avail 抑制モードが に設定されている場合`AFTER_LIVE_EDGE`、avail 抑制値はライブエッジ`00:30:00`の後に に設定され、avail 抑制フィルポリシーは に設定され`PARTIAL_AVAIL`、セッションの初期化はライブエッジの前に行われます。MediaTailor は、avail 抑制期間*後に*発生する広告ブレークをパーソナライズします。表示抑制期間の前後に進行中の広告ブレークの場合、MediaTailor は表示抑制期間の*後に*発生する広告ブレークの部分をパーソナライズしますが、表示抑制期間の*前後**に*発生する広告ブレークの部分はパーソナライズしません。  

![\[MediaTailor 広告ブレークパーソナライゼーションでは、avail 抑制モードを に設定しAFTER_LIVE_EDGE、avail 抑制値を に設定し00:30:00、avail 抑制フィルポリシーを に設定しPARTIAL_AVAIL、ライブエッジの前にセッションの初期化を行い、avail 抑制期間の前、最中、後に広告ブレークを進行中にします。\]](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/images/ad_supp_after_ad_break_throughout.png)


**Example 7: 表示抑制期間の開始時に`AFTER_LIVE_EDGE`広告ブレークが進行中の広告抑制**  
**avail 抑制モード**が に設定`AFTER_LIVE_EDGE`され、**avail 抑制値が** 0 より大きい場合、MediaTailor はセッションの経過時間がその値に達するまで広告ブレークをパーソナライズしません。  
次の図では、さまざまなブロックが、左から右に進行するタイムラインに沿って水平に配置されています。各ブロックは、ライブストリームまたはパーソナライズされていない広告時間枠のコンテンツが再生される時間の一部を表します。点線は、ライブストリームの現在のライブエッジを表します。に設定された表示抑制値を表すもう 1 つの点線は`00:30:00`、ライブエッジの点線に関してタイムラインの 30 分後に発生します。セッションの初期化を表す 3 番目の点線は、ライブエッジの点線に関してタイムラインの早い段階で発生します。ライブエッジ時間と avail-suppression-value 時間の間の 30 分の期間は、avail 抑制期間を表します。広告ブレークは、セッションの初期化前の時点から表示抑制期間内の時点まで進行中です。図に示すように、avail サプレッションモードが に設定されている場合`AFTER_LIVE_EDGE`、avail サプレッション値はライブエッジの`00:30:00`後に に設定され、セッションの初期化はライブエッジ時間より前ですが、広告ブレークの開始後に行われるため、MediaTailor はその広告ブレークをパーソナライズしません。  

![\[MediaTailor 広告ブレークパーソナライゼーションでは、avail 抑制モードを に設定しAFTER_LIVE_EDGE、avail 抑制値を に設定し00:30:00、セッションの初期化はライブエッジの前に発生し、広告ブレークは、avail 抑制期間前から終了まで進行中です。\]](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/images/ad_supp_after_beginning_ad_break.png)


#### 広告抑制パラメータの設定 – 再生セッションリクエスト
<a name="configuring-ad-suppression-parameters-playback-session-request"></a>

広告抑制は、MediaTailor に対するサーバー側またはクライアント側の*最初の*再生セッションリクエスト内のパラメータを使用して設定できます。MediaTailor コンソールまたは AWS Elemental MediaTailor API を介して広告抑制設定を既に設定している場合、これらのパラメータはそれらの設定を上書きします。

広告抑制を機能させるには、avail 抑制モードと avail 抑制値の両方が必要です。これらのパラメータを異なるソースから設定することはできません。例えば、MediaTailor コンソールで 1 つのパラメータを設定し、クエリパラメータで別のパラメータを設定することはできません。

MediaTailor は、以下の広告抑制パラメータをサポートします。


| 名前 | 説明 | 使用できる値 | 
| --- | --- | --- | 
| availSuppressionMode |  広告抑制のモードを設定します。デフォルトでは、広告抑制は です`OFF`。に設定すると`BEHIND_LIVE_EDGE`、MediaTailor は広告時間枠を`aws.availSuppressionValue`時間外に埋めません。に設定すると`AFTER_LIVE_EDGE`、MediaTailor は表示抑制期間の前後の広告時間枠を埋めません。表示抑制期間は、ライブエッジ時間から`aws.availSuppressionValue`時間、および追加のバッファ時間までです。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/ad-rules.html)  | 
| availSuppressionValue | ライブストリームのライブエッジからの相対的な時間。 | の UTF-8 URL エンコードされたタイムコードHH:MM:SS。例えば、1 時間と 30 分は 01%3A30%3A00 になります。 | 
| availSuppressionFillPolicy | avail 抑制モードに適用するポリシーを定義します。 BEHIND\$1LIVE\$1EDGEは常に完全な avail 抑制ポリシーを使用します。 AFTER\$1LIVE\$1EDGE は、セッションが中断の途中で開始したときに部分的な広告ブレークフィルを呼び出すために使用できます。 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/ad-rules.html)  | 

##### サーバー側の設定
<a name="server-side-query"></a>

基本となるクエリパラメータは `aws.availSuppression` で、その後にオプションのパラメータ名と値のペアが続きます。クエリを作成するには、MediaTailor に対する再生セッションリクエストの最後に `aws.availSuppression=` を付加し、その後にパラメータ名と値を追加します。サーバー側の再生セッションリクエストを作成する方法の詳細については、「[MediaTailor サーバー側の広告の追跡とレポート](ad-reporting-server-side.md)」を参照してください。

**例**: HLS

```
GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/index.m3u8?aws.availSuppressionMode=BEHIND_LIVE_EDGE&aws.availSuppressionValue=00%3A00%3A21
```

以下の表は、サーバー側のクエリ構文のリストです。


| クエリ文字列コンポーネント | 説明 | 
| --- | --- | 
| ? | クエリの先頭を示す制限された文字。 | 
| aws. | 名前と値のペアで構成されたパラメータが続くベースクエリ。すべての使用可能なパラメータのリストについては、「[広告抑制パラメータの設定 – 再生セッションリクエスト](#configuring-ad-suppression-parameters-playback-session-request)」を参照してください。 | 
| = | パラメータ名を値に関連付けます。例えば、aws.availSuppressionMode=BEHIND\$1LIVE\$1EDGE などです。 | 
| & | クエリパラメータを連結します。例えば、aws.availSuppressionMode=BEHIND\$1LIVE\$1EDGE および aws.availSuppressionValue=00:30:00&aws.availSuppressionFillPolicy=FULL\$1AVAIL\$1ONLY> などです。 | 

##### クライアント側の設定
<a name="client-side-configuration"></a>

MediaTailor に対するクライアントの POST リクエストに `availSuppression` パラメータを含めます。クライアント側の再生セッションリクエストを作成する方法の詳細については、「[クライアント側の広告追跡](ad-reporting-client-side.md)」を参照してください。

**例**: HLS

```
POST parent.m3u8
    {
       "availSuppression": {
          "mode": "BEHIND_LIVE_EDGE",
          "value": "00:00:21",
          "fillPolicy": "FULL_AVAIL_ONLY"
       }
    }
```