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
STITCHEDouPOD_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,WARNINGouERRORpara 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.streamCreateRequestpara verificar a chamada de registro do stream, confira os mapasadSelectionseadPodspara analisar a decisão de anúncios e examine o mapaadBreakspara 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.stitchingTypeestá definido como o valorPOD_SERVING, verifique o campoadBreakIdnos mapasadPodseadBreakscom 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 mapatrackingPings. - API DAI Ad Break: faça a correspondência do valor
breakSequencede um objetoAdBreakcom a propriedadeAdBreak.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.