Relatório de status de integração

O Relatório de status onboard verifica as taxas de sucesso e de falha para o processamento de registros nos arquivos de fonte de dados de entrada. Este relatório exibe dados em um gráfico de barras interativo e fornece métricas de resumo em forma tabular. Além disso, ele inclui a opção de arquivos de amostra para um intervalo de tempo fixo e exibe os erros mais comuns para cada tipo de erro. Esse relatório pode ser encontrado no Analytics > Relatório de status onboard. Este relatório também está disponível ao criar uma fonte de dados de entrada.

OBSERVAÇÃO

Somente os usuários com privilégios de Administrador podem ver esse relatório na interface do usuário do Audience Manager. Você pode fazer com que usuários não administradores sejam notificados do status dos arquivos de entrada carregados adicionando seus e-mails ao relatório. Consulte Receber notificações por e-mail.

Relatório de status onboard: Sobre

O Onboarding Status Report verifica as taxas de sucesso e falha para o processamento de registros nos arquivos de fonte de dados de entrada. Este relatório exibe dados em um gráfico de barras interativo e fornece métricas de resumo em forma tabular. Além disso, ele inclui a opção de arquivos de amostra para um intervalo de tempo fixo e exibe os erros mais comuns para cada tipo de erro. Você pode encontrar este relatório em Analytics > Onboarding Status Report. Este relatório também está disponível ao criar uma fonte de dados de entrada.

Relatórios de erro e amostragem de erro

Relatórios de erros e amostragem de erros são dois recursos separados do relatório Onboarding Status.

Recurso Descrição

Relatórios de erro

O relatórios de erro mostra as taxas de sucesso e falha do número de registros processados em uma fonte de dados de entrada. Ele retorna dados em um gráfico de barras empilhadas interativo e como métricas de resumo em tabelas abaixo do gráfico.

O relatórios de erro é automático. Ele é executado continuamente para todas as suas fontes de dados de entrada. Ele retorna dados com base no intervalo de intervalos de tempo predefinidos ou em um intervalo de tempo personalizado definido com um widget de calendário.

Amostragem de erro

A amostragem de erros analisa o conteúdo de seus arquivos de dados e retorna os 10 erros mais comuns para cada tipo de erro. Os erros nos arquivos de dados de entrada impedem que registros individuais sejam processados. Use este relatório como uma ferramenta de solução de problemas para ajudar a reduzir o número de erros de arquivo e melhorar as taxas de processamento.

Você deve ativar a amostragem de erros manualmente. Ela funciona por 14 dias a partir do dia da ativação e então se desliga. Você pode ativar novamente a amostragem de erros depois que o intervalo de 14 dias expirar. Você ativa a amostragem de erros quando cria uma fonte de dados de entrada ou marcando a caixa de seleção Amostragem de erros na seção Configurações da fonte de dados de uma fonte de dados de entrada existente.

A amostragem de erros é um processo que exige cálculos. Como resultado, retorna somente os primeiros 10 erros para cada categoria de erro. Ele não foi projetado para retornar todos os erros contidos em uma fonte de dados de entrada. Esses erros são uma amostra representativa de um grupo potencialmente maior de erros similares. Revise o arquivo inteiro para ver os tipos de erros que este relatório sinaliza, reformate o arquivo e envie-o novamente.

Consulte Conteúdo do arquivo de dados de entrada: Sintaxe, variáveis e exemplos para obter mais informações sobre como formatar corretamente um arquivo de dados para uma fonte de dados de entrada.

Gráfico de Barras de Relatório de Erro

O relatório de erros mapeia as taxas de sucesso e de falha do processamento de registros em um gráfico de barras empilhadas, como mostrado no exemplo a seguir. O gráfico é interativo. Clicar em uma barra mostra as métricas de resumo do dia em uma tabela abaixo do gráfico.

Tabelas de Relatório de Erro

O relatório de erros exibe dados tabulares abaixo do gráfico de barras. A tabela mostra as taxas de sucesso e de falha, juntamente com os totais e as porcentagens.

Registros com êxito e com falha

Esta visualização padrão mostra uma contagem de frequência do total de registros em seu relatório e inclui uma análise dos erros por tipo de erro.

Totais e porcentagens

Clique em Totals & Percentages para ver qual % dos seus arquivos foram processados com êxito.

Relatório de amostragem de erros por 14 dias

Com a amostragem de erros ativa, o relatório mostrará os 10 erros principais para cada tipo de erro. Clique em um botão de tipo de erro na parte superior do relatório para ver cada conjunto de dados de amostra.

