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

# MediaTailor Konfigurasi penyisipan iklan yang dipandu server untuk streaming langsung
<a name="sgai-live-configuration"></a>

AWS Elemental MediaTailor Penyisipan iklan yang dipandu server untuk konten langsung memberikan manfaat kinerja yang signifikan melalui manifes yang dapat di-cache. Mengkonfigurasi SGAI untuk konten langsung menggunakan parameter inti yang sama dengan VOD, dengan pertimbangan khusus untuk karakteristik streaming langsung dan pemrosesan waktu nyata.

## Persyaratan untuk Live SGAI
<a name="sgai-live-requirements"></a>

Sebelum Anda mengaktifkan SGAI untuk konten langsung, pastikan Anda memiliki yang berikut:
+ Streaming langsung Anda menyertakan penanda DATERANGE yang diformat dengan benar
+ Durasi jeda iklan konsisten dan dapat diprediksi
+ CDN Anda dikonfigurasi untuk menyimpan manifes SGAI dengan tepat
+ Pemain mendukung alur kerja penyisipan iklan yang dipandu server
+ Server keputusan iklan Anda dapat menangani permintaan real-time untuk konten langsung

### Persyaratan pemain
<a name="sgai-live-player-integration"></a>

Pemain harus dikonfigurasi untuk menangani manifes langsung SGAI dengan benar:
+ Support untuk alur kerja penyisipan iklan yang dipandu server
+ Kemampuan untuk memproses panduan penyisipan iklan dari manifes
+ Penanganan waktu streaming langsung dan sinkronisasi yang tepat
+ Untuk konten HLS: Support untuk HLS versi 8 dan EXT-X-DATERANGE dengan atribut CLASS. Versi 11 untuk beaconing sisi server.
+ Untuk konten HLS: dukungan substitusi EXT-X-DEFINE variabel

## Konfigurasi pemutaran langsung
<a name="sgai-live-playback-config"></a>

Untuk mengaktifkan SGAI untuk konten langsung, buat konfigurasi pemutaran yang memiliki pengaturan berikut:

**Example Konfigurasi pemutaran langsung SGAI**  

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

Berikut ini adalah pertimbangan utama untuk konfigurasi SGAI langsung:

`VideoContentSourceUrl`  
Harus menunjuk ke aliran HLS langsung dengan penanda SCTE-35 DATERANGE yang diformat dengan benar. Aliran harus mempertahankan durasi segmen dan varian bitrate yang konsisten.

## Permintaan manifes langsung SGAI
<a name="sgai-live-manifest-requests"></a>

Manifes langsung SGAI menggunakan pola URL yang sama dengan penyisipan iklan tradisional:

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

## Prefetch berbasis manifes untuk Live SGAI
<a name="sgai-live-guided-prefetch"></a>

Untuk alur kerja SGAI langsung, Anda dapat mengaktifkan detak jantung prefetch berbasis manifes untuk mengurangi latensi pengisian iklan. Tambahkan `aws.guidedPrefetchMode=MANIFEST` ke permintaan manifes:

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

Saat diaktifkan, MediaTailor tambahkan pengenal sesi (`?aws.sessionId=<id>`) sebagai parameter kueri ke setiap URL manifes media interstitial (`/v1/i-media`) dalam daftar putar multivariant. Setiap kali pemain menyegarkan manifes i-media, permintaan mencapai MediaTailor dengan ID sesi, yang MediaTailor digunakan untuk mengidentifikasi sesi dan mengantrekan permintaan prefetch untuk jeda iklan yang akan datang.

**penting**  
**Jangan cache manifes i-media di CDN Anda saat menggunakan prefetch terpandu.** Mekanisme detak jantung prefetch tergantung pada permintaan refresh manifes pemain yang menjangkau secara langsung. MediaTailor Jika CDN Anda cache dan menyajikan `/v1/i-media` respons, MediaTailor tidak menerima permintaan detak jantung dan tidak dapat memicu prefetching. Konfigurasikan CDN Anda untuk melewati `/v1/i-media/*` permintaan MediaTailor saat `aws.guidedPrefetchMode=MANIFEST` digunakan.

Prefetch terpandu tidak tergantung pada mode pelaporan. Baik Anda menggunakan pelacakan sisi server (default) atau sisi klien (`aws.reportingMode=CLIENT`), beacon menyala pada waktu pemutaran, bukan saat iklan diambil sebelumnya. Untuk informasi umum tentang cara kerja prefetching iklan MediaTailor, lihat. [Prefetching iklan](prefetching-ads.md)

## Menguji konfigurasi langsung SGAI
<a name="sgai-live-testing"></a>

Verifikasi pengaturan langsung SGAI Anda dengan langkah-langkah validasi berikut:

1. **Uji generasi manifes**

   Minta URL manifes langsung SGAI dan verifikasi bahwa URL tersebut menampilkan konten yang dapat di-cache dengan panduan penyisipan iklan yang tepat.

1. **Verifikasi caching CDN**

   Periksa apakah CDN Anda menyimpan manifes SGAI sesuai dengan nilai TTL yang dikonfigurasi.

1. **Uji penyisipan iklan**

   Konfirmasikan bahwa pemain dapat berhasil menyisipkan iklan menggunakan panduan yang disediakan dalam manifes SGAI.

1. **Pantau kinerja**

   Gunakan CloudWatch metrik untuk memverifikasi pengurangan beban asal dan tingkat hit cache yang ditingkatkan.