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

# オーバーレイ広告
<a name="overlay-ads"></a>

ミッドロール広告の表示エクスペリエンスを中断せずに収益化を増やすライブストリーミングワークフローでは、現在の AWS Elemental MediaTailor 統合を活用して、クライアント側でレンダリングされる広告形式をガイドできます。このタイプの広告は*オーバーレイ広告*と呼ばれます。オーバーレイ広告は、「L バンド広告」、「非線形動画広告」、picture-in-picture広告」、「モーションオーバーレイ」、「インコンテンツ広告」、または「フレーム広告」の形式で表示される非線形動画広告です。

MediaTailor は、オーバーレイ広告挿入の機会の帯域内シグナル`id=0x38`としてセグメンテーションタイプを持つ SCTE-35 マーカーを検出します。SCTE-35 マーカーにより、MediaTailor は広告決定サーバー (ADS) にリクエストを送信し、ADS は VAST レスポンスで非線形広告ペイロードで応答します。MediaTailor は、オーバーレイ広告挿入をサポートするために VAST レスポンスを解析します。MediaTailor はリニア広告のステッチングを実行せず、再生可能な非リニアオーバーレイ広告があることをプレイヤーに通知します。このシグナリングにより、プレイヤーはクライアント側の追跡エンドポイントから再生する非線形広告を取得して関連付けることができます。その後、プレイヤーはそれらの広告に関連する表示、レポート、およびその他のタスクを処理します。たとえば、プレイヤーの開発者は、オーバーレイ広告形式をサポートするベンダーのデバイス SDK を使用できます。クライアント側の追跡統合の詳細については、「」を参照してください[クライアント側の広告追跡統合](ad-reporting-client-side-ad-tracking-integrations.md)。

![\[この画像は、コンテンツビデオとともに表示されるさまざまな広告タイプのタイムラインを示しています。リニア広告は、コンテンツビデオの前後に再生されます。コンテンツビデオの前の広告は、プリロール広告と呼ばれます。コンテンツビデオの後の広告は、ポストロール広告と呼ばれます。非線形広告は、コンテンツビデオ自体の一部と重複します。非線形広告はオーバーレイ広告と呼ばれます。\]](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/images/client-side-overlays.png)


**Topics**
+ [MediaTailor でオーバーレイ広告を使用するための前提条件](overlay-ads-prerequisites.md)
+ [MediaTailor でのオーバーレイ広告の使用開始](overlay-ads-getting-started.md)
+ [MediaTailor でのオーバーレイ広告のログ記録とメトリクス](overlay-ads-logging-and-metrics.md)
+ [MediaTailor でのオーバーレイ広告の請求](overlay-ads-billing.md)

# MediaTailor でオーバーレイ広告を使用するための前提条件
<a name="overlay-ads-prerequisites"></a>

MediaTailor でオーバーレイ広告を使用する場合、次の前提条件が適用されます。
+ ワークフローは、ビデオオンデマンド (VOD) ではなく、ライブである必要があります。
+ 広告決定サーバー (ADS) レスポンスは、VAST レスポンスで非線形広告のみを返すように設定する必要があります。MediaTailor は、広告ステッチングの目的でリニア広告を無視します。
+ マニフェストは、オーバーレイ広告機能を呼び出す`id=0x38`ために、セグメンテーションタイプの SCTE-35 タイムシグナルメッセージを使用する必要があります。
+ ストリーミングプロバイダーは、クライアント/デバイスアプリケーションを制御でき、MediaTailor クライアント側の追跡 API と統合されている必要があります。

# MediaTailor でのオーバーレイ広告の使用開始
<a name="overlay-ads-getting-started"></a>

このセクションでは、MediaTailor の overlay-ads 機能の使用を開始する方法について説明します。SCTE-35 シグナリングの設定、広告決定サーバー (ADS) レスポンスの設定、セッションレベルの制御の設定を行います。

**Topics**
+ [オーバーレイ広告の有効化](overlay-ads-getting-started-enabling.md)
+ [クライアント側のメタデータを使用したオーバーレイ広告の追跡](overlay-ads-client-side-tracking-metadata.md)

# オーバーレイ広告の有効化
<a name="overlay-ads-getting-started-enabling"></a>

オーバーレイ広告の MediaTailor サポートはデフォルトで有効になっています。マニフェスト内の特定の SCTE-35 広告マーカータイプは、オーバーレイ広告の挿入をトリガーします。一部のプレイヤーはオーバーレイ広告のクライアント側のレンダリングをサポートしていない可能性があるため、セッションレベルでこの機能を無効にすることができます。

