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à.

# Server-side tracciamento con inserimento di annunci guidato dal server (SGAI)
<a name="ad-reporting-server-side-sgai"></a>

*Quando utilizzi l'inserimento di annunci guidato dal server (SGAI), il tracciamento lato server utilizza un meccanismo di beaconing senza sessione che differisce dall'approccio in modalità cucita descritto sopra.* Invece di unire i segmenti degli annunci MediaTailor nel manifesto dei contenuti (dove tiene traccia delle `/v1/segment` richieste), SGAI restituisce i riferimenti agli annunci come playlist separate in una risposta all'elenco di risorse con metadati beacon incorporati negli URI degli annunci.

## Come funziona il beaconing lato server senza sessioni
<a name="ad-reporting-server-side-sgai-how-it-works"></a>

I passaggi seguenti descrivono come funziona il beaconing lato server per le sessioni SGAI:

1. **Inizializzazione della sessione**: il giocatore richiede la playlist multivariante HLS con. `aws.insertionMode=GUIDED` Server-side il reporting è l'impostazione predefinita (non è necessario alcun parametro). `aws.reportingMode` A differenza della modalità stitched, la risposta di inizializzazione della sessione *non* include un. `trackingUrl`

1. Manifesto **inseribile nella cache: MediaTailor restituisce un manifesto** memorizzabile nella cache contenente `EXT-X-DATERANGE` tag `CLASS="com.apple.hls.interstitial"` e `X-ASSET-LIST` attributi che puntano all'endpoint dell'elenco di risorse interstiziali. MediaTailor

1. **Elenco delle risorse con metadati beacon**: quando il giocatore incontra un'interruzione pubblicitaria, recupera l'elenco delle risorse. MediaTailorrestituisce una risposta JSON in cui ogni URI dell'annuncio include metadati beacon crittografati:

   ```
   {
     "ASSETS": [
       {
         "DURATION": 30.0,
         "URI": "https://cdn.example.com/ad/master.m3u8?awsBeaconData=<encrypted>&awsBeaconDomain=<MediaTailor-endpoint>&awsConfigurationName=<config-name>"
       }
     ]
   }
   ```

   *Quando il reporting lato server è attivo, la risposta non include una sezione.* `TRACKING` Gli URI degli annunci contengono tutti i dati dei beacon.

1. **Sostituzione di variabili HLS: il giocatore recupera** la playlist multivariante dell'annuncio. Il manifesto dell'annuncio utilizza le `#EXT-X-DEFINE:QUERYPARAM` direttive per passare i parametri del beacon dalla stringa di query URI agli URL dei segmenti tramite la sostituzione di variabili HLS:

   ```
   #EXTM3U
   #EXT-X-DEFINE:QUERYPARAM="awsBeaconData"
   #EXT-X-DEFINE:QUERYPARAM="awsBeaconDomain"
   #EXT-X-DEFINE:QUERYPARAM="awsConfigurationName"
   #EXTINF:5.0,
   {$awsBeaconDomain}/segment/hash/{$awsConfigurationName}/{$awsBeaconData}/0/0?aws.segmentRelativePath=asset_00001.ts
   ```

   Il player risolve le `{$awsConfigurationName}` variabili `{$awsBeaconData}``{$awsBeaconDomain}`, e utilizzando i valori della stringa di query URI del manifesto dell'annuncio, quindi richiede l'utilizzo di ogni segmento dell'annuncio. MediaTailor

1. **Beacon si attiva su richiesta del segmento**: quando il giocatore richiede ogni segmento pubblicitario, la richiesta viene inoltrata. MediaTailor Il servizio decrittografa i dati del beacon, determina la posizione del segmento all'interno dell'annuncio (impressione, primo quartile, punto intermedio, terzo quartile o completo) e invia il beacon di tracciamento VAST appropriato all'ad server. MediaTailor quindi reindirizza il giocatore al segmento di contenuto pubblicitario effettivo.

## Requisiti del giocatore per il beaconing lato server SGAI
<a name="ad-reporting-server-side-sgai-requirements"></a>

Per utilizzare il beaconing lato server con SGAI, il giocatore deve soddisfare i seguenti requisiti:
+ HLS versione 11 o successiva
+ Support per `EXT-X-DATERANGE` con `CLASS` attributo per HLS Interstitials
+ Support per la sostituzione di `#EXT-X-DEFINE:QUERYPARAM` variabili (RFC 8216bis). Il player deve decodificare in percentuale i valori dei parametri di query prima di sostituirli negli URL dei segmenti.

**Nota**  
Il beaconing lato server SGAI è attualmente supportato solo per HLS. DASH non è ancora supportato per il beaconing lato server SGAI.

## Confronto con il tracciamento lato server in modalità cucita
<a name="ad-reporting-server-side-sgai-comparison"></a>

La tabella seguente riassume in che modo il tracciamento lato server differisce tra l'inserimento di annunci cucito e quello guidato dal server:


| Aspetto | Cucito (SSAI) | Server-guided (SGAI) | 
| --- | --- | --- | 
| Memorizzabilità nella cache del manifesto | Per-session, non inseribile nella cache | Memorizzabile nella cache, condiviso tra gli spettatori | 
| Routing dei segmenti di annunci | Tramite /v1/segment/ l'utilizzo dell'ID di sessione | Tramite /v1/segment/ l'utilizzo di un blob di dati beacon crittografato | 
| Stato della sessione per i beacon | Memorizzato per sessione in MediaTailor | Senza sessione: tutto lo stato viene memorizzato nel parametro crittografato awsBeaconData | 
| URL di tracciamento all'inizio della sessione | Restituito nella risposta di inizializzazione della sessione | Non fornito: i dati beacon sono incorporati negli URI degli annunci in ogni risposta all'elenco di risorse | 
| Supporto per DASH | Supportata | Non ancora supportato | 

**Nota**  
Per le sessioni SGAI live, puoi abilitare il prefetching degli annunci basato su manifesti utilizzando. `aws.guidedPrefetchMode=MANIFEST` È separata dall'API di prefetch basata sulla pianificazione utilizzata con le sessioni stitched (SSAI). Per informazioni dettagliate, vedi [Prefetch guidato con battito cardiaco manifesto](sgai-guided-prefetch.md).