AdMaster | Reconciliação do Log de Transmissão Explicada

Reconciliação do Log de Transmissão

A reconciliação é uma das partes mais importantes de uma operação de trafic bem gerida, e também uma das mais incompreendidas. Esta página explica o que é a reconciliação, como funciona conceptualmente, quais os modos suportados pelo AdMaster e como configurá-la corretamente independentemente do software de playout utilizado.

O conteúdo foi escrito para utilizadores que compreendem os fundamentos do trafic de rádio ou TV, mas que podem não estar familiarizados com a forma como o AdMaster gere este processo internamente.

O que é a reconciliação e por que é importante

Quando cria uma campanha no AdMaster, o algoritmo de planificação decide exatamente qual spot deve ser transmitido em qual bloco publicitário e a que horas. Esse planeamento é o que o AdMaster envia ao seu sistema de playout sob a forma de um log de trafic.

O que acontece realmente durante o dia de transmissão é uma questão separada. Os spots podem ser omitidos, transmitidos em horários ligeiramente diferentes, substituídos por notícias ou conteúdo em direto, eliminados por problemas técnicos ou transmitidos duas vezes por engano. O sistema de playout regista o que foi efetivamente transmitido no seu próprio log de transmissão.

A reconciliação é o processo de comparar os dois: o planeamento gerado pelo AdMaster e o log de transmissão produzido pelo playout. O resultado indica o que foi transmitido conforme planeado, o que foi transmitido fora do horário e o que não foi transmitido de todo.
Isto é importante por três razões:

  • Precisão da faturação.
    Só pode faturar a um anunciante o que foi efetivamente transmitido. Sem reconciliação, não tem um registo objetivo para fundamentar as suas faturas, e as disputas resumem-se à sua palavra contra a perceção do anunciante.
  • Compensações (make-goods).
    Quando um spot não é transmitido, deve ao anunciante uma transmissão de substituição. A reconciliação identifica automaticamente os spots em falta para que possa agendar compensações antes do fim da campanha.
  • Confiança dos anunciantes.
    Os anunciantes que podem consultar um relatório detalhado de cada spot transmitido, com os registos de hora exatos, confiam mais em si do que aqueles que recebem apenas um resumo genérico no final da campanha.

O modelo conceptual

Para compreender a reconciliação, é útil visualizar o fluxo de dados como um ciclo.

  • Passo 1:
    Cria uma campanha no AdMaster. O algoritmo constrói um planeamento e exporta-o como ficheiro de log de trafic. Este ficheiro é descarregado para o seu computador de playout pela aplicação AdMaster Desktop Client.
  • Passo 2:
    O seu software de playout lê o log de trafic e transmite os spots nos horários planeados. À medida que cada spot é reproduzido, o playout regista o evento no seu próprio log de transmissão, normalmente um ficheiro de texto com uma linha por elemento reproduzido.
  • Passo 3:
    O log de transmissão é enviado de volta para o servidor AdMaster. O servidor analisa o log, identifica as linhas correspondentes aos spots publicitários e associa cada spot reproduzido ao spot planeado correspondente na base de dados do AdMaster. A correspondência é feita por um termo de pesquisa que configura, normalmente o nome do spot, o nome do ficheiro de áudio ou o número de cart.
  • Passo 4:
    O AdMaster compara o horário planeado de cada spot com o horário em que foi efetivamente transmitido. O resultado é o relatório de reconciliação, disponível na secção Relatórios e refletido nas páginas de relatório em direto que pode criar para os seus anunciantes.

Tudo o que se segue nesta página diz respeito a como configurar corretamente cada passo deste ciclo.

O que o log de transmissão deve conter

O AdMaster não exige um formato de log específico. O que exige é informação suficiente em cada linha para identificar o que foi transmitido e quando. No mínimo, cada linha que representa um spot reproduzido deve conter:

  • Um identificador que permita ao AdMaster associar o elemento reproduzido a um spot planeado. Pode ser o nome do spot tal como aparece na campanha, o nome exato do ficheiro de áudio carregado ou o número de cart atribuído ao spot no seu playout.
  • A hora em que o spot começou a ser reproduzido, com precisão ao segundo, no formato HH:MM:SS. Horas e minutos por si só não são suficientes: a diferença entre um spot às 04:15:01 e outro às 04:15:59 dá espaço para quase dois spots de 30 segundos, o que é mais do que suficiente para comprometer o posicionamento no bloco publicitário.