**HLS または DASH 再生プレフィックスを使用して overlay-ad サポートを無効にするには:**
+ プレイヤーから、プロトコルに従った以下のいずれかの形式を使用して、新しい MediaTailor 再生セッションを開始します。
  + 例: HLS 形式

    ```
    GET mediatailorURL/v1/master/hashed-account-id/origin-id/asset-id?aws.overlayAvails=off
    ```
  + 例: DASH 形式

    ```
    GET mediatailorURL/v1/master/hashed-account-id/origin-id/asset-id?aws.overlayAvails=off
    ```

**session-initialization プレフィックスを使用して overlay-ad サポートを無効にするには:**
+ プレイヤーで、MediaTailor へのセッション初期化リクエストの JSON メッセージ本文を作成します。
  + 広告オーバーレイのサポートを無効にするには、 オブジェクトを の値を持つ最上位キー`overlays`として追加します`off`。`overlays` デフォルト値は です`on`。
  + (オプション) MediaTailor が`adsParams`オブジェクト内の ADS に渡すパラメータを指定します。これらのパラメータは、MediaTailor の ADS テンプレート URL にある `[player_params.param]` 設定に対応しています。

**Example HLS:**  

```
POST master.m3u8
    {
       "adsParams": {
           "deviceType": "ipad"
       },
       "overlayAvails": "off"
    }
```

**Example DASH:**  

```
POST manifest.mpd
    {
        "adsParams": {
           "deviceType": "androidmobile"
       },
       "overlayAvails": "off"
    }
```

# マニフェストシグナリング
<a name="overlay-ads-manifest-signaling"></a>

MediaTailor トリガーオーバーレイ広告は、マニフェストに特定の SCTE-35 マーカーが表示されるとサポートされます。必要なシグナルは、スプライスコマンドタイプ 6、またはプロバイダーオーバーレイ広告開始シグナルであるタイムシグナルです。このシグナルのセグメンテーションタイプ ID は です `0x38`

次の例は、JSON オブジェクトの `0x38` SCTE-35 マーカーを示しています。

```
{
  "tableId": 252,
  "selectionSyntaxIndicator": false,
  "privateIndicator": false,
  "sectionLength": 53,
  "protocolVersion": 0,
  "encryptedPacket": false,
  "encryptedAlgorithm": 0,
  "ptsAdjustment": 0,
  "cwIndex": 0,
  "tier": 4095,
  "spliceCommandLength": 5,
  "spliceCommandType": 6,
  "spliceCommand": {
    "specified": true,
    "pts": 1800392
  },
  "descriptorLoopLength": 31,
  "descriptors": [
    {
      "spliceDescriptorTag": 2,
      "descriptorLength": 29,
      "indentifier": "CUEI",
      "segmentationEventId": 158389361,
      "segmentationEventCancelIndicator": false,
      "programSegmentationFlag": true,
      "segmentationDurationFlag": true,
      "deliveryNotRestrictedFlag": false,
      "webDeliveryAllowedFlag": true,
      "noRegionalBlackoutFlag": true,
      "archiveAllowedFlag": true,
      "deviceResctrictions": 3,
      "segmentationDuration": 1350000,
      "segmentationUpidType": 9,
      "segmentationUpidLength": 7,
      "segmentationUpid": {
        "0": 111,
        "1": 118,
        "2": 101,
        "3": 114,
        "4": 108,
        "5": 97,
        "6": 121
      },
      "segmentationTypeId": 56,
      "segmentNum": 1,
      "segmentsExpected": 0
    }
  ],
  "crc": 2510422713
}
```

次の例は、バイナリ (ベース 32/16 進数) 値として表される SCTE-35 シグナルを示しています。

```
0xfc303500000000000000fff00506fe001b78c8001f021d435545490970d4717fdf00000dbba009076f7665726c6179380100000084226c4f
```

次の例は、HLS マニフェストと DASH マニフェストの両方の SCTE-35 マーカーを示しています。

**Example : HLS マニフェスト**  

