A API Pod Serving fornece acesso a conjuntos de anúncios em vídeo com taxa de bits adaptável preparados para que possam ser agrupados diretamente em uma playlist de mídia HLS ou MPEG DASH voltada para o usuário.
Essa API é destinada a editores avançados e parceiros de tecnologia de vídeo. O uso dessa API em escala requer o design e a implementação de um fluxo sofisticado de veiculação de mídia, o que está fora do escopo desta documentação.
Pré-requisitos
Antes de processar uma transmissão ao vivo por meio da API DAI Podserving, você precisa criar um evento de transmissão ao vivo usando a IU do Google Ad Manager ou a API de evento ao vivo.
Componentes
Há três componentes que constituem qualquer implementação da API Pod Serving: o Google Ad Manager, um player de vídeo do cliente e um servidor de manipulação de manifesto.
Ad Manager
O Ad Manager é responsável por exibir anúncios ao usuário e pode ser gerenciado pelo SDK do Ad Manager ou pela interface da Web dele. O serviço tem estas responsabilidades:
- Recebimento de solicitações de stream do player de vídeo do cliente, toma decisões de anúncios e fornece execuções para corresponder aos seus perfis de codificação de conteúdo
- Responder a solicitações de segmento de anúncio do player de vídeo do cliente e fornecer a parte apropriada do conjunto de anúncios para um determinado usuário.
- Recebimento e processamento de pings de rastreamento do player de vídeo do cliente
Player de vídeo do cliente
O player de vídeo do cliente é o app ou site que os clientes usam para reproduzir o stream de vídeo resultante. O jogador tem estas responsabilidades:
- Inicializar um recurso de stream do Ad Manager e receber um objeto de stream que representa uma única sessão de reprodução de um evento específico de transmissão ao vivo.
- Solicitação de um manifesto de stream do servidor de manipulação de manifesto, que inicia a reprodução
- Pesquisa periódica de metadados do conjunto de anúncios do Ad Manager que descrevem os eventos de anúncios incorporados aos segmentos de anúncios do stream
- Detecte eventos de metadados com marcação de tempo gerados pelo player que contêm IDs de mídia de anúncio. Ao encontrar esses eventos, o player os encaminha ao Ad Manager para verificar se os eventos de anúncios ocorreram.
Para saber mais sobre a implementação adequada do player de vídeo do cliente, consulte o guia de veiculação de pods da sua plataforma:
Para implementações personalizadas, consulte nosso guia do cliente de veiculação de conjuntos para a API DAI.
Servidor de manipulação de manifesto
O servidor de manipulação de manifesto é o servidor encarregado de hospedar o manifesto de stream fornecido ao player de vídeo do cliente. O servidor tem estas responsabilidades:
- Como processar o envio do manifesto para o player de vídeo do cliente
- Solicitar um modelo de período do Ad Manager (somente para streams MPEG DASH) para preencher com segmentos de anúncio.
- Inserção de URLs de segmento de anúncio hospedados pelo Ad Manager no manifesto de stream de vídeo (para HLS) ou período de anúncio (para MPEG DASH) durante intervalos de anúncio.
- Exibir o manifesto modificado no player de vídeo do cliente.
Para saber mais sobre como implementar um servidor manipulador de manifesto personalizado, consulte o guia de manipulação de manifesto.
Glossário
- Evento de transmissão ao vivo: um evento que armazena dados de configuração importantes para transmissão ao vivo, como perfis de codificação. Os eventos de transmissão ao vivo são criados usando o Ad Manager.
- Objeto de stream: um objeto que representa uma única sessão de reprodução de um recurso de vídeo específico. As propriedades importantes incluem o ID do stream e o URL de verificação de mídia.
- Conjunto de anúncios: é o agrupamento de vídeos de anúncios exibidos em um intervalo de anúncio.
- Segmentos de anúncio: arquivos de segmento de mídia para o intervalo de anúncio.
- Metadados do conjunto de anúncios: metadados do intervalo de anúncio usados para renderizar a interface do anúncio no cliente. Por exemplo, ocultar botões de busca durante o anúncio.
- ID da mídia do anúncio: metadados codificados como tags ID3 em arquivos de segmento de anúncio. Esses metadados são usados para identificar quando eventos específicos relacionados a anúncios ocorreram durante a reprodução, como início ou ponto médio do anúncio.