Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Iklan overlay
<a name="overlay-ads"></a>

Untuk alur kerja streaming langsung di mana Anda ingin meningkatkan monetisasi tanpa mengganggu pengalaman menonton dengan iklan mid-roll, Anda dapat memanfaatkan AWS Elemental MediaTailor integrasi Anda saat ini untuk memandu format iklan yang diberikan sisi klien. Jenis iklan ini dikenal sebagai *iklan overlay*. Iklan overlay adalah iklan video non-linear yang muncul dalam bentuk 'iklan L-band, ''iklan video non-linear,' 'iklan,' 'motion overlays', picture-in-picture 'in-content advertising', atau 'frame ads. '

MediaTailor mendeteksi penanda SCTE-35 dengan tipe segmentasi `id=0x38` sebagai sinyal in-band untuk peluang penyisipan iklan overlay. Penanda SCTE-35 menyebabkan pengiriman permintaan MediaTailor ke Server Keputusan Iklan (ADS), yang kemudian merespons dengan muatan iklan non-linier dalam respons VAST. MediaTailor mem-parsing respons VAST untuk mendukung penyisipan iklan overlay. MediaTailor tidak melakukan jahitan iklan linier, melainkan memberi sinyal kepada pemain bahwa ada iklan overlay non-linier yang tersedia untuk diputar. Pensinyalan ini memungkinkan pemain untuk mengambil dan mengkorelasikan iklan non-linier untuk diputar dari titik akhir pelacakan sisi klien. Pemain kemudian menangani tampilan, pelaporan, dan tugas lain yang terkait dengan iklan tersebut. Misalnya, pengembang pemain dapat menggunakan SDK perangkat dari vendor yang mendukung format overlay-ad. Untuk informasi selengkapnya tentang integrasi pelacakan sisi klien, lihat. [Integrasi pelacakan iklan sisi klien](ad-reporting-client-side-ad-tracking-integrations.md)