```
#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:7
#EXT-X-MEDIA-SEQUENCE:419
#EXT-X-DISCONTINUITY-SEQUENCE:3
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:09.231Z
#EXTINF:6.02,
https://aws.cloudfront.net/media/asset1/index1_00007.ts
#EXT-X-DISCONTINUITY
#EXT-X-KEY:METHOD=NONE
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:15.251Z
#EXTINF:6.0,
https://aws.cloudfront.net/media/asset1/index1_00001.ts
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:21.251Z
#EXTINF:4.0,
https://aws.cloudfront.net/media/asset1/index1_00002.ts
#EXT-X-DISCONTINUITY
#EXT-X-DATERANGE:ID="1692073825251-30-1",START-DATE="2023-08-15T04:30:25.251Z",DURATION=10.0,PLANNED-DURATION=10.0,SCTE35-OUT=0xfc303500000000000000fff00506fe001b78c8001f021d435545490970d4717fdf00000dbba009076f7665726c6179380100000084226c4f
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:25.251Z
#EXTINF:2.0,
https://aws.cloudfront.net/media/asset1/index1_00003.ts
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:27.251Z
#EXTINF:6.0,
https://aws.cloudfront.net/media/asset1/index1_00004.ts
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:33.251Z
#EXTINF:2.0,
https://aws.cloudfront.net/media/asset1/index1_00005.ts
#EXT-X-DISCONTINUITY
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:35.251Z
#EXTINF:4.0,
https://aws.cloudfront.net/media/asset1/index1_00006.ts
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:39.251Z
#EXTINF:6.02,
https://aws.cloudfront.net/media/asset1/index1_00007.ts
```

**Example : DASH マニフェスト**  

```
<?xml version="1.0"?>
<MPD xmlns="urn:mpeg:dash:schema:mpd:2011" xmlns:scte35="urn:scte:scte35:2013:xml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" availabilityStartTime="2023-08-15T16:34:05.911Z" minBufferTime="PT30S" minimumUpdatePeriod="PT2S" profiles="urn:mpeg:dash:profile:isoff-live:2011" publishTime="2023-08-15T16:34:17.950Z" suggestedPresentationDelay="PT20S" timeShiftBufferDepth="PT1M30S" type="dynamic" xsi:schemaLocation="urn:mpeg:dash:schema:mpd:2011 http://standards.iso.org/ittf/PubliclyAvailableStandards/MPEG-DASH_schema_files/DASH-MPD.xsd">
  <Period xmlns="urn:mpeg:dash:schema:mpd:2011" id="1692117245944_1" start="PT0.033S">
    <BaseURL>https://aws.cloudfront.net/out/v1/abc/123/def/</BaseURL>
    <EventStream schemeIdUri="urn:scte:scte35:2013:xml" timescale="90000">
      <Event duration="900000">
        <scte35:SpliceInfoSection protocolVersion="0" ptsAdjustment="0" tier="4095">
          <scte35:TimeSignal>
            <scte35:SpliceTime ptsTime="0"/>
          </scte35:TimeSignal>
          <scte35:SegmentationDescriptor segmentNum="0" segmentationDuration="900000" segmentationEventCancelIndicator="false" segmentationEventId="1" segmentationTypeId="56" segmentsExpected="0" subSegmentNum="0" subSegmentsExpected="0">
            <scte35:SegmentationUpid segmentationUpidFormat="hexBinary" segmentationUpidType="14">63736f7665726c6179</scte35:SegmentationUpid>
          </scte35:SegmentationDescriptor>
        </scte35:SpliceInfoSection>
      </Event>
    </EventStream>
    <AdaptationSet bitstreamSwitching="true" mimeType="video/mp4" segmentAlignment="true" startWithSAP="1" subsegmentAlignment="true" subsegmentStartsWithSAP="1">
      <Representation bandwidth="3000000" codecs="avc1.4D4028" frameRate="30/1" height="1080" id="1" width="1920">
        <SegmentTemplate initialization="../cf684d31ec9e451ca98d2349989f6c0a/855c733eed20493ab3cc1100750bcf0b/index_video_1_0_init.mp4" media="../cf684d31ec9e451ca98d2349989f6c0a/855c733eed20493ab3cc1100750bcf0b/index_video_1_0_$Number$.mp4" presentationTimeOffset="0" startNumber="1" timescale="30000">
          <SegmentTimeline>
            <S d="60000" r="6" t="1000"/>
            <S d="30000" t="421000"/>
          </SegmentTimeline>
        </SegmentTemplate>
      </Representation>
      <Representation bandwidth="2499968" codecs="avc1.4D4028" frameRate="30/1" height="1080" id="2" width="1920">
        <SegmentTemplate initialization="../cf684d31ec9e451ca98d2349989f6c0a/855c733eed20493ab3cc1100750bcf0b/index_video_2_0_init.mp4" media="../cf684d31ec9e451ca98d2349989f6c0a/855c733eed20493ab3cc1100750bcf0b/index_video_2_0_$Number$.mp4" presentationTimeOffset="0" startNumber="1" timescale="30000">
          <SegmentTimeline>
            <S d="60000" r="6" t="1000"/>
            <S d="30000" t="421000"/>
          </SegmentTimeline>
        </SegmentTemplate>
      </Representation>
      <Representation bandwidth="2200000" codecs="avc1.4D401F" frameRate="30/1" height="720" id="3" width="1280">
        <SegmentTemplate initialization="../cf684d31ec9e451ca98d2349989f6c0a/855c733eed20493ab3cc1100750bcf0b/index_video_3_0_init.mp4" media="../cf684d31ec9e451ca98d2349989f6c0a/855c733eed20493ab3cc1100750bcf0b/index_video_3_0_$Number$.mp4" presentationTimeOffset="0" startNumber="1" timescale="30000">
          <SegmentTimeline>
            <S d="60000" r="6" t="1000"/>
            <S d="30000" t="421000"/>
          </SegmentTimeline>
        </SegmentTemplate>
      </Representation>
    </AdaptationSet>
    <AdaptationSet lang="eng" mimeType="audio/mp4" segmentAlignment="0">
      <Label>Alternate Audio</Label>
      <Representation audioSamplingRate="48000" bandwidth="128000" codecs="mp4a.40.2" id="9">
        <AudioChannelConfiguration schemeIdUri="urn:mpeg:dash:23003:3:audio_channel_configuration:2011" value="2"/>
        <SegmentTemplate initialization="../cf684d31ec9e451ca98d2349989f6c0a/855c733eed20493ab3cc1100750bcf0b/index_audio_9_0_init.mp4" media="../cf684d31ec9e451ca98d2349989f6c0a/855c733eed20493ab3cc1100750bcf0b/index_audio_9_0_$Number$.mp4" presentationTimeOffset="0" startNumber="1" timescale="48000">
          <SegmentTimeline>
            <S d="98304" t="0"/>
            <S d="96256" t="98304"/>
            <S d="95232" t="194560"/>
            <S d="96256" r="2" t="289792"/>
            <S d="95232" t="578560"/>
            <S d="46080" t="673792"/>
          </SegmentTimeline>
        </SegmentTemplate>
      </Representation>
    </AdaptationSet>
  </Period>
</MPD>
```