Se o seu playout escrever informações adicionais no log, como a duração, o nome do operador ou metadados técnicos, não há problema. O AdMaster ignora tudo o que não necessita. O que não pode fazer é inventar dados em falta. Se o log não contiver um identificador utilizável, a reconciliação será executada mas não encontrará correspondências.

Se o seu playout escrever vários tipos de ficheiros de log na mesma pasta (por exemplo, um log musical, um log publicitário e um log de erros), terá de indicar ao AdMaster qual o ficheiro a ler. Isto é feito através da definição de cadeia delimitadora na aplicação Desktop Client, explicada mais adiante nesta página.

Erro frequente: nomes de ficheiros versus metadados dos ficheiros de áudio

Muitos sistemas de playout não registam o nome do ficheiro de áudio reproduzido. Em vez disso, registam as informações de Artista e Título armazenadas dentro do próprio ficheiro de áudio, nas chamadas tags ID3 (para ficheiros MP3) ou campos de metadados equivalentes para outros formatos. O RadioDJ, sistemas baseados em Winamp, OtsAV e vários outros funcionam assim por predefinição.
Isto é importante porque o nome do ficheiro e os metadados internos são duas coisas completamente diferentes. Um ficheiro com o nome «BURGER_KING_SUMMER_30.mp3» pode ter metadados internos com Artista: «BK Production Team» e Título: «BK SUMMER PROMO». O nome do ficheiro é o que vê na vista de pasta. Os metadados são o que o playout lê quando reproduz o ficheiro e escreve no seu log de transmissão.

Pode verificar os metadados de qualquer ficheiro de áudio no Windows clicando com o botão direito no ficheiro, escolhendo Propriedades e abrindo o separador Detalhes. Os campos Título, Artista, Álbum e outros que aí vê são os que o software de playout normalmente utiliza ao escrever o seu log.

Por que isto é importante para a reconciliação:

  • Se o seu Termo de Pesquisa no AdMaster estiver definido como Nome do spot, o AdMaster compara as cadeias de texto do log de transmissão com o campo Nome do spot dos seus spots de campanha. Se o log contiver cadeias derivadas de metadados, essas cadeias devem corresponder exatamente ao Nome do spot que introduziu ao criar a campanha.
  • Se o seu Termo de Pesquisa estiver definido como Nome do ficheiro, o AdMaster espera que o log de transmissão contenha os nomes reais dos ficheiros. Se o seu playout registar metadados em vez disso, não serão encontradas correspondências, independentemente de como os ficheiros estejam nomeados na pasta.

Existem três formas de lidar com esta situação, dependendo do que o seu playout suporta e do que é menos perturbador para si:

  • Atualize os metadados dos ficheiros de áudio para que os campos Artista e Título produzam juntos uma cadeia que corresponda ao Nome do spot nas suas campanhas AdMaster. Ferramentas como o Mp3tag (gratuito) gerem bem a edição de metadados em lote.
  • Altere o Nome do spot no AdMaster para corresponder exatamente ao que o playout escreve no log. Por exemplo, se o log mostrar «BK SUMMER PROMO», defina o Nome do spot na campanha como «BK SUMMER PROMO».
  • Reconfigure o playout para registar nomes de ficheiros em vez de metadados, se o seu playout o permitir. Assim que o log contiver nomes de ficheiros, altere o Termo de Pesquisa do AdMaster de Nome do spot para Nome do ficheiro (um clique). Esta é frequentemente a opção mais limpa, pois os nomes de ficheiros são intrinsecamente estáveis e pode nomear os seus ficheiros de áudio como quiser sem tocar nos metadados.

Qualquer que seja a opção escolhida, a correspondência é rigorosa. O AdMaster não realiza correspondência aproximada.

