Saiba mais sobre a API de intervalo de anúncio da DAI

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 entidade AdBreak para uma entidade LiveStreamEvent. Se quiser, defina a propriedade expectedStartTime para 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 entidade AdBreak específica, incluindo o estado do intervalo de anúncio e os metadados de tempo.
  • List: retorna uma lista de entidades AdBreak criadas anteriormente com a API para uma determinada entidade LiveStreamEvent, 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 entidade AdBreak antes do início da decisão de anúncio.
  • Delete: cancela a decisão de anúncio de uma entidade AdBreak criada 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 campo expectedStartTime ou 30 minutos após o início da decisão, se você não definir o campo expectedStartTime. É possível personalizar essa duração usando o campo expireDuration.

O diagrama a seguir mostra a linha do tempo de uma entidade AdBreak, da criação à conclusão.

Entidade de intervalo de anúncio 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 AdBreak para 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 AdBreak e faz a transição do estado da entidade para BREAK_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.

Entidade de intervalo de anúncio, da criação à conclusão, no fluxo de DAI com serviço completo.

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.

Estado de conclusão da entidade do intervalo de anúncio.

Faça sua primeira solicitação

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