

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

# MediaTailor configuração de inserção de anúncios guiada por servidor para transmissões ao vivo
<a name="sgai-live-configuration"></a>

AWS Elemental MediaTailor a inserção de anúncios guiada pelo servidor para conteúdo ao vivo oferece benefícios significativos de desempenho por meio de manifestos que podem ser armazenados em cache. A configuração do SGAI para conteúdo ao vivo usa os mesmos parâmetros principais do VOD, com considerações específicas para as características da transmissão ao vivo e processamento em tempo real.

## Requisitos para SGAI ao vivo
<a name="sgai-live-requirements"></a>

Antes de ativar o SGAI para conteúdo ao vivo, verifique se você tem o seguinte:
+ Sua transmissão ao vivo inclui marcadores DATERANGE formatados corretamente
+ As durações dos intervalos publicitários são consistentes e previsíveis
+ Seu CDN está configurado para armazenar em cache os manifestos SGAI de forma adequada
+ Os jogadores oferecem suporte a fluxos de trabalho de inserção de anúncios guiados pelo servidor
+ Seu servidor de decisão de anúncios pode lidar com solicitações em tempo real de conteúdo ao vivo

### Requisitos do jogador
<a name="sgai-live-player-integration"></a>

Os jogadores devem estar configurados para lidar adequadamente com os manifestos ao vivo do SGAI:
+ Support para fluxos de trabalho de inserção de anúncios guiados pelo servidor
+ Capacidade de processar orientações de inserção de anúncios a partir de manifestos
+ Tratamento adequado do tempo e sincronização da transmissão ao vivo
+ Para conteúdo HLS: Support para HLS versão 8 e EXT-X-DATERANGE com o atributo CLASS. Versão 11 para beaconing do lado do servidor.
+ Para conteúdo HLS: suporte à substituição de EXT-X-DEFINE variáveis

## Configuração de reprodução ao vivo
<a name="sgai-live-playback-config"></a>

Para habilitar o SGAI para conteúdo ao vivo, crie uma configuração de reprodução com as seguintes configurações:

**Example Configuração de reprodução ao vivo do SGAI**  

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

A seguir estão as principais considerações para a configuração ativa do SGAI:

`VideoContentSourceUrl`  
Deve apontar para um fluxo HLS ao vivo com marcadores SCTE-35 DATERANGE formatados corretamente. O stream deve manter durações de segmentos e variantes de taxa de bits consistentes.

## Solicitações de manifesto ao vivo do SG
<a name="sgai-live-manifest-requests"></a>

Os manifestos ativos do SGAI usam o mesmo padrão de URL da inserção tradicional de anúncios:

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

## Pré-busca baseada em manifesto para SGAI ao vivo
<a name="sgai-live-guided-prefetch"></a>

Para fluxos de trabalho SGAI ativos, você pode ativar o heartbeating de pré-busca baseado em manifesto para reduzir a latência de preenchimento de anúncios. Adicione `aws.guidedPrefetchMode=MANIFEST` à solicitação do manifesto:

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

Quando ativado, MediaTailor anexa um identificador de sessão (`?aws.sessionId=<id>`) como parâmetro de consulta a cada URL de manifesto de mídia intersticial (`/v1/i-media`) na playlist multivariante. Sempre que o player atualiza um manifesto i-media, a solicitação chega MediaTailor com o ID da sessão, que é MediaTailor usado para identificar a sessão e enfileirar solicitações de pré-busca para os próximos intervalos publicitários.

**Importante**  
**Não armazene em cache os manifestos i-media em sua CDN ao usar a pré-busca guiada.** O mecanismo de pulsação prévia depende das solicitações de atualização do manifesto do jogador chegarem diretamente. MediaTailor Se sua CDN armazena em cache e fornece `/v1/i-media` respostas, MediaTailor não recebe as solicitações de pulsação e não pode acionar a pré-busca. Configure sua CDN para transmitir `/v1/i-media/*` solicitações até MediaTailor quando `aws.guidedPrefetchMode=MANIFEST` estiver em uso.

A pré-busca guiada é independente do modo de relatório. Se você usa o rastreamento do lado do servidor (padrão) ou do lado do cliente (`aws.reportingMode=CLIENT`), os beacons são acionados no momento da reprodução, não quando os anúncios são pré-buscados. Para obter informações gerais sobre como a pré-busca de anúncios funciona em MediaTailor. [Pré-busca de anúncios](prefetching-ads.md)

## Testando a configuração ativa do SGAI
<a name="sgai-live-testing"></a>

Verifique sua configuração ao vivo do SGAI com estas etapas de validação:

1. **Geração de manifesto de teste**

   Solicite o URL do manifesto ativo do SGAI e verifique se ele retorna conteúdo armazenável em cache com a orientação adequada de inserção de anúncios.

1. **Verifique o cache do CDN**

   Verifique se sua CDN está armazenando em cache os manifestos SGAI de acordo com os valores TTL configurados.

1. **Teste e inserção**

   Confirme se os jogadores conseguem inserir anúncios com sucesso usando as orientações fornecidas nos manifestos do SGAI.

1. **Monitore o desempenho**

   Use CloudWatch métricas para verificar a redução da carga de origem e as melhores taxas de acerto do cache.