Dois modos: automático e manual

O AdMaster suporta duas formas de entregar o log de transmissão ao servidor para reconciliação. Ambas são totalmente suportadas e produzem a mesma análise. A diferença está na forma como o ficheiro passa do seu computador de playout para o servidor AdMaster.

Modo automático (recomendado)

A aplicação AdMaster Desktop Client, já instalada no seu computador de playout para descarregar logs de trafic e ficheiros de spots, também pode ser configurada para monitorizar a pasta onde o seu playout escreve o log de transmissão. Quando esta opção está ativa, o Desktop Client envia o log de transmissão para o servidor AdMaster várias vezes por hora, sem qualquer ação manual da sua parte.

Este é o modo adequado quando o seu playout escreve o log de transmissão de forma contínua, seja em tempo real à medida que cada evento ocorre, seja a intervalos frequentes ao longo do dia.

As vantagens do modo automático são:

  • Nenhum trabalho manual após a configuração inicial. A reconciliação ocorre automaticamente.
  • Resultados quase em tempo real. Pode ver o que foi transmitido nos minutos seguintes à transmissão.
  • Os relatórios em direto funcionam como previsto. O AdMaster pode gerar uma página de campanha privada para cada anunciante, mostrando os seus spots em tempo real à medida que são transmitidos. Esta funcionalidade só cumpre a sua promessa em modo automático, pois a página só pode mostrar o que o AdMaster conhece. Em modo manual, a página só é atualizada quando carrega o log, o que significa que o «direto» passa a «periódico». A funcionalidade continua a funcionar, mas perde o seu valor em tempo real.

Se oferecer aos anunciantes uma visão em tempo real das suas campanhas faz parte da sua proposta de valor, o modo automático é na prática indispensável.

Modo manual

Se o seu playout não escrever um log de transmissão em direto, ou apenas o escrever em momentos específicos, como uma vez por dia, a monitorização automática não funcionará bem. Nesse caso, o modo manual é a escolha certa.

Em modo manual, carrega você mesmo o log de transmissão para o AdMaster, sempre que o ficheiro estiver disponível. A origem do ficheiro pode ser qualquer lugar: o seu computador local, um computador remoto, uma pen USB, uma pasta de armazenamento na cloud. Seleciona um intervalo de datas no calendário do AdMaster, escolhe o ficheiro ou ficheiros a carregar, e o servidor realiza exatamente a mesma análise que realizaria em modo automático.

Note que, se se esquecer de carregar o log durante alguns dias, a reconciliação simplesmente não existirá para esse período até que o faça.

Configurar a reconciliação automática

