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

A API de intervalo de anúncio da Inserção de anúncios dinâmicos (DAI) permite criar e gerenciar os dados de segmentação de anúncios e de tempo dos próximos intervalos de anúncio nas suas transmissões ao vivo.

Com a API DAI Ad Break, você pode fazer o seguinte:

  • Aumente a taxa de preenchimento de anúncios durante o pico de tráfego: dê mais tempo aos serviços de Inserção de anúncios dinâmicos (DAI) para selecionar os anúncios mais lucrativos para seus eventos ao vivo. Recomendamos a API de intervalo de anúncio da DAI quando os eventos da sua transmissão ao vivo têm alta simultaneidade, tags de anúncio dinâmicas ou anúncios de alta latência.
  • Tenha controle total das suas pausas para anúncios: crie, atualize e exclua pausas para anúncios com antecedência, oferecendo mais flexibilidade do que a sinalização de anúncios no manifesto e uma taxa de preenchimento maior para veiculação de pods em comparação com a tomada de decisões just-in-time.
  • Ofereça uma experiência ininterrupta aos espectadores: minimize erros de reprodução relacionados a anúncios, como conjuntos de anúncios subpreenchidos ou superpreenchidos, fornecendo informações precisas sobre os intervalos.

Este guia descreve os métodos da API DAI Ad Break e explica o ciclo de vida do intervalo de anúncio para fluxos de serviço completo e veiculação de pods da DAI.

Saiba mais sobre os métodos da API de intervalo de anúncio da DAI

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 que comece 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 inversa. A API não retorna intervalos de publicidade 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 para uma entidade AdBreak criada anteriormente.

Entenda 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 cancelar o intervalo de anúncio com possíveis efeitos adversos nos servidores de anúncios.
  • BREAK_STATE_COMPLETE: o intervalo de anúncio foi veiculado aos usuários.

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 sobre anúncios, o que causa uma taxa de preenchimento do anúncio menor.
  • Evite criar um intervalo de anúncio mais de 6 horas antes do horário de início esperado, porque 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 da DAI e de veiculação de pods.

Entender o fluxo da DAI com serviço completo

A DAI Full Service do Google gerencia o manifesto de conteúdo e os conjuntos 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 anúncio correspondente no manifesto de transmissão ao vivo de conteúdo.

  • Esse tempo de lead permite que os serviços da DAI do Google usem seus dados de AdBreak para a decisão de publicidade.
  • Quando a DAI do Google detecta o marcador de anúncio do manifesto, o sistema usa decisões de anúncio com os dados da entidade AdBreak e faz a transição do estado da entidade para BREAK_STATE_COMPLETE.

Entidade de intervalo de anúncio desde a criação até a conclusão no fluxo de veiculação de pods.

Entender o fluxo de veiculação de pods

Nesse fluxo, você gerencia o manifesto de transmissão ao vivo de conteúdo ou usa um serviço de manipulação de manifesto de terceiros 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 precisar solicitar os segmentos do conjunto de anúncios ou o manifesto de anúncios.

Quando o junção de vídeo 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 AdBreak com o mesmo ID para decisões de publicidade.

Depois que o cliente solicita mídia de anúncio, a entidade AdBreak criada pela API passa para o estado BREAK_STATE_COMPLETE.

Estado completo da entidade de 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.