As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Server-side rastreamento com inserção de anúncios guiada pelo servidor (SGAI)
<a name="ad-reporting-server-side-sgai"></a>

Quando você usa a inserção de anúncios guiada pelo servidor (SGAI), o rastreamento do lado do servidor usa um mecanismo de sinalização *sem sessão que difere da abordagem de modo combinado descrita* acima. Em vez de MediaTailor unir segmentos de anúncios ao manifesto de conteúdo (onde rastreia `/v1/segment` solicitações), o SGAI retorna referências de anúncios como playlists separadas em uma resposta da lista de ativos com metadados de beacon incorporados aos URIs do anúncio.

## Como funciona o beaconing do lado do servidor sem sessão
<a name="ad-reporting-server-side-sgai-how-it-works"></a>

As etapas a seguir descrevem como o beaconing do lado do servidor funciona nas sessões do SGAI:

1. **Inicialização da sessão**: o player solicita a playlist multivariante HLS com. `aws.insertionMode=GUIDED` Server-side o relatório é o padrão (nenhum `aws.reportingMode` parâmetro é necessário). Ao contrário do modo costurado, a resposta de inicialização da sessão *não* inclui um. `trackingUrl`

1. Manifesto **armazenável em cache: MediaTailor retorna um manifesto** armazenável em cache contendo `EXT-X-DATERANGE` tags `CLASS="com.apple.hls.interstitial"` e `X-ASSET-LIST` atributos apontando para o endpoint da lista de ativos MediaTailor intersticiais.

1. **Lista de ativos com metadados de beacon**: quando o jogador encontra uma pausa no anúncio, ele busca a lista de ativos. MediaTailorretorna uma resposta JSON em que cada URI do anúncio inclui metadados de beacon criptografados:

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

   Quando os relatórios do lado do servidor estão ativos, a resposta *não* inclui uma seção. `TRACKING` Os URIs do anúncio carregam todos os dados do beacon.

1. **Substituição da variável HLS**: o player busca a playlist multivariante do anúncio. O manifesto publicitário usa `#EXT-X-DEFINE:QUERYPARAM` diretivas para transmitir os parâmetros do beacon da string de consulta do URI para os URLs do segmento por meio da substituição da variável 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
   ```

   O player resolve as `{$awsConfigurationName}` variáveis`{$awsBeaconData}`,`{$awsBeaconDomain}`, e usando os valores da string de consulta do URI do manifesto do anúncio e, em seguida, solicita cada segmento do anúncio por meio MediaTailor de.

1. **Sinalizador acionado por solicitação de segmento**: à medida que o player solicita cada segmento de anúncio, a solicitação é encaminhada. MediaTailor O serviço decifra os dados do beacon, determina a posição do segmento no anúncio (impressão, primeiro quartil, ponto médio, terceiro quartil ou completo) e dispara o farol de rastreamento VAST apropriado para o servidor de anúncios. MediaTailor em seguida, redireciona o player para o segmento real do conteúdo do anúncio.

## Requisitos do jogador para beaconing do lado do servidor SGAI
<a name="ad-reporting-server-side-sgai-requirements"></a>

Para usar o beaconing do lado do servidor com o SGAI, seu player deve atender aos seguintes requisitos:
+ HLS versão 11 ou posterior
+ Support for `EXT-X-DATERANGE` with `CLASS` attribute for HLS Interstitials
+ Support para substituição de `#EXT-X-DEFINE:QUERYPARAM` variáveis (RFC 8216bis). O player deve decodificar em porcentagem os valores dos parâmetros de consulta antes de substituí-los em URLs de segmentos.

**nota**  
Atualmente, o beaconing do lado do servidor SGAI é compatível somente com HLS. O DASH ainda não é compatível com o beaconing do lado do servidor SGAI.

## Comparação com o rastreamento do lado do servidor em modo combinado
<a name="ad-reporting-server-side-sgai-comparison"></a>

A tabela a seguir resume como o rastreamento do lado do servidor difere entre a inserção de anúncios agrupados e a inserção guiada pelo servidor:


| Aspecto | Costurado (SSAI) | Server-guided (SGAI) | 
| --- | --- | --- | 
| Capacidade de armazenamento em cache do manifesto | Per-session, não pode ser armazenado em cache | Armazenável em cache, compartilhado entre os espectadores | 
| Roteamento de segmentos de anúncios | Por meio do /v1/segment/ uso do ID da sessão | /v1/segment/Usando um blob de dados de beacon criptografado | 
| Estado da sessão para beacons | Armazenado por sessão em MediaTailor | Sem sessão — todo o estado é transmitido no parâmetro criptografado awsBeaconData | 
| URL de rastreamento no início da sessão | Retornado na resposta de inicialização da sessão | Não fornecido — os dados do beacon são incorporados em URIs de anúncios em cada resposta da lista de ativos | 
| Suporte para DASH | Compatível | Sem suporte no momento | 

**nota**  
Para sessões ao vivo do SGAI, você pode ativar a pré-busca de anúncios baseada em manifestos usando. `aws.guidedPrefetchMode=MANIFEST` Isso é separado da API de pré-busca baseada em agendamento usada com sessões agrupadas (SSAI). Para obter detalhes, consulte [Pré-busca guiada com batimento cardíaco manifesto](sgai-guided-prefetch.md).