A reconciliação automática requer alterações em dois locais: as definições de estação no AdMaster e a aplicação Desktop Client no computador de playout.

  • Passo 1. Configurar os horários dos blocos no AdMaster
    Abra Estações e selecione a sua estação. Aceda a Commercial Break Settings. Para cada bloco publicitário, defina o Minuto e o Segundo de início esperado com a maior precisão possível. Por exemplo, se o seu noticiário do início da hora termina aos 06 minutos e 30 segundos e o bloco publicitário começa imediatamente a seguir, o início esperado deve ser 06m30s.

    O AdMaster utiliza este valor durante a reconciliação para definir uma janela temporal em torno de cada bloco planeado. Procura spots reproduzidos correspondentes dentro dessa janela, em vez de analisar todo o dia. Quanto mais precisamente definir o horário de início esperado, mais fiável é a correspondência.
  • Passo 2. Ativar a reconciliação nas definições da estação
    Na mesma estação, aceda a General Station Settings. Localize o botão intitulado Turn on Broadcast Log Reconciliation e ative-o. Assim que o fizer, aparecem controlos adicionais, incluindo o ícone de Definições junto ao botão e o comando Upload Reconciliation File. Em modo automático, o comando Upload Reconciliation File não é relevante. O controlo de que necessita é o ícone de Definições.
  • Passo 3. Configurar o termo de pesquisa
    Clique no ícone de Definições junto ao botão Broadcast Log Reconciliation. Abre-se uma caixa de diálogo com a definição Search Term. Isto indica ao AdMaster o que procurar em cada linha do log de transmissão para identificar o spot que foi transmitido.
    Estão disponíveis três opções:

    Nome do spot: o título que atribuiu ao spot no AdMaster. Por exemplo, «Burger King Summer Promo 30s». Escolha esta opção se o seu playout incluir o título do spot no seu log.

    Nome do ficheiro: o nome exato do ficheiro de áudio carregado no AdMaster. Por exemplo, «BK_summer_30.mp3». Escolha esta opção se o seu playout registar o nome do ficheiro do elemento reproduzido.

    Número de cart: o identificador único atribuído ao spot no seu playout. Por exemplo, «C1245». Escolha esta opção se o seu playout registar números de cart.

    Se a definição do termo de pesquisa não corresponder ao que o seu playout efetivamente escreve no log, a reconciliação será executada mas não produzirá correspondências. Esta é a causa mais comum dos problemas do tipo «a reconciliação está ativa mas nada aparece».

    Se não tiver a certeza de qual opção se aplica, abra um dos ficheiros de log de transmissão do seu playout no Bloco de notas e inspecione algumas linhas. O formato do identificador do spot indicar-lhe-á qual a opção a escolher. Se vir «Burger King Summer Promo 30s», escolha Nome do spot. Se vir «BK_summer_30.mp3», escolha Nome do ficheiro. Se vir «C1245» ou um código semelhante, escolha Número de cart.
  • Passo 4. Configurar a pasta do log de transmissão na aplicação Desktop Client
    Vá para o computador de playout e abra a aplicação AdMaster Desktop Client. É a mesma aplicação que já utiliza para receber logs de trafic e ficheiros de spots do AdMaster.

    Localize a definição Playout Software Broadcast Log Folder. Defina-a como a pasta onde o seu software de playout escreve os seus logs de transmissão. O caminho exato varia consoante o software de playout; consulte a documentação do seu playout ou verifique a sua configuração.

    Se o seu playout escrever vários ficheiros de log na mesma pasta, clique no pequeno ícone de definições junto ao caminho da pasta do log de transmissão. Aparece um campo onde pode introduzir uma cadeia delimitadora. Trata-se de um texto que identifica de forma única o ficheiro de log correto pelo seu nome.

    Por exemplo, suponha que o seu playout escreve três ficheiros por dia na mesma pasta:
    2026-01-05-General.log
    2026-01-05-Music.log
    2026-01-05-Errors.log

    Se os eventos de reprodução publicitária forem registados no log General, introduza «General» como cadeia delimitadora. O AdMaster lerá então apenas os ficheiros cujos nomes contenham essa cadeia. Sem delimitador, o AdMaster lerá todos os ficheiros da pasta, o que pode produzir resultados imprevisíveis.

    Clique em Guardar para aplicar as definições. O Desktop Client começará imediatamente a monitorizar a pasta.
  • Passo 5. Verificar que o processo está a funcionar
    Aguarde pelo menos 15 a 20 minutos após ativar a reconciliação. Em seguida, aceda ao AdMaster e abra o Traffic Log Editor. Deverá ver os spots reproduzidos com marcas de verificação verdes e os horários reais de transmissão.
    Se não houver marcas de verificação no Traffic Log Editor, consulte a secção de resolução de problemas no final desta página.

Configurar a reconciliação manual