# 広告決定サーバー (ADS) レスポンス
<a name="overlay-ads-ads-response"></a>

ADS レスポンスには、有効な追跡イベントが 1 つ含まれている必要があります。少なくとも、追跡イベントは`Impression`追跡イベントにすることができます。追跡イベントには、少なくとも 1 つの`NonLinear`広告が含まれている必要があります。この広告は、静的、HTML、または iFrame リソースの形式でオーバーレイ広告です。

```
<vmap AdBreak breaktype="linear" breakId="csoverlay"
```

VAST レスポンスが `breakType`の VMAP である場合`nonlinear`、avail メタデータは`nonLinearAvails`ルートオブジェクト内にあります。VAST レスポンスが `breakType`の VMAP である場合`linear`、または VMAP のないプレーン VAST レスポンスである場合、avail メタデータは`avails`ルートオブジェクト内にあります。

次の VAST レスポンスは、`breakType`値が のラップされた VMAP レスポンスです`linear`。

ラップされた VMAP レスポンスに加えて、MediaTailor は `breakType`の値を持つラップされた VMAP レスポンス`nonlinear`とプレーン VAST レスポンスもサポートします。

```
<?xml version="1.0" encoding="utf-8"?>
<vmap:VMAP xmlns:vmap="http://www.iab.net/vmap-1.0" version="1.0">
  <vmap:AdBreak breakType="linear" breakId="csoverlay">
    <vmap:AdSource allowMultipleAds="true" followRedirects="true" id="1">
      <vmap:VASTAdData>
        <VAST xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="3.0" xsi:noNamespaceSchemaLocation="vast.xsd">
          <Ad sequence="1">
            <InLine>
              <AdSystem>2.0</AdSystem>
              <AdTitle>2</AdTitle>
              <Impression><![CDATA[https://adserver.com/beacon=impression]]></Impression>
              <Creatives>
                <Creative>
                  <NonLinearAds>
                    <NonLinear width="640" height="360" id="18">
                      <StaticResource creativeType="text/js_ref"><![CDATA[https://client-side-ads.com/tags/static/ctv-generic/overlay001.json?iv_geo_country%3DUS%26]]></StaticResource>
                    </NonLinear>
                  </NonLinearAds>
                </Creative>
              </Creatives>
            </InLine>
          </Ad>
        </VAST>
      </vmap:VASTAdData>
    </vmap:AdSource>
    <vmap:TrackingEvents>
      <vmap:Tracking event="breakStart"><![CDATA[https://adserver.com/beacon=breakstartimpression]]></vmap:Tracking>
      <vmap:Tracking event="breakEnd"><![CDATA[https://adserver.com/beacon=breakendimpression]]></vmap:Tracking>
    </vmap:TrackingEvents>
  </vmap:AdBreak>
</vmap:VMAP>
```

