Este guia descreve a funcionalidade de metadados de anúncios suportada pela API Video Stitcher. Os metadados dos anúncios são extraídos de um anúncio VAST numa resposta da etiqueta do anúncio, que contém eventos de acompanhamento de anúncios e anúncios complementares. O URL da etiqueta do anúncio está configurado no pedido de criação da sessão. Para mais informações, consulte os artigos Faça a gestão de uma sessão em direto e Faça a gestão de uma sessão de VOD.
Antes de começar
Certifique-se de que conhece os conceitos introdutórios e a terminologia da API Video Stitcher. Para mais informações, consulte a vista geral técnica.
Introdução
Os metadados de anúncios contêm eventos de acompanhamento de anúncios e anúncios complementares associados a um anúncio unido. Um evento de acompanhamento de anúncios contém um ping de retorno de chamada usado para acompanhar o anúncio VAST e a interação do visitante. Um anúncio associado é um anúncio que complementa o anúncio VAST principal. No modo de acompanhamento do lado do cliente, é responsável por acionar eventos com base no comportamento do visitante.
Acompanhamento de anúncios do lado do servidor
No modo de acompanhamento do lado do servidor, cada URI do segmento de anúncio é envolvido num URI de redirecionamento, e a API Video Stitcher processa os eventos de progresso sempre que o leitor pede esses segmentos. No entanto, os eventos de atividade, como pause, não são processados pela API Video Stitcher.
Acompanhamento de anúncios do lado do cliente
No modo de acompanhamento do lado do cliente, o cliente é responsável por acionar os eventos. Para mais detalhes, consulte a documentação de eventos.
Os eventos de progresso são eventos que devem ser acionados quando o tempo especificado decorreu durante o anúncio. Por exemplo, o evento Start deve ser acionado no início do anúncio. Para mais detalhes sobre eventos de progresso, consulte o objeto de evento de progresso.
Os eventos de atividade são eventos que devem ser acionados quando um visitante realiza uma atividade específica. Por exemplo, o evento pause deve ser acionado quando o visitante pausa o vídeo do anúncio. Para mais detalhes sobre eventos de atividade, consulte o
objeto de evento de atividade.
Acompanhamento de anúncios do lado do cliente de VOD
É devolvido um objeto de anúncios intercalares na resposta de um pedido de criação de sessão de VOD. Para ver instruções sobre como criar uma sessão de VOD, consulte o artigo sobre como criar uma sessão de VOD.
Os anúncios intersticiais contêm os metadados de cada anúncio inserido. Quando o modo de acompanhamento de anúncios do cliente está ativado, o cliente é responsável por acionar eventos de acompanhamento quando necessário. Para mais detalhes, consulte o objeto de anúncios intercalares.
Acompanhamento de anúncios do lado do cliente em direto
A API Video Stitcher insere continuamente anúncios numa transmissão em direto. As informações de metadados de anúncios são geradas sempre que um novo anúncio é inserido.
Para HLS, o AdMetadataURI para obter metadados de anúncios pode ser encontrado na etiqueta #EXT-X-DATERANGE.
Para DASH, o AdMetadataURI para obter metadados de anúncios pode ser encontrado no elemento <EventStream> para cada elemento <Period>.
Para mais detalhes, consulte como processar o acompanhamento do lado do cliente em direto.
Anúncios associados
Os anúncios associados são anúncios suplementares que podem ser apresentados juntamente com anúncios lineares inseridos. Para ver mais detalhes, consulte o objeto de anúncios associados.
O que se segue?
- Saiba como concluir tarefas específicas da API Video Stitcher.