O modo manual é mais simples de configurar, mas requer uma ação da sua parte cada vez que pretende efetuar uma reconciliação.

  • Passo 1. Configurar os horários dos blocos e ativar a reconciliação
    Este passo é idêntico ao modo automático. Defina os horários de início esperados para cada bloco publicitário em Commercial Break Settings, depois ative o botão Broadcast Log Reconciliation em General Station Settings. Configure o Search Term da mesma forma: Nome do spot, Nome do ficheiro ou Número de cart, consoante o que o seu playout escreve no log.
  • Passo 2. Obter o log de transmissão do seu playout
    Exporte, descarregue ou copie o ficheiro de log de transmissão de onde quer que o seu playout o armazene. Isto pode implicar executar uma exportação a partir da interface do playout, copiar um ficheiro de uma pasta, descarregar de uma partilha de rede ou extrair do histórico da base de dados do playout. O procedimento depende inteiramente do seu software de playout. O destino é o seu próprio computador ou qualquer local de armazenamento acessível a partir do browser que utiliza para iniciar sessão no AdMaster.
  • Passo 3. Carregar o log de transmissão no AdMasterNo AdMaster, aceda a Estações, selecione a sua estação e abra General Station Settings. Junto ao botão Broadcast Log Reconciliation, localize o comando Upload Reconciliation File.
    Clique nele. Abre-se um calendário que lhe permite selecionar o intervalo de datas coberto pelo ficheiro de log carregado. Escolha o intervalo e selecione o ficheiro ou ficheiros a carregar. O AdMaster aceita ficheiros de log em texto simples em qualquer formato (os formatos de base de dados binários não são suportados).
    Após o carregamento, o servidor executa a mesma análise e correspondência que em modo automático. Os resultados da reconciliação aparecem na secção Relatórios assim que a análise estiver concluída, normalmente em menos de um minuto.
  • Passo 4. Repetir conforme necessário
    A reconciliação manual deve ser efetuada sempre que pretender resultados atualizados. Se carregar os logs uma vez por dia, os seus dados de reconciliação estão atualizados a partir desse carregamento. Se carregar uma vez por semana, os seus dados de reconciliação estão atualizados a partir desse carregamento semanal, e não antes.

Relatórios em direto e modo de reconciliação

Uma das funcionalidades distintivas do AdMaster é o relatório em direto. Para cada campanha, pode criar uma página web privada à qual o anunciante pode aceder com um link único (sem necessidade de início de sessão). A página mostra os spots planeados da campanha, os spots já transmitidos com os registos de hora exatos e os spots que não foram transmitidos.

Esta página é atualizada sempre que novos dados de reconciliação chegam ao servidor AdMaster. A frequência das atualizações depende inteiramente do modo de reconciliação utilizado.

Em modo automático, o Desktop Client envia o log de transmissão várias vezes por hora. A página do anunciante é, portanto, atualizada quase em tempo real. Um anunciante que consulte a página durante a sua campanha vê os seus spots aparecer nos minutos seguintes à transmissão. É isto que torna o relatório em direto verdadeiramente «em direto».

Em modo manual, a página do anunciante só é atualizada quando carrega o log de transmissão. Se carregar uma vez no final do dia, a página mostra as transmissões do dia apenas nesse momento. Se carregar uma vez por semana, a página reflete apenas o carregamento anterior até ao seguinte. A página continua a funcionar e os dados continuam a ser precisos, mas o caráter «em direto» perde-se.

Se oferecer aos seus anunciantes monitorização de campanhas em tempo real como parte do seu serviço, o modo automático é o único modo que cumpre essa promessa. Caso contrário, qualquer um dos modos é adequado.

Problemas comuns e como diagnosticá-los

A reconciliação está ativa mas não aparecem dados nos relatórios

