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 panoramica e implementazione dell'inserimento di annunci guidati dal server
<a name="server-guided"></a>

AWS Elemental MediaTailor L'inserimento di annunci guidato dal server (SGAI) offre un'alternativa all'inserimento di annunci sul lato server facendo riferimento agli annunci come playlist separate anziché inserirli direttamente in playlist multimediali. Questo approccio migliora le prestazioni tramite manifesti memorizzabili nella cache e consente una migliore scalabilità.

Per informazioni su come utilizzare l'inserimento di annunci guidato dal server con MediaTailor, scegli l'argomento pertinente dal seguente elenco.

## Abilita nella configurazione di riproduzione
<a name="enable-in-config"></a>

Per consentire ai giocatori di utilizzare l'inserimento di annunci guidato dal server, devi `Insertion Mode` impostarlo `PLAYER_SELECT` nella configurazione di riproduzione. MediaTailor Ciò consente ai giocatori di selezionare l'inserimento degli annunci cucito o guidato al momento dell'inizializzazione della sessione.

## Crea una sessione guidata dal server
<a name="create-guided-session"></a>

Quando crei sessioni di riproduzione, scegli la modalità guidata. Il modo per farlo dipende dal fatto che i giocatori utilizzino sessioni implicite o esplicite.

### Sessioni guidate dal server create in modo implicito
<a name="create-implicit-guided-session"></a>

Aggiungi alla richiesta di playlist `aws.insertionMode=GUIDED` multivariante HLS. Esempio:

```
playback-endpoint/v1/master/hashed-account-id/origin-id/index.m3u8?aws.insertionMode=GUIDED
```

Dove:
+ `playback-endpoint` è l'endpoint di riproduzione univoco generato da AWS Elemental MediaTailor durante la creazione della configurazione. 

  Esempio

  ```
  https://777788889999.mediatailor.us-east-1.amazonaws.com
  ```
+ `hashed-account-id`è Account AWS il tuo ID. 

  Esempio

  ```
  777788889999
  ```
+ `origin-id` è il nome assegnato durante la creazione della configurazione. 

  Esempio

  ```
  myOrigin
  ```
+ `index.m3u8`o è il nome del manifesto del flusso di test più l'estensione del file. In questo modo puoi ottenere un manifest pienamente identificato quando lo aggiungi all'origine del contenuto video configurata in [Fase 4: Creazione di una configurazione](getting-started-ad-insertion.md#getting-started-add-mapping). 

Utilizzando i valori degli esempi precedenti, i risultati completi URLs sono i seguenti.
+ Esempio:

  ```
  https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/777788889999/myOrigin/index.m3u8?aws.insertionMode=GUIDED
  ```

### Sessioni guidate dal server create in modo esplicito
<a name="create-explicit-guided-session"></a>

Aggiungi `insertionMode=GUIDED` ai metadati JSON che il player invia in HTTP all'endpoint con il prefisso di inizializzazione della `POST` sessione della MediaTailor configurazione.

L'esempio seguente mostra la struttura dei metadati JSON:

```
{
  # other keys, e.g. "adsParams"
  "insertionMode": "GUIDED"       # this can be either GUIDED or STITCHED
}
```

Con questi metadati di inizializzazione, la sessione di riproduzione utilizzerà l'inserimento di annunci guidato dal server.