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 visão geral e implementação da inserção de anúncios guiada pelo servidor
AWS Elemental MediaTailor a inserção de anúncios guiada pelo servidor (SGAI) fornece uma alternativa à inserção de anúncios no lado do servidor, referenciando anúncios como playlists separadas, em vez de agrupá-los diretamente em playlists de mídia. Essa abordagem melhora o desempenho por meio de manifestos armazenáveis em cache e permite melhor escalabilidade.
Para obter informações sobre como usar a inserção de anúncios guiada pelo servidor com MediaTailor, escolha o tópico aplicável na lista a seguir.
## Ativar na configuração de reprodução
Para permitir que os jogadores usem a inserção de anúncios guiada pelo servidor, você deve definir como `PLAYER_SELECT` na configuração de `Insertion Mode` reprodução. MediaTailor Isso permite que os jogadores selecionem a inserção de anúncios costurados ou guiados no momento da inicialização da sessão.
## Crie uma sessão guiada pelo servidor
Ao criar sessões de reprodução, escolha o modo guiado. A maneira de fazer isso depende se seus jogadores usam sessões implícitas ou explícitas.
### Sessões guiadas pelo servidor criadas implicitamente
Anexe `aws.insertionMode=GUIDED` à solicitação de playlist multivariante do HLS. Exemplo:
```
playback-endpoint/v1/master/hashed-account-id/origin-id/index.m3u8?aws.insertionMode=GUIDED
```
Em que:
+ `playback-endpoint` é o endpoint de reprodução exclusivo gerado pelo AWS Elemental MediaTailor quando a configuração foi criada.
Exemplo
```
https://777788889999.mediatailor.us-east-1.amazonaws.com
```
+ `hashed-account-id`é o seu Conta da AWS ID.
Exemplo
```
777788889999
```
+ `origin-id` é o nome dado quando se cria a configuração.
Exemplo
```
myOrigin
```
+ `index.m3u8`ou é o nome do manifesto do fluxo de teste mais sua extensão de arquivo. Defina isso para que você obtenha um manifesto totalmente identificado ao anexá-lo à origem do conteúdo do vídeo configurada em [Etapa 4: Criar uma configuração](getting-started-ad-insertion.md#getting-started-add-mapping).
Usando os valores dos exemplos anteriores, os valores completos URLs são os seguintes.
+ Exemplo:
```
https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/777788889999/myOrigin/index.m3u8?aws.insertionMode=GUIDED
```
### Sessões guiadas pelo servidor criadas explicitamente
Adicione `insertionMode=GUIDED` aos metadados JSON que o player envia no HTTP `POST` para o endpoint do prefixo de MediaTailor inicialização da sessão da configuração.
O exemplo a seguir mostra a estrutura dos metadados JSON:
```
{
# other keys, e.g. "adsParams"
"insertionMode": "GUIDED" # this can be either GUIDED or STITCHED
}
```
Com esses metadados de inicialização, a sessão de reprodução usará a inserção de anúncios guiada pelo servidor.
# Rastreamento de anúncios com o SGAI
O SGAI oferece suporte ao rastreamento de anúncios do lado do servidor e do lado do cliente. Você define o modo de relatório na inicialização da sessão. O modo não pode mudar durante a sessão.
Rastreamento do lado do servidor (padrão)
MediaTailor dispara sinais VAST automaticamente quando o jogador solicita segmentos de anúncios. O anúncio URIs na lista de ativos contém metadados de beacon criptografados (`awsBeaconData`,,`awsBeaconDomain`). `awsConfigurationName` O jogador deve suportar a substituição de `#EXT-X-DEFINE:QUERYPARAM` variáveis HLS. A resposta da lista de ativos não inclui uma `TRACKING` seção.
Para obter detalhes sobre como o beaconing do lado do servidor SGAI funciona, consulte. [Rastreamento do lado do servidor com inserção de anúncios guiada pelo servidor (SGAI)](ad-reporting-server-side-sgai.md)
Rastreamento do lado do cliente
Adicione `aws.reportingMode=CLIENT` à sua solicitação de inicialização da sessão. A resposta da lista de ativos inclui uma `TRACKING` seção com um farol URLs que o player aciona durante a reprodução do anúncio. O endpoint `GetTracking` da API *não* é usado para sessões do SGAI. Em vez disso, cada resposta da lista de ativos inclui dados de rastreamento diretamente. Os dados de rastreamento usam o mesmo esquema JSON da resposta de rastreamento de inserção de anúncios no lado do servidor (SSAI).
Para obter detalhes, consulte [Inserção de anúncios guiada pelo servidor](ad-reporting-client-side.md#ad-reporting-client-side-best-practices-sgai).
# Pré-busca guiada com batimento cardíaco manifesto
Para transmissões ao vivo do SGAI, você pode ativar a pré-busca de anúncios baseada em manifestos adicionando `aws.guidedPrefetchMode=MANIFEST` à sua solicitação de inicialização de sessão:
```
https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/777788889999/myOrigin/index.m3u8?aws.insertionMode=GUIDED&aws.guidedPrefetchMode=MANIFEST
```
Quando ativado, MediaTailor anexa um identificador de sessão (`?aws.sessionId=`) 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 enfileirar solicitações de busca prévia para os próximos intervalos publicitários.
+ O `aws.guidedPrefetchMode` parâmetro aceita dois valores: `MANIFEST` (ativado) e `OFF` (desativado, padrão).
+ O modo de pré-busca guiada só é válido para sessões do SGAI. Usá-lo com sessões costuradas retorna um erro.
+ O DASH ainda não oferece suporte ao modo de pré-busca guiada.
+ A pré-busca guiada é independente do modo de relatório — os beacons são acionados no momento da reprodução, não no momento da pré-busca.
+ **Não armazene em cache os manifestos i-media em sua CDN ao usar a pré-busca guiada.** O mecanismo de pré-busca depende das solicitações de atualização do manifesto do jogador chegarem diretamente. MediaTailor Se sua CDN armazena `/v1/i-media` respostas em cache, MediaTailor não recebe as solicitações de pulsação e não pode acionar a pré-busca.
# MediaTailor matriz de compatibilidade de recursos de inserção de anúncios guiada por servidor
AWS Elemental MediaTailor oferece dois métodos de inserção de anúncios com compatibilidade de recursos diferentes. A inserção de anúncios guiada pelo servidor funciona de forma diferente da inserção de anúncios no servidor, o que afeta a compatibilidade com alguns recursos. MediaTailor Use essa tabela para entender quais recursos funcionam com cada método de inserção de anúncios.
**Compatibilidade de recursos por método de inserção de anúncios**
| Recurso | Inserção de anúncios no lado do servidor (SSAI) | Inserção de anúncios guiada pelo servidor (SGAI) |
| --- | --- | --- |
| Pré-busca de anúncios | ✓ Suportado | Sem suporte no momento |
| Supressão de anúncios | ✓ Suportado | Não aplicável |
| Pré-lançamento e comportamento | Controlado pela MediaTailor configuração | Controlado pela MediaTailor configuração |
| Rastreamento de anúncios do lado do cliente | Usa GetTracking API | TRACKINGSeção de usos na lista de ativos (a GetTracking API não é usada) |
| Rastreamento de anúncios do lado do servidor | ✓ Compatível — os beacons são acionados com base em /v1/segment solicitações usando o ID da sessão | ✓ Compatível (somente HLS) — usa beaconing sem sessão com dados de beacon criptografados incorporados ao ad via. URIs \$1EXT-X-DEFINE:QUERYPARAM Requer HLS v11 ou posterior. O DASH ainda não é suportado. |
| Decoração de ID de anúncio | ✓ Suportado | ✗ Não compatível |
## Detalhes de compatibilidade
### Pré-busca de anúncios
No momento, a pré-busca de anúncios não é suportada.
### Supressão de anúncios
A supressão de anúncios não é compatível com os métodos de inserção de anúncios guiados pelo servidor porque os jogadores só buscam os anúncios que vão reproduzir.
### Pré-lançamento e comportamento
O pré-lançamento e o tempo funcionam de forma diferente entre os métodos de inserção:
+ **Inserção de anúncios no servidor:** MediaTailor controla quando os anúncios pré-lançados são reproduzidos com base nas configurações
+ **Inserção de anúncios guiada pelo servidor: MediaTailor insere** anúncios pré-lançados na parte superior do manifesto. Seu player mostra esses anúncios primeiro e depois inicia seu conteúdo
### Acompanhamento de anúncios
O **rastreamento do lado do cliente** usa mecanismos diferentes, dependendo do método de inserção do anúncio:
+ **Inserção de anúncios no lado do servidor (SSAI)**: usa o endpoint da API `GetTracking`
+ **Inserção de anúncios guiada pelo servidor (SGAI):** MediaTailor fornece informações de rastreamento na `TRACKING` seção de cada resposta da lista de ativos. O endpoint `GetTracking` da API não é usado. A resposta de inicialização da sessão não inclui um`trackingUrl`.
O **rastreamento do lado do servidor** também difere entre os métodos:
+ **Inserção de anúncios no lado do servidor (SSAI):** MediaTailor dispara beacons quando o player busca segmentos de anúncios agrupados usando o ID da sessão. `/v1/segment/`
+ **Inserção de anúncios guiada pelo servidor (SGAI): usa beaconing** sem sessão. MediaTailor MediaTailor incorpora dados de beacon criptografados (`awsBeaconData`,`awsBeaconDomain`,`awsConfigurationName`) no manifesto publicitário URIs que eles retornam na lista de ativos. O manifesto do anúncio usa `#EXT-X-DEFINE:QUERYPARAM` tags para que o player substitua esses valores em um segmento URLs. Quando o player solicita cada segmento do anúncio, MediaTailor decifra os dados, dispara o beacon apropriado e redireciona para o segmento de conteúdo. Quando os relatórios do lado do servidor estão ativos, MediaTailor omite a `TRACKING` seção da resposta da lista de ativos. Para obter detalhes, consulte [Rastreamento do lado do servidor com inserção de anúncios guiada pelo servidor (SGAI)](ad-reporting-server-side-sgai.md).
### Decoração de ID de anúncio
A decoração do Ad-ID não é compatível com a inserção de anúncios guiada pelo servidor porque os campos que preenchem os X-AD-CREATIVE-SIGNALING cabeçalhos só são conhecidos quando a lista de ativos é buscada, não quando o manifesto é escrito.
# MediaTailor configuração de inserção de anúncios guiada por servidor para transmissões ao vivo
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
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
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
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
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
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=`) 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
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.
# MediaTailor configuração de inserção de anúncios guiada pelo servidor para conteúdo VOD
AWS Elemental MediaTailor a inserção de anúncios guiada por servidor para conteúdo VOD oferece benefícios significativos de desempenho por meio de manifestos altamente armazenáveis em cache e processamento reduzido do servidor. A configuração do SGAI para conteúdo VOD aproveita a natureza estática dos video-on-demand ativos para maximizar a eficiência do armazenamento em cache e minimizar as solicitações de origem, tornando-o ideal para grandes bibliotecas de conteúdo com padrões de visualização repetidos.
## Requisitos para VOD SGAI
Antes de habilitar o SGAI para conteúdo VOD, verifique se você tem o seguinte:
+ Seu conteúdo VOD inclui marcadores de anúncios formatados corretamente (SCTE-35 ou metadados cronometrados)
+ O conteúdo é armazenado em uma origem confiável com disponibilidade consistente
+ Seu CDN está configurado para armazenar em cache os manifestos SGAI com os valores TTL apropriados
+ 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 metadados e segmentação específicos de VOD
### Requisitos do jogador
Os jogadores devem estar configurados para lidar com manifestos VOD do SGAI e inserção de anúncios:
+ 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 de VOD
+ Support para inserção de anúncios do lado do cliente durante a reprodução de VOD
+ Tratamento adequado das operações de busca em intervalos publicitários
+ Support para duração do conteúdo e rastreamento de posição
## Configuração de reprodução de VOD
Para habilitar o SGAI para conteúdo VOD, crie uma configuração de reprodução com as seguintes configurações:
**Example Configuração de reprodução SGAI VOD**
```
{
"Name": "VODSGAIConfig",
"VideoContentSourceUrl": "https://your-vod-origin.com/content/",
"AdDecisionServerUrl": "https://your-ads.com/ads",
"PersonalizationThresholdSeconds": 5,
"InsertionMode": "PLAYER_SELECT"
}
```
A seguir estão as principais considerações para a configuração do VOD SGAI:
`VideoContentSourceUrl`
Deve apontar para sua biblioteca de conteúdo VOD com padrões de URL consistentes. Garanta que a origem possa lidar com o volume esperado de solicitações e forneça uma entrega confiável de conteúdo.
`ConfigurationAliases`
Inclua parâmetros específicos do VOD, como duração do conteúdo, gênero ou informações da série, que podem ser usados para segmentação de anúncios sem afetar a capacidade de armazenamento em cache do manifesto.
`ManifestProcessingRules`
Ative a passagem do marcador de anúncios para preservar as informações de tempo do conteúdo original, o que é especialmente importante para conteúdo VOD com posições predefinidas de interrupção do anúncio.
## Solicitações de manifesto SGAI VOD
Os manifestos VOD do SGAI usam o mesmo padrão de URL (inserção tradicional de anúncios VOD).
```
https://your-config.mediatailor.region.amazonaws.com/v1/master/config-name/content-path/manifest.m3u8?aws.insertionMode=GUIDED
```
## Segmentação de anúncios específica para VOD
O conteúdo VOD oferece oportunidades exclusivas de segmentação de anúncios:
### Segmentação por metadados de conteúdo
Aproveite os metadados de conteúdo VOD para melhorar a segmentação de anúncios:
+ **Gênero e categoria:** segmente anúncios com base no tipo de conteúdo (drama, comédia, documentário)
+ **Classificação do conteúdo:** garanta um conteúdo de anúncio adequado à idade (classificações G, PG, R)
+ **Séries e temporadas:** segmente anúncios para continuidade da série ou conteúdo relacionado
+ **Data de lançamento:** meta com base na idade do conteúdo (novos lançamentos versus conteúdo do catálogo)
+ **Duração do conteúdo:** ajuste a carga do anúncio com base no tamanho total do conteúdo
### Visualizando a segmentação por contexto
Os padrões de visualização de VOD permitem a segmentação contextual de anúncios:
+ **Hora do dia:** segmente anúncios com base em quando o conteúdo está sendo assistido
+ **Assistir compulsivamente:** ajuste a frequência dos anúncios para usuários que assistem a vários episódios
+ **Taxa de conclusão:** meta com base nos padrões históricos de conclusão do conteúdo do usuário
+ **Tipo de dispositivo:** otimize os formatos de anúncio para o dispositivo de visualização (TV, celular, tablet)
## Testando a configuração do SGAI VOD
Verifique a configuração do SGAI VOD com estas etapas de validação:
1. **Geração de manifesto de teste**
Solicite o manifesto SGAI VOD URLs para diferentes tipos de conteúdo e verifique se eles retornam 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 de TTL configurados e alcançando altas taxas de acerto do cache.
1. **Teste e inserção**
Confirme se os jogadores conseguem inserir anúncios com sucesso usando as orientações fornecidas nos manifestos do SGAI para vários conteúdos de VOD.
1. **Operações de busca de testes**
Verifique se a busca no conteúdo VOD funciona corretamente em intervalos publicitários e mantém a posição de reprodução adequada.
1. **Monitore o desempenho**
Use CloudWatch métricas para verificar a redução da carga de origem, melhores taxas de acerto do cache e taxas de inserção de anúncios bem-sucedidas.
### Principais cenários de teste
Teste esses cenários específicos de VOD:
+ **Conteúdo popular:** verifique as altas taxas de acerto do cache para ativos de VOD acessados com frequência
+ **Conteúdo de formato longo:** teste a inserção de anúncios em filmes ou episódios longos com vários intervalos publicitários
+ **Conteúdo da série:** verifique a segmentação consistente de anúncios em todos os episódios de uma série
+ **Gêneros diferentes:** teste a segmentação de anúncios com base nos metadados e no gênero do conteúdo
## Melhores práticas de otimização do VOD SGAI
Otimize sua implementação do SGAI VOD para obter o máximo desempenho:
### Otimização de cache
+ **Maximize os valores de TTL:** use durações de cache mais longas para manifestos de VOD, pois o conteúdo não muda
+ **Minimize as chaves de cache:** reduza as variações das chaves de cache para melhorar as taxas de acerto
+ **Pré-aqueça conteúdo popular:** manifestos de cache para conteúdo VOD popular ou em destaque
+ **Monitore o desempenho do cache:** acompanhe as taxas de acerto do cache e otimize com base nos padrões de uso
### Otimização da entrega de conteúdo
+ **Padrões de URL consistentes:** use estruturas de URL previsíveis para melhorar o armazenamento em cache
+ **Padronização de metadados:** garanta metadados de conteúdo consistentes para uma segmentação confiável de anúncios
+ Posicionamento do **intervalo do anúncio: otimize o posicionamento** do intervalo do anúncio para transições naturais de conteúdo
+ **Variantes de qualidade:** garanta que o SGAI funcione em todas as variantes de taxa de bits do seu conteúdo VOD