Este é o cenário mais comum, e quase sempre uma das seguintes causas:

  • O Termo de Pesquisa não corresponde ao conteúdo do log. Abra um dos ficheiros de log de transmissão do seu playout no Bloco de notas e verifique qual o identificador utilizado para os spots. Se vir nomes de ficheiros e o seu Termo de Pesquisa estiver definido como Número de cart, não ocorrerão correspondências. Ajuste o Termo de Pesquisa para corresponder ao conteúdo real do log.
  • O Desktop Client está a apontar para a pasta errada. Abra a aplicação Desktop Client no computador de playout e verifique que a definição Broadcast Log Folder aponta para a pasta exata onde o seu playout escreve os seus logs. Um caminho com uma pasta de diferença não produzirá erros, mas também não produzirá dados. Utilizar o ambiente de trabalho para armazenar os ficheiros aumenta consideravelmente a possibilidade de definições incorretas.
  • A pasta contém vários tipos de logs e não está definido nenhum delimitador. Se o seu playout escrever logs musicais, publicitários e de erros na mesma pasta, o AdMaster precisa de saber qual ler. Defina uma cadeia delimitadora que identifique de forma única o ficheiro de log correto.
  • Os horários de início esperados dos blocos estão mal configurados (Estações > Commercial break settings). Se o horário de início esperado de um bloco estiver definido para 05m00s mas o bloco for efetivamente transmitido às 25m00s, o AdMaster procurará spots reproduzidos numa janela em torno das 05m00s, não encontrará nada e reportará o bloco como omitido. Verifique que os horários de início esperados correspondem ao planeamento real.
  • O formato de registo de hora no log não é o que o AdMaster espera. O AdMaster analisa horas no formato HH:MM:SS de 24 horas. Se o seu log escrever horas como «6:35 AM» (12 horas com AM/PM) ou «14:15» (sem segundos), o analisador não as consegue ler corretamente. Abra o seu log no Bloco de notas e verifique o formato de registo de hora. Se for diferente de HH:MM:SS, reconfigure o seu playout para escrever os registos de hora no formato padrão.

Alguns spots aparecem como transmitidos, outros não, mas todos foram claramente transmitidos
Isto é geralmente causado por identificadores inconsistentes no log. Por exemplo, algumas linhas podem ter o título completo do spot e outras uma versão abreviada, ou algumas entradas podem ter o nome do ficheiro com a extensão .mp3 e outras sem. O AdMaster efetua correspondências com cadeias exatas.
Para diagnosticar, abra o log no Bloco de notas, examine algumas entradas para a mesma campanha e verifique se o identificador é consistente. Se não for, a inconsistência é tipicamente uma definição no seu playout que controla a forma como formata as entradas do log.

O Desktop Client carrega o log, mas a reconciliação parece atrasada por várias horas
O Desktop Client envia várias vezes por hora, mas o momento de cada envio depende da frequência com que o playout escreve no ficheiro de log. Se o playout só escrever no log no início de cada hora, o momento mais cedo em que o AdMaster pode ver um spot é o início da hora seguinte.
Se precisar de uma reconciliação verdadeiramente em tempo real, verifique as definições do seu playout relativamente à frequência com que liberta o seu log para o disco. Alguns playouts mantêm as entradas de log em memória e só as escrevem a intervalos. Vários playouts fazem-no apenas uma vez por dia.

Mudei para o modo automático mas não encontro as definições do Desktop Client de que necessito
As definições Broadcast Log Folder e delimitador estão dentro da aplicação Desktop Client no computador de playout, e não dentro da interface web do AdMaster no seu computador de escritório. A interface web e o Desktop Client são dois softwares distintos, e a reconciliação envolve ambos. A interface web é onde ativa a funcionalidade e escolhe o Termo de Pesquisa. O Desktop Client é onde indica ao AdMaster qual a pasta a monitorizar no computador de playout.

Resumo

A reconciliação fecha o ciclo entre o que planeou e o que foi efetivamente transmitido. O AdMaster gere a análise, mas depende de si para configurar corretamente alguns aspetos de ambos os lados. Do lado do AdMaster: os horários de início esperados dos seus blocos publicitários, o Termo de Pesquisa que corresponde ao identificador que o seu playout escreve no log e o caminho para a pasta do log de transmissão. Do lado do playout: o log de transmissão deve conter o identificador correspondente e um registo de hora no formato HH:MM:SS de 24 horas.

Escolha o modo automático se o seu playout escrever o log em tempo real ou a intervalos frequentes, e especialmente se pretender que os seus anunciantes vejam as suas campanhas a atualizar em tempo real. Escolha o modo manual se o seu playout só produzir o log sob pedido ou uma vez por dia, e estiver disposto a carregá-lo você mesmo quando estiver pronto.

Uma vez configurado corretamente, a reconciliação corre silenciosamente em segundo plano. Vê os resultados nos Relatórios e no Traffic Log Editor, os seus anunciantes veem-nos nas suas páginas de campanha privadas, e as suas faturas são sustentadas por um registo objetivo do que foi transmitido.