

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# MediaTailor configurazione di inserimento degli annunci guidata dal server per i live streaming
<a name="sgai-live-configuration"></a>

AWS Elemental MediaTailor L'inserimento di annunci per contenuti live guidato dal server offre vantaggi significativi in termini di prestazioni grazie a manifesti memorizzabili nella cache. La configurazione di SGAI per i contenuti live utilizza gli stessi parametri fondamentali del VOD, con considerazioni specifiche per le caratteristiche del live streaming e l'elaborazione in tempo reale.

## Requisiti per la SGAI live
<a name="sgai-live-requirements"></a>

Prima di abilitare SGAI per i contenuti live, assicurati di disporre di quanto segue:
+ Il tuo live streaming include marker DATERANGE formattati correttamente
+ Le durate delle interruzioni pubblicitarie sono coerenti e prevedibili
+ Il tuo CDN è configurato per memorizzare nella cache i manifesti SGAI in modo appropriato
+ I giocatori supportano flussi di lavoro di inserimento di annunci guidati dal server
+ Il tuo server decisionale sugli annunci è in grado di gestire le richieste in tempo reale di contenuti live

### Requisiti dei giocatori
<a name="sgai-live-player-integration"></a>

I giocatori devono essere configurati per gestire correttamente i manifesti live SGAI:
+ Support per flussi di lavoro di inserimento di annunci guidati dal server
+ Capacità di elaborare le indicazioni per l'inserimento degli annunci contenute nei manifesti
+ Gestione corretta dei tempi e della sincronizzazione dei live streaming
+ Per i contenuti HLS: Supporto per HLS versione 8 e EXT-X-DATERANGE con attributo CLASS. Versione 11 per il beaconing lato server.
+ Per i contenuti HLS: supporto per la sostituzione delle variabili EXT-X-DEFINE

## Configurazione della riproduzione dal vivo
<a name="sgai-live-playback-config"></a>

Per abilitare SGAI per i contenuti live, create una configurazione di riproduzione con le seguenti impostazioni:

**Example Configurazione della riproduzione live SGAI**  

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

Di seguito sono riportate le considerazioni chiave per la configurazione SGAI live:

`VideoContentSourceUrl`  
Deve puntare a uno streaming HLS live con marker SCTE-35 DATERANGE correttamente formattati. Lo stream deve mantenere durate dei segmenti e varianti di bitrate coerenti.

## Richieste di manifesti live SGAI
<a name="sgai-live-manifest-requests"></a>

I manifesti live SGAI utilizzano lo stesso pattern di URL utilizzato per l'inserimento di annunci tradizionali:

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

## Prefetch basato su Manifest per SGAI live
<a name="sgai-live-guided-prefetch"></a>

Per i flussi di lavoro SGAI live, puoi abilitare il battito cardiaco prefetch basato su manifesti per ridurre la latenza di riempimento degli annunci. Aggiungi alla `aws.guidedPrefetchMode=MANIFEST` richiesta del manifesto:

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

Se abilitato, MediaTailor aggiunge un identificatore di sessione (`?aws.sessionId=<id>`) come parametro di query a ciascun URL interstitial media manifest (`/v1/i-media`) nella playlist multivariante. Ogni volta che il lettore aggiorna un manifesto i-media, la richiesta riceve l'ID di sessione, che viene MediaTailor utilizzato per identificare la sessione e mettere in coda le richieste di prefetch per le prossime interruzioni pubblicitarie. MediaTailor

**Importante**  
**Non memorizzate nella cache i manifesti i-media nel vostro CDN quando utilizzate il prefetch guidato.** Il meccanismo di prefetch heartbeating dipende dal fatto che le richieste di aggiornamento del manifesto del giocatore arrivino direttamente. MediaTailor Se il CDN memorizza nella cache e fornisce `/v1/i-media` le risposte, non riceve le richieste heartbeat e MediaTailor non può attivare il prefetching. Configura il tuo CDN in modo che trasmetta le `/v1/i-media/*` richieste a quando è in uso. MediaTailor `aws.guidedPrefetchMode=MANIFEST`

La prefetch guidata è indipendente dalla modalità di reporting. Indipendentemente dal fatto che si utilizzi il tracciamento lato server (impostazione predefinita) o lato client (`aws.reportingMode=CLIENT`), i beacon si attivano al momento della riproduzione, non quando gli annunci sono preimpostati. Per informazioni generali su come funziona la prelettura degli annunci, consulta. MediaTailor [Prefetching degli annunci](prefetching-ads.md)

## Test della configurazione live di SGAI
<a name="sgai-live-testing"></a>

Verifica la tua configurazione SGAI live con questi passaggi di convalida:

1. **Generazione del manifesto di test**

   Richiedi l'URL del manifesto live SGAI e verifica che restituisca contenuti memorizzabili nella cache con istruzioni adeguate per l'inserimento degli annunci.

1. **Verifica la memorizzazione nella cache CDN**

   Verifica che il tuo CDN stia memorizzando nella cache i manifesti SGAI in base ai valori TTL configurati.

1. **Test e inserimento**

   Verifica che i giocatori siano in grado di inserire correttamente gli annunci utilizzando le indicazioni fornite nei manifesti SGAI.

1. **Monitora le prestazioni**

   Utilizza le CloudWatch metriche per verificare la riduzione del carico di origine e il miglioramento delle percentuali di accesso alla cache.