Este guia descreve o recurso de metadados de anúncios aceito pela API Video Stitcher. Os metadados do anúncio são extraídos de um anúncio VAST em uma resposta de tag de anúncio, contendo eventos de rastreamento de anúncios e anúncios complementares. O URL da tag de anúncio é configurado na solicitação de criação da sessão. Para mais informações, consulte Gerenciar uma sessão ao vivo e Gerenciar uma sessão de VOD.
Antes de começar
Verifique se você está familiarizado com os conceitos e a terminologia introdutórias na API Video Stitcher. Para mais informações, consulte a visão geral técnica.
Introdução
Os metadados do anúncio contêm eventos de acompanhamento de anúncios e anúncios complementares associados a um anúncio costurado. Um evento de acompanhamento de anúncios contém um ping de callback usado para acompanhar o anúncio VAST e a interação do espectador. Um anúncio complementar é um anúncio que complementa o anúncio VAST principal. No modo de rastreamento do lado do cliente, você é responsável por acionar eventos com base no comportamento do espectador.
Rastreamento de anúncios do lado do servidor
No modo de rastreamento do lado do servidor, cada URI do segmento de anúncio é envolvido em um
URI de redirecionamento, e a API Video Stitcher vai processar os eventos de progresso
sempre que o player solicitar esses segmentos. No entanto, os eventos de atividade,
como pause, não são processados pela API Video Stitcher.
Rastreamento de anúncios do lado do cliente
No modo de rastreamento 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 aqueles que precisam ser acionados quando o tempo especificado tiver decorrido durante o anúncio. Por exemplo, o evento Start precisa 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 aqueles que precisam ser acionados quando um espectador realiza uma
atividade específica. Por exemplo, o evento pause precisa ser acionado quando o
espectador pausar o vídeo do anúncio. Para mais detalhes sobre eventos de atividade, consulte o
objeto de evento de atividade.
Rastreamento de anúncios do cliente VOD
Um objeto de intersticiais é retornado na resposta de uma solicitação de criação de sessão de VOD. Para instruções sobre como criar uma sessão VOD, consulte Criar uma sessão VOD.
Os intersticiais contêm os metadados de cada anúncio inserido. Quando o modo de rastreamento de anúncios do cliente está ativado, o cliente é responsável por acionar eventos de rastreamento quando necessário. Para mais detalhes, consulte o objeto de intersticiais.
Acompanhamento de anúncios do cliente em tempo real
A API Video Stitcher insere anúncios continuamente em uma transmissão ao vivo. As informações de metadados do anúncio são geradas sempre que um novo anúncio é inserido.
No HLS, o AdMetadataURI para buscar metadados de anúncios pode ser encontrado na
tag #EXT-X-DATERANGE.
No DASH, o AdMetadataURI para buscar metadados de anúncios pode ser encontrado no
elemento <EventStream> para cada elemento <Period>.
Para mais detalhes, consulte como lidar com o acompanhamento em tempo real do lado do cliente.
Anúncios complementares
Os anúncios complementares são anúncios suplementares que podem aparecer com anúncios lineares inseridos. Para mais detalhes, consulte o objeto de anúncios complementares.
A seguir
- Saiba como concluir tarefas da API Video Stitcher específicas.