**Example 1: MediaTailor への DASH マニフェストソース**  

```
<?xml version="1.0" encoding="utf-8"?>
<MPD xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:mpeg:dash:schema:mpd:2011" xmlns:scte35="urn:scte:scte35:2013:xml" xsi:schemaLocation="urn:mpeg:dash:schema:mpd:2011 http://standards.iso.org/ittf/PubliclyAvailableStandards/MPEG-DASH_schema_files/DASH-MPD.xsd" id="201" type="dynamic" publishTime="2022-11-07T19:59:05+00:00" minimumUpdatePeriod="PT2S" availabilityStartTime="2022-11-07T06:57:11.250000+00:00" minBufferTime="PT10S" suggestedPresentationDelay="PT20.000S" timeShiftBufferDepth="PT58.999S" profiles="urn:mpeg:dash:profile:isoff-live:2011">
  <Period start="PT46827.601S" id="0" duration="PT88.321S">
  ...
  </Period>
  <Period start="PT46915.922S" id="45" duration="PT6.006S">
    <EventStream timescale="90000" schemeIdUri="urn:scte:scte35:2014:xml+bin">
    <Event duration="540000" id="144">
        <scte35:Signal>
            <scte35:Binary>SCTE35-binary</scte35:Binary>
        </scte35:Signal>
    </Event>
    </EventStream>
    ... 
  </Period>
  <Period start="PT46921.928S" id="49"> 
  ...
  </Period>
</MPD>
```

**Example 2: 広告 ID デコレーションを含む MediaTailor パーソナライズされた DASH マニフェスト**  

```
<?xml version="1.0" encoding="utf-8"?>
<MPD xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:mpeg:dash:schema:mpd:2011" xmlns:scte35="urn:scte:scte35:2013:xml" xsi:schemaLocation="urn:mpeg:dash:schema:mpd:2011 http://standards.iso.org/ittf/PubliclyAvailableStandards/MPEG-DASH_schema_files/DASH-MPD.xsd" id="201" type="dynamic" publishTime="2022-11-07T19:59:05+00:00" minimumUpdatePeriod="PT2S" availabilityStartTime="2022-11-07T06:57:11.250000+00:00" minBufferTime="PT10S" suggestedPresentationDelay="PT20.000S" timeShiftBufferDepth="PT58.999S" profiles="urn:mpeg:dash:profile:isoff-live:2011">
  <Period start="PT46827.601S" id="0" duration="PT88.321S">
  ...
  </Period>
  <Period start="PT46915.922S" id="45" duration="PT6.006S">
  <EventStream schemeIdUri="urn:sva:advertising-wg:ad-id-signaling" timescale="90000">
    <Event presentationTime="13500000" duration="1351350">
    <![CDATA[{"version": 1,"identifiers": [{"scheme": "urn:smpte:ul:060E2B34.01040101.01200900.00000000","value": "adId","ad_position": "adId", "ad_type":"overlay","creative_id": "creativeId","tracking_uri": "trackingUri"}]}]]></Event>
  </EventStream>
  ...
  </Period>
  <Period start="PT46921.928S" id="49"> 
  ...
  </Period>
</MPD>
```

# クライアント側のメタデータを使用したオーバーレイ広告の追跡
<a name="overlay-ads-client-side-tracking-metadata"></a>

