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

Com a API de intervalo de anúncio da Inserção de anúncios dinâmicos (DAI), é possível criar e gerenciar o tempo e os dados de 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 fazer o seguinte:

  • Aumente a taxa de preenchimento de anúncios durante o pico de tráfego: dê mais tempo aos serviços de DAI para selecionar os anúncios mais lucrativos para seus eventos ao vivo. Recomendamos a API Intervalo de Anúncio da DAI 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.
  • Tenha controle total dos seus 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 veiculação de conjuntos 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 DAI de intervalo de anúncio

A API expõe os seguintes métodos padrão para gerenciar recursos de 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 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 para uma entidade AdBreak criada anteriormente.

Entender o ciclo de vida de um 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 para os 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 seis horas antes do horário de início previsto, 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 comercial nos fluxos de serviço completo da DAI e de veiculação de pods.

Entender o fluxo da DAI de serviço completo

A DAI de serviço completo do Google gerencia o manifesto de conteúdo e os conjuntos de anúncios.

Para a 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 da criação à conclusão no fluxo de DAI de serviço completo.

Entender o fluxo de serviço do pod

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 para criar uma entidade AdBreak antes de precisar solicitar os segmentos de pod de anúncio 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 AdBreak com o mesmo ID para decisões de publicidade.

Depois que o cliente solicitar mídia de anúncio, a entidade AdBreak criada pela API fará a transição para o estado BREAK_STATE_COMPLETE.

Estado de conclusão 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.