Saiba mais sobre a API Stream Activity Monitor

A API Monitoramento da atividade de streaming (SAM, na sigla em inglês) da Inserção de anúncios dinâmicos (DAI) permite inspecionar e resolver problemas em sessões de visualização de transmissões ao vivo e vídeos on demand (VOD) individuais.

Para inspecionar visualmente e resolver problemas em uma sessão de visualização de transmissão ao vivo ou VOD, use o Monitoramento da atividade de streaming na interface do Google Ad Manager. Para recuperar de forma programática os dados de diagnóstico de uma sessão, use o recurso networks.daiSessions da API Ad Manager.

Entender os casos de uso

Com a API SAM, é possível automatizar o diagnóstico de streams e resolver problemas de veiculação de anúncios nas suas integrações de DAI, como:

  • Verificar a criação da sessão de transmissão: confirme os parâmetros, o modo de agrupamento de STITCHED ou POD_SERVING, o modo de relatório e os metadados de conteúdo que a DAI do Google recebe ao criar uma sessão de transmissão ao vivo ou de VOD.
  • Auditar solicitações e respostas de anúncios: inspecione as tags de anúncio de saída do modelo de veiculação de anúncio em vídeo (VAST) e da playlist de vários anúncios em vídeo (VMAP), os códigos de status HTTP, as latências de resposta, os corpos de resposta XML brutos e as cadeias de redirecionamento de wrapper.
  • Resolver problemas de decisão e criativos de pods de anúncios: verifique quais anúncios a DAI do Google seleciona ou descarta para cada pod, a duração de cada anúncio no pod e o sistema de origem do criativo do anúncio.
  • Acompanhar a execução da pré-busca de anúncios: determine se a DAI do Google faz a pré-busca de um pod de anúncios e verifique a fase de pré-busca de cada pod.
  • Validar as chamadas da API de intervalo de anúncio da DAI e da API de veiculação de pod da DAI: verifique a execução real do intervalo, as durações dos anúncios veiculados e as durações das inserções inseridas em relação às chamadas de API, como a API de intervalo de anúncio da DAI e a API de veiculação de pod da DAI.
  • Verificar o rastreamento de eventos de anúncio: confirme se os pings de rastreamento do lado do cliente ou do lado do servidor foram bem-sucedidos e inspecione as respostas HTTP dos servidores de anúncios.
  • Automatizar o monitoramento e os alertas de sessões: analise entradas de descobertas estruturadas com uma gravidade INFO, WARNING ou ERROR para detectar problemas de reprodução ou monetização em testes de integração automatizados e pipelines de monitoramento de produção.

Conhecer o recurso de nível superior

A API SAM faz parte da API REST do Google Ad Manager (Beta) no endpoint admanager.googleapis.com e expõe o método somente leitura networks.daiSessions.get. É possível consultar um recurso DaiSession com um ID de sessão da DAI ou uma chave de depuração personalizada. A DAI retém os registros de sessão por até três dias após a reprodução.

A API SAM não permite listar todos os recursos DaiSession em uma rede do Google Ad Manager.

Inspecionar respostas de stream da DAI com o SAM

Para verificar como a DAI do Google processa suas solicitações de stream, analise a resposta DaiSession:

  • API DAI com serviço completo: inspecione o campo creationContext.streamCreateRequest para verificar a chamada de registro do stream, confira os mapas adSelections e adPods para analisar a decisão de anúncios e examine o mapa adBreaks para confirmar as durações do anúncio inserido, do criativo de slate e do conteúdo subjacente.
  • API DAI de veiculação de pod: confirme se o campo creationContext.stitchingType está definido como o valor POD_SERVING, verifique o campo adBreakId nos mapas adPods e adBreaks com as chamadas de solicitação de manifesto ou segmento de pod e inspecione os beacons do lado do servidor ou de verificação de mídia no mapa trackingPings.
  • API DAI Ad Break: faça a correspondência do valor breakSequence de um objeto AdBreak com a propriedade AdBreak.breakSequence.

Faça sua primeira solicitação

Para configurar a autenticação e recuperar recursos de sessão da DAI, consulte Usar a API Monitoramento da atividade de streaming.