![\[Gambar menggambarkan garis waktu berbagai jenis iklan yang ditampilkan bersama video konten. Iklan linier diputar sebelum dan sesudah video konten. Iklan sebelum video konten disebut iklan pra-putar. Iklan setelah video konten disebut iklan pasca-roll. Iklan non-linear tumpang tindih dengan sebagian video konten itu sendiri. Iklan non-linear disebut iklan overlay.\]](http://docs.aws.amazon.com/id_id/mediatailor/latest/ug/images/client-side-overlays.png)


**Topics**
+ [Prasyarat untuk menggunakan iklan overlay dengan MediaTailor](overlay-ads-prerequisites.md)
+ [Memulai menggunakan iklan overlay dengan MediaTailor](overlay-ads-getting-started.md)
+ [Pencatatan dan metrik untuk iklan overlay di MediaTailor](overlay-ads-logging-and-metrics.md)
+ [Penagihan untuk iklan overlay di MediaTailor](overlay-ads-billing.md)

# Prasyarat untuk menggunakan iklan overlay dengan MediaTailor
<a name="overlay-ads-prerequisites"></a>

Prasyarat berikut berlaku saat menggunakan iklan overlay dengan: MediaTailor
+ Alur kerja harus live, bukan video on demand (VOD).
+ Respons Ad Decision Server (ADS) harus dikonfigurasi agar hanya menampilkan iklan non-linear dalam respons VAST. MediaTailor mengabaikan iklan linier apa pun untuk tujuan jahitan iklan.
+ Manifes harus menggunakan pesan sinyal waktu SCTE-35 dengan tipe segmentasi `id=0x38` untuk menjalankan fitur overlay-ad.
+ Penyedia streaming harus memiliki kendali atas aplikasi perangkat klien dan terintegrasi dengan API pelacakan sisi MediaTailor klien.

# Memulai menggunakan iklan overlay dengan MediaTailor
<a name="overlay-ads-getting-started"></a>

Bagian ini menjelaskan cara memulai menggunakan fitur overlay-ads dari. MediaTailor Anda akan menyiapkan pensinyalan SCTE-35, mengonfigurasi respons Server Keputusan Iklan (ADS), dan mengatur kontrol tingkat sesi.

**Topics**
+ [Mengaktifkan iklan overlay](overlay-ads-getting-started-enabling.md)
+ [Melacak iklan overlay dengan metadata sisi klien](overlay-ads-client-side-tracking-metadata.md)

# Mengaktifkan iklan overlay
<a name="overlay-ads-getting-started-enabling"></a>

MediaTailor dukungan untuk iklan overlay diaktifkan secara default. Jenis penanda iklan SCTE-35 tertentu dalam manifes memicu penyisipan iklan overlay. Karena beberapa pemain mungkin tidak mendukung rendering sisi klien dari iklan overlay, Anda dapat menonaktifkan fitur di tingkat sesi.

**Untuk menonaktifkan dukungan overlay-ad menggunakan awalan pemutaran HLS atau DASH:**
+ Dari pemutar, inisialisasi sesi MediaTailor pemutaran baru menggunakan permintaan dalam salah satu format berikut, sesuai dengan protokol Anda:
  + Contoh: format HLS

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

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

**Untuk menonaktifkan dukungan overlay-ad menggunakan awalan inisialisasi sesi:**
+ Pada pemain, buat badan pesan JSON untuk permintaan inisialisasi sesi ke: MediaTailor
  + Untuk menonaktifkan dukungan ad-overlay, tambahkan `overlays` objek sebagai kunci tingkat atas dengan nilai. `off` `overlays`Nilai defaultnya adalah`on`.
  + (Opsional) Berikan parameter apa pun yang MediaTailor kemudian diteruskan ke ADS di dalam `adsParams` objek. Parameter ini sesuai dengan `[player_params.param]` pengaturan di URL templat ADS MediaTailor konfigurasi.

**Example : HLS**  

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

**Example : DASBOR**  

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

# Pensinyalan manifes
<a name="overlay-ads-manifest-signaling"></a>

MediaTailor memicu dukungan overlay-ads saat melihat penanda SCTE-35 tertentu dalam manifes. Sinyal yang diperlukan adalah perintah sambatan tipe 6, atau sinyal waktu, yaitu sinyal Mulai Iklan Overlay Penyedia. Sinyal ini memiliki id tipe segmentasi `0x38`

Contoh berikut menunjukkan penanda `0x38` SCTE-35 dalam objek JSON.

```
{
  "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
}
```

Contoh berikut menunjukkan sinyal SCTE-35 direpresentasikan sebagai nilai biner (basis 32/heksadesimal):

```
0xfc303500000000000000fff00506fe001b78c8001f021d435545490970d4717fdf00000dbba009076f7665726c6179380100000084226c4f
```

Contoh berikut menunjukkan penanda SCTE-35 dalam manifes HLS dan DASH.

**Example : Manifes 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 : Manifes 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>
```

# Tanggapan Server Keputusan Iklan (ADS)
<a name="overlay-ads-ads-response"></a>

Respons ADS harus berisi satu peristiwa pelacakan yang valid. Minimal, acara pelacakan bisa menjadi acara `Impression` pelacakan. Acara pelacakan harus berisi setidaknya satu `NonLinear` iklan. Iklan ini adalah iklan overlay, mengambil bentuk sumber daya statis, HTML, atau iFrame.

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

Jika respons VAST adalah VMAP dengan `breakType` of`nonlinear`, metadata yang tersedia ada di dalam objek root. `nonLinearAvails` Jika respons VAST adalah VMAP dengan `breakType` of`linear`, atau merupakan respons VAST biasa tanpa VMAP, metadata yang tersedia ada di dalam objek root. `avails`

Respons VAST berikut adalah respons VMAP yang dibungkus dengan `breakType` nilai. `linear`

Selain respons VMAP yang dibungkus, MediaTailor juga mendukung respons VMAP yang dibungkus dengan `breakType` nilai`nonlinear`, dan respons VAST biasa.

```
<?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: Sumber manifes DASH ke MediaTailor**  

```
<?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: manifes DASH yang MediaTailor dipersonalisasi yang berisi dekorasi ID iklan**  

```
<?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>
```

# Melacak iklan overlay dengan metadata sisi klien
<a name="overlay-ads-client-side-tracking-metadata"></a>

MediaTailor menempatkan iklan overlay di `nonLinearAdsList` avail. API pelacakan MediaTailor sisi klien memiliki dua objek root, dipanggil `avails` dan. `nonLinearAvails` Jika respons VAST adalah VMAP dengan `breakType` of`nonlinear`, metadata yang tersedia ada di dalam objek root. `nonLinearAvails` Jika respons VAST adalah VMAP dengan `breakType` of`linear`, atau merupakan respons VAST biasa tanpa VMAP, metadata yang tersedia ada di dalam objek root. `avails`

Untuk informasi selengkapnya tentang pelacakan sisi klien, lihat. [Pelacakan iklan sisi klien](ad-reporting-client-side.md)

Contoh berikut menunjukkan respons VAST biasa atau respons VMAP dengan `breakType` nilai. `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": []
}
```

Contoh berikut menunjukkan respons VMAP biasa dengan `breakType` nilai. `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
    }
  ]
}
```

# Pencatatan dan metrik untuk iklan overlay di MediaTailor
<a name="overlay-ads-logging-and-metrics"></a>

Bagian ini menjelaskan pencatatan dan metrik untuk iklan overlay di. MediaTailor Untuk informasi selengkapnya tentang pengaturan logging, lihat[Memantau dan menandai sumber daya AWS Elemental MediaTailor](monitoring.md).

**Topics**
+ [CloudWatch log](#overlay-ads-logging-and-metrics-cloudwatch)
+ [CloudWatch metrik](#overlay-ads-logging-and-metrics-cloudwatch-metrics)

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

CloudWatch mengumpulkan informasi log berikut tentang iklan overlay:
+ `VAST_RESPONSE`- Menampilkan informasi tentang daftar iklan non-linear.
+ `FILLED_PROVIDER_OVERLAY`- Menampilkan informasi tentang iklan non-linear.

**catatan**  
`RAW_ADS_RESPONSE`Ini adalah acara opsional yang menampilkan respons asli dari ADS. Menggunakan acara ini sangat membantu dalam lingkungan pementasan dan pengujian. Untuk mengaktifkan acara ini pada konfigurasi atau akun, kirimkan tiket ke AWS Support.

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

MediaTailor mengumpulkan metrik iklan overlay secara terpisah dari metrik ADS lainnya. MediaTailormengumpulkan metrik ini setelah berhasil mengambil iklan dari ADS. Anda tidak perlu melakukan polling `GetTracking` API untuk mengumpulkan metrik.

Tabel berikut menjelaskan CloudWatch metrik untuk iklan overlay:


| Metrik | Deskripsi | 
| --- | --- | 
| AdDecisionServer.OverlayAds |  Jumlah iklan overlay yang disertakan dalam respons ADS dalam jangka CloudWatch waktu yang Anda tentukan.  | 
| AdDecisionServer.OverlayErrors |  Jumlah respons kode `200` status non-HTTP, respons kosong, dan respons waktu habis yang MediaTailor diterima dari ADS dalam jangka CloudWatch waktu yang Anda tentukan.  | 
| AdDecisionServer.OverlayFilled |  Jumlah avails yang berhasil diisi dengan setidaknya satu iklan overlay: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/mediatailor/latest/ug/overlay-ads-logging-and-metrics.html) `SampleCount`melacak jumlah avails yang diisi. `Sum`melacak jumlah avails overlay yang berhasil diisi.  | 
| AdDecisionServer.OverlayMinSuggestedDuration |  Jumlah `minSuggestedDuration` durasi, dalam milidetik, dari semua iklan yang MediaTailor diterima dari ADS dalam jangka CloudWatch waktu yang Anda tentukan. Jika `minSuggestedDuration` tidak ditentukan, durasi yang ditampilkan adalah durasi yang direncanakan.  | 
| AdDecisionServer.OverlayLatency |  Waktu respons, dalam milidetik, untuk permintaan yang MediaTailor dibuat ke ADS.  | 
| AdDecisionServer.OverlayTimeouts |  Jumlah permintaan waktu habis ke ADS dalam periode CloudWatch waktu yang Anda tentukan.  | 
| AdsBilled |  Untuk informasi selengkapnya tentang iklan yang ditagih, lihat[Penagihan untuk iklan overlay di MediaTailor](overlay-ads-billing.md).  | 
| Avail.\$1 |  Karena MediaTailor tidak melakukan perencanaan untuk iklan overlay, CloudWatch tidak menampilkan `Avail.X` metrik apa pun.  | 
| SkippedReason.\$1 |  Karena MediaTailor tidak melakukan perencanaan untuk iklan overlay, CloudWatch tidak menampilkan `SkippedReason.X` metrik apa pun.  | 

# Penagihan untuk iklan overlay di MediaTailor
<a name="overlay-ads-billing"></a>

MediaTailor menagih pelanggan berdasarkan jumlah iklan non-linier dalam respons ADS. Nomor ini mencakup iklan non-linier yang melampaui durasi jeda. Setelah MediaTailor mengisi keuntungan, ia menagih untuk iklan yang diisi.

Untuk alur kerja prefetch, MediaTailor tidak menagih iklan saat mengambil prefetch, melainkan ketika melihat iklan yang kompatibel tersedia di jendela konsumsi untuk sesi tersebut.

Untuk informasi penagihan tambahan, lihat[https://aws.amazon.com/mediatailor/pricing/](https://aws.amazon.com/mediatailor/pricing/).