Com a API DAI Ad Break, você pode criar e gerenciar os dados de tempo e segmentação de anúncios dos próximos intervalos de anúncio nas suas transmissões ao vivo.
Com a API DAI Ad Break, você pode:
- Melhorar a taxa de preenchimento de anúncios durante o pico de tráfego: dê aos serviços de DAI mais tempo para selecionar os anúncios de maior rendimento para seus eventos ao vivo. Recomendamos a API DAI Ad Break quando seus eventos de transmissão ao vivo têm alta simultaneidade, tags de anúncio dinâmicas ou anúncios de alta latência.
- Controle total dos intervalos de anúncio: crie, atualize e exclua intervalos de anúncio com antecedência, oferecendo mais flexibilidade do que a sinalização de anúncios no manifesto e uma taxa de preenchimento maior para a veiculação de conjuntos em comparação com a decisão em tempo real.
- Ofereça uma experiência de visualização sem interrupções: minimize os erros de reprodução relacionados a anúncios, como pods de anúncios com preenchimento insuficiente ou excessivo, fornecendo informações precisas sobre os intervalos.
Neste guia, descrevemos os métodos da API DAI Ad Break e explicamos o ciclo de vida do intervalo de anúncio para os fluxos de serviço completo e veiculação de conjunto de anúncios da DAI.
Conhecer os métodos da API DAI de intervalo de anúncio
A API expõe os seguintes métodos padrão para gerenciar recursos
AdBreak:
Create: define uma nova entidadeAdBreakpara uma entidadeLiveStreamEvent. Se quiser, defina a propriedadeexpectedStartTimepara programar uma decisão de anúncio para começar até 60 segundos antes do início do intervalo de anúncio.Get: recupera os detalhes de uma entidadeAdBreakespecífica, incluindo o estado do intervalo de anúncio e os metadados de tempo.List: retorna uma lista de entidadesAdBreakcriadas anteriormente com a API para uma determinada entidadeLiveStreamEvent, classificadas em ordem cronológica reversa. A API não retorna intervalos de anúncio definidos apenas no manifesto do stream de conteúdo.Update: modifica uma entidadeAdBreakantes do início da decisão de anúncio.Delete: cancela a decisão de anúncio de uma entidadeAdBreakcriada anteriormente.
Entender o ciclo de vida do intervalo de anúncio
Uma entidade AdBreak tem os seguintes estados:
BREAK_STATE_UNSPECIFIED: o estado padrão.BREAK_STATE_SCHEDULED: o intervalo de anúncio foi criado e programado para a decisão de anúncio.BREAK_STATE_DECISIONED: os serviços de DAI iniciaram o processo de seleção de anúncios para o intervalo de anúncio. Não é possível modificar o intervalo de anúncio, mas você ainda pode cancelá-lo, o que pode ter efeitos adversos nos servidores de anúncios.
BREAK_STATE_COMPLETE: o intervalo de anúncio foi veiculado para os usuários.BREAK_STATE_EXPIRED: o intervalo de anúncio expirou antes da veiculação. Aplicável somente quando você ativa a programação de vários intervalos no evento de transmissão ao vivo. Para mais detalhes, consulte Configurações de intervalo de anúncio intermediário. Por padrão, os intervalos de anúncio expiram 30 minutos após o valor do campoexpectedStartTimeou 30 minutos após o início da decisão, se você não definir o campoexpectedStartTime. É possível personalizar essa duração usando o campoexpireDuration.
O diagrama a seguir mostra a linha do tempo de uma entidade AdBreak, da criação
à conclusão.

É possível criar uma entidade AdBreak de 1 a 300 minutos antes do início previsto do intervalo de anúncio.
- Evite criar um intervalo de anúncio menos de um minuto antes do horário de início esperado, porque a DAI do Google pode não ter tempo suficiente para tomar decisões de anúncio, o que resulta em uma taxa de preenchimento do anúncio mais baixa.
- Evite criar um intervalo de anúncio mais de 6 horas antes do horário de início esperado, já que os servidores de anúncios podem invalidar os anúncios solicitados.
As seções a seguir abordam as transições de estado do intervalo de anúncio nos fluxos de serviço completo e de veiculação de conjunto da DAI.
Entender o fluxo da DAI com serviço completo
A DAI com serviço completo do Google gerencia o manifesto de conteúdo e os pods de anúncios.
Para segmentação de anúncios personalizada, use a API DAI Ad Break para criar uma entidade AdBreak antes do marcador de intervalo de anúncio correspondente no manifesto de transmissão ao vivo de conteúdo.
- Esse tempo de lead permite que os serviços de DAI do Google usem seus dados de
AdBreakpara a decisão de anúncio. - Quando a DAI do Google detecta o marcador de anúncio do manifesto, o sistema usa decisões de anúncios com os dados da entidade
AdBreake faz a transição do estado da entidade paraBREAK_STATE_COMPLETE.
Ao ativar a programação de vários intervalos no evento de transmissão ao vivo, é possível definir o campo matchParams em uma entidade AdBreak. Esse processo permite que a DAI do Google faça a correspondência entre os marcadores de anúncio de manifesto detectados e os intervalos de anúncio no estado BREAK_STATE_SCHEDULED ou BREAK_STATE_DECISIONED.

Entender o fluxo de veiculação de pods
Nesse fluxo, você gerencia o manifesto da transmissão ao vivo de conteúdo ou usa um serviço de manipulação de manifesto terceirizado para detectar os marcadores de anúncio no manifesto.
Chame a API DAI Ad Break antes do horário de início esperado do intervalo de anúncio para criar uma entidade AdBreak antes de solicitar os segmentos do pod de anúncios ou o manifesto de anúncio.
Quando o Video Stitcher detecta o marcador de anúncio do manifesto e faz solicitações de segmento de anúncio com um ID de intervalo de anúncio, a DAI do Google usa os dados de AdBreak com o mesmo ID para decisões de anúncios.
Depois que o cliente solicita a mídia do anúncio, a entidade AdBreak que você criou pela API faz a transição para o estado BREAK_STATE_COMPLETE.

Faça sua primeira solicitação
Para configurar o acesso à API e fazer sua primeira solicitação, consulte Usar a API DAI Ad Break.