OBSERVAÇÃO

O relatório não destaca erros de registro nesta versão atual. Para localizar e corrigir erros de arquivo, você deve revisar os resultados e compará-los às especificações da documentação Conteúdo do arquivo de dados de entrada.

Receber notificações por e-mail

Você pode adicionar os endereços de email dos recipient que deseja que sejam notificados sobre o status dos arquivos de entrada carregados. Observe que é possível selecionar recipient diferentes para fontes de dados diferentes.

Criar um relatório de status onboard

Um Sample Error Report retorna o número de registros em uma fonte de dados que foram processados com êxito e quantos falharam. Siga estas etapas para gerar um Sample Error Report.

  1. Vá para Analytics > Onboarding Status Report. Procure uma fonte de dados ou escolha uma da lista.

  2. Selecione um intervalo de datas. As opções incluem:

    • Um conjunto de intervalos de relatório fixos.
    • Widgets de calendário que permitem criar um intervalo de datas personalizado.
  3. Clique em OK.

Termos e definições do relatório de status onboard

Um guia de referência para os rótulos e termos usados neste relatório.

Termo Definição

Nome do arquivo de sincronização de dados

Lista arquivos que Audience Manager receberam e processaram a partir da fonte de dados de entrada selecionada.

O processamento do arquivo falhará se o nome do arquivo for formatado incorretamente. Os requisitos de nome de arquivo variam dependendo de como você envia esses dados para Audience Manager. Os métodos de delivery incluem Amazon S3 e FTP. Para obter instruções sobre como nomear seus arquivos, consulte:

Erros de formato

Lista o número de registros que falharam no processamento porque não correspondem aos requisitos de sintaxe ou formatação. Consulte Conteúdo do arquivo de dados de entrada: Sintaxe, variáveis e exemplos para obter informações sobre como formatar seus dados.

ID de AAM inválida

Lista o número de IDs de usuário (UUID) Audience Manager formatadas incorretamente. Normalmente, isso indica as IDs:

  • Não correspondia ao formato de 38 dígitos esperado.
  • Contém caracteres alfabéticos. As IDs devem ser apenas números.

ID de dispositivo inválida

Lista o número de IDs de dispositivo global formatadas incorretamente. Consulte Índice de IDs em Audience Manager e Fontes de Dados Globais para obter detalhes sobre como as IDs de dispositivos devem ser formatadas e quais fontes de dados globais você deve usar, com base no tipo de dispositivo.

A seção de amostragem de erros do relatório inclui informações detalhadas sobre as IDs de dispositivo inválidas, como:

  • A ID da fonte de dados correspondente à ID de dispositivo inválida;
  • A ID de dispositivo inválida;
  • O tipo de ID de dispositivo esperado, com base na fonte de dados.

Nenhuma ID de AAM correspondente

Essas IDs integradas Audience Manager não podem corresponder a uma ID existente. As IDs integradas podem ter esse status quando Audience Manager ainda não executaram uma sincronização de ID ou ainda não podem corresponder à ID mesmo depois de uma sincronização.

No caso de IDs móveis não correspondentes, Audience Manager irá:

  • Continue a armazenar e tente sincronizar esta ID.
  • Registre-o como Registro armazenado no relatório se a ID não puder ser sincronizada.

Se o arquivo integrado contiver IDs móveis, você poderá tratar esses números com um pouco mais de leveza do que as outras métricas. Elas não afetarão as taxas de sucesso e de correspondência dos arquivos subsequentes.

Nenhuma característica realizada

Características do Lista que Audience Manager não podem corresponder a uma característica integrada. Isso pode resultar de:

Porcentagem de sucesso

A porcentagem de registros no arquivo que foram armazenados com êxito. Porcentagem de sucesso = registros processados / número de registros em um arquivo.

Registros recebidos

O número total de registros recebidos. Na maioria dos casos, esse número deve corresponder ao número total de registros (linhas) no arquivo de dados de entrada.

Registros armazenados

Número de registros armazenados com êxito. Devido a erros de formato de arquivo, alguns dos registros recebidos podem não ser armazenados por Audience Manager. O número de registros armazenados pode ser inferior ao número de registros recebidos.

Características Realizadas Totais

O número de características de todos os usuários em todos os arquivos de entrada armazenados na plataforma Audience Manager.

Total de Sinais Não Utilizados

Número total de sinais não utilizados recebidos no relatório. Esse total se baseia no número total de registros armazenados com êxito.

Consulte Relatório de sinais não utilizados para obter mais informações.

Nesta página