MediaTailor は、オーバーレイ広告を表示`nonLinearAdsList`の に配置します。MediaTailor クライアント側の追跡 API には、 `avails`と という 2 つのルートオブジェクトがあります`nonLinearAvails`。VAST レスポンスが `breakType`の VMAP である場合`nonlinear`、avail メタデータは`nonLinearAvails`ルートオブジェクト内にあります。VAST レスポンスが の VMAP `breakType` である場合`linear`、または VMAP を使用しないプレーン VAST レスポンスである場合、avail メタデータは`avails`ルートオブジェクト内にあります。

クライアント側の追跡の詳細については、「」を参照してください[クライアント側の広告追跡](ad-reporting-client-side.md)。

次の例は、`breakType`値が のプレーン VAST レスポンスまたは VMAP レスポンスを示しています`linear`。

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [
        {
          "beaconUrls": [
            "https://adserver.com/beacon=breakstartimpression"
          ],
          "eventType": "breakStart"
        },
        {
          "beaconUrls": [
            "https://adserver.com/beacon=breakendimpression"
          ],
          "eventType": "breakEnd"
        }
      ],
      "adMarkerDuration": null,
      "ads": [],
      "availId": "828",
      "availProgramDateTime": null,
      "duration": "PT0S",
      "durationInSeconds": 0,
      "meta": null,
      "nonLinearAdsList": [
        {
          "extensions": null,
          "nonLinearAdList": [
            {
              "adId": "",
              "adParameters": null,
              "adSystem": "2.0",
              "adTitle": "2",
              "apiFramework": null,
              "clickThrough": null,
              "clickTracking": null,
              "clickTrackingId": null,
              "creativeAdId": "",
              "creativeId": "18",
              "creativeSequence": "",
              "duration": null,
              "durationInSeconds": 0,
              "expandedHeight": null,
              "expandedWidth": null,
              "height": "360",
              "htmlResource": null,
              "iFrameResource": null,
              "maintainAspectRatio": false,
              "minSuggestedDuration": null,
              "scalable": false,
              "staticResource": "https://client-side-ads.com/tags/static/ctv-generic/overlay001.json?iv_geo_country%3DUS%26",
              "staticResourceCreativeType": "text/js_ref",
              "width": "640"
            }
          ],
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://adserver.com/beacon=impression"
              ],
              "duration": null,
              "durationInSeconds": 0,
              "eventId": null,
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": null,
              "startTimeInSeconds": 0
            }
          ]
        }
      ],
      "startTime": "PT1M46.08S",
      "startTimeInSeconds": 106.08
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": null,
  "nonLinearAvails": []
}
```

次の例は、`breakType`値が のプレーン VMAP レスポンスを示しています`nonlinear`。

```
{
  "avails": [],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": null,
  "nonLinearAvails": [
    {
      "adBreakTrackingEvents": [
        {
          "beaconUrls": [
            "https://adserver.com/beacon=breakstartimpression"
          ],
          "eventType": "breakStart"
        },
        {
          "beaconUrls": [
            "https://adserver.com/beacon=breakendimpression"
          ],
          "eventType": "breakEnd"
        }
      ],
      "adMarkerDuration": null,
      "ads": [],
      "availId": "828",
      "availProgramDateTime": null,
      "duration": "PT0S",
      "durationInSeconds": 0,
      "meta": null,
      "nonLinearAdsList": [
        {
          "extensions": null,
          "nonLinearAdList": [
            {
              "adId": "",
              "adParameters": null,
              "adSystem": "2.0",
              "adTitle": "2",
              "apiFramework": null,
              "clickThrough": null,
              "clickTracking": null,
              "clickTrackingId": null,
              "creativeAdId": "",
              "creativeId": "18",
              "creativeSequence": "",
              "duration": null,
              "durationInSeconds": 0,
              "expandedHeight": null,
              "expandedWidth": null,
              "height": "360",
              "htmlResource": null,
              "iFrameResource": null,
              "maintainAspectRatio": false,
              "minSuggestedDuration": null,
              "scalable": false,
              "staticResource": "https://client-side-ads.com/tags/static/ctv-generic/overlay001.json?iv_geo_country%3DUS%26",
              "staticResourceCreativeType": "text/js_ref",
              "width": "640"
            }
          ],
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://adserver.com/beacon=impression"
              ],
              "duration": null,
              "durationInSeconds": 0,
              "eventId": null,
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": null,
              "startTimeInSeconds": 0
            }
          ]
        }
      ],
      "startTime": "PT1M46.08S",
      "startTimeInSeconds": 106.08
    }
  ]
}
```

# MediaTailor でのオーバーレイ広告のログ記録とメトリクス
<a name="overlay-ads-logging-and-metrics"></a>

このセクションでは、MediaTailor のオーバーレイ広告のログ記録とメトリクスについて説明します。ログ記録の設定の詳細については、「」を参照してください[AWS Elemental MediaTailor リソースのモニタリングとタグ付け](monitoring.md)。

**Topics**
+ [CloudWatch ログ](#overlay-ads-logging-and-metrics-cloudwatch)
+ [CloudWatch メトリクス](#overlay-ads-logging-and-metrics-cloudwatch-metrics)

## CloudWatch ログ
<a name="overlay-ads-logging-and-metrics-cloudwatch"></a>

CloudWatch は、オーバーレイ広告に関する次のログ情報を収集します。
+ `VAST_RESPONSE` - 非線形広告リストに関する情報を表示します。
+ `FILLED_PROVIDER_OVERLAY` - 非線形広告に関する情報を表示します。

**注記**  
`RAW_ADS_RESPONSE` は、ADS からの元のレスポンスを示すオプションのイベントです。このイベントの使用は、ステージングおよびテスト環境で特に役立ちます。設定またはアカウントでこのイベントを有効にするには、 AWS サポートにチケットを送信します。

## CloudWatch メトリクス
<a name="overlay-ads-logging-and-metrics-cloudwatch-metrics"></a>

MediaTailor は、オーバーレイ広告メトリクスを他の ADS メトリクスとは別に収集します。MediaTailor は、ADS から広告を正常に取得した後、これらのメトリクスを収集します。API をポーリング`GetTracking`してメトリクスを収集する必要はありません。

次の表に、オーバーレイ広告の CloudWatch メトリクスを示します。


| メトリクス | 説明 | 
| --- | --- | 
| AdDecisionServer.OverlayAds |  指定した CloudWatch 期間内に ADS レスポンスに含まれるオーバーレイ広告の数。  | 
| AdDecisionServer.OverlayErrors |  指定した CloudWatch 期間内に MediaTailor が ADS から受信した HTTP 以外の`200`ステータスコードレスポンス、空のレスポンス、タイムアウトレスポンスの数。  | 
| AdDecisionServer.OverlayFilled |  少なくとも 1 つのオーバーレイ広告で正常に埋められた表示の数: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/overlay-ads-logging-and-metrics.html) `SampleCount` は、入力された avail の数を追跡します。 `Sum` は、正常に埋められたオーバーレイ表示の数を追跡します。  | 
| AdDecisionServer.OverlayMinSuggestedDuration |  指定した CloudWatch 期間内に MediaTailor が ADS から受信したすべての広告`minSuggestedDuration`の期間の合計をミリ秒単位で表します。が指定され`minSuggestedDuration`ていない場合、表示される期間は計画された期間です。  | 
| AdDecisionServer.OverlayLatency |  MediaTailor が ADS に対して行うリクエストの応答時間をミリ秒単位で表します。  | 
| AdDecisionServer.OverlayTimeouts |  ユーザー指定の CloudWatch 期間中の ADS に対するタイムアウトリクエストの数。  | 
| AdsBilled |  請求される広告の詳細については、「」を参照してください[MediaTailor でのオーバーレイ広告の請求](overlay-ads-billing.md)。  | 
| Avail.\$1 |  MediaTailor はオーバーレイ広告の計画を行わないため、CloudWatch は`Avail.X`メトリクスを表示しません。  | 
| SkippedReason.\$1 |  MediaTailor はオーバーレイ広告の計画を行わないため、CloudWatch は`SkippedReason.X`メトリクスを表示しません。  | 

# MediaTailor でのオーバーレイ広告の請求
<a name="overlay-ads-billing"></a>

MediaTailor は、ADS レスポンスの非線形広告の数に基づいて顧客に請求します。この数には、ブレーク期間を超えて延長される非線形広告が含まれます。MediaTailor が表示を埋めると、入力された広告に対して請求されます。

プリフェッチワークフローの場合、MediaTailor はプリフェッチの取得時に広告に対して課金せず、そのセッションの消費ウィンドウに互換性のある広告表示が表示されるときに課金します。

その他の請求情報については、「」を参照してください[https://aws.amazon.com/mediatailor/pricing/](https://aws.amazon.com/mediatailor/pricing/)。