Eventos de depuração

O DebugView permite que você veja os dados brutos de eventos registrados pelo seu aplicativo em dispositivos de desenvolvimento quase em tempo real. Isso é muito útil para fins de validação durante a fase de instrumentação de desenvolvimento e pode ajudá-lo a descobrir erros e falhas na implementação do Analytics e a confirmar se todos os eventos e propriedades do usuário foram registrados corretamente.

Habilitar modo de depuração

Geralmente, os eventos registrados pelo seu aplicativo são agrupados em lote durante um período de aproximadamente uma hora e carregados juntos. Essa abordagem conserva a bateria dos dispositivos dos usuários finais e reduz o uso de dados da rede. No entanto, para fins de validação da implementação do Analytics (e para visualizar o Analytics no relatório DebugView), você pode ativar o modo de depuração no dispositivo de desenvolvimento para fazer upload de eventos com um atraso mínimo.

iOS+

Para ativar o modo de depuração do Analytics em seu dispositivo de desenvolvimento, especifique o seguinte argumento de linha de comando no Xcode:

-FIRDebugEnabled

Esse comportamento persiste até que você desative explicitamente o modo de depuração especificando o seguinte argumento de linha de comando:

-FIRDebugDisabled

Você pode adicionar esses argumentos editando o esquema do seu projeto e adicionando uma nova entrada em "Argumentos passados ​​no lançamento".

Android

Para ativar o modo de depuração do Analytics em um dispositivo Android, execute os seguintes comandos:

adb shell setprop debug.firebase.analytics.app PACKAGE_NAME

Esse comportamento persiste até que você desative explicitamente o modo de depuração executando o seguinte comando:

adb shell setprop debug.firebase.analytics.app .none.

Rede

Para ativar o modo de depuração do Analytics em seu navegador, instale a extensão Google Analytics Debugger para Chrome.

Depois de instalada, habilite a extensão e atualize a página. Desse ponto em diante, a extensão registrará eventos em seu aplicativo no modo de depuração.

Você pode visualizar eventos registrados no DebugView no console do Firebase.

Relatório sobre dados de eventos

Depois de ativar o modo de depuração em seus dispositivos de desenvolvimento, navegue até DebugView selecionando a seta ao lado de StreamView na navegação superior do Google Analytics e selecionando DebugView.

Navegue até DebugView selecionando a seta ao lado de StreamView na parte superior de navegação do Google Analytics e selecionando DebugView

Em seguida, basta começar a usar seu aplicativo para ver os eventos dele sendo registrados no relatório DebugView.

O relatório DebugView.

O fluxo Segundos (coluna do meio) mostra os eventos que foram registrados nos últimos 60 segundos. O fluxo Minutos (coluna da esquerda) mostra uma série de arquivos de eventos dos últimos 30 minutos. E a coluna da direita mostra os principais eventos registrados no período de 30 minutos, bem como as propriedades atuais do usuário para o dispositivo de desenvolvimento atualmente selecionado.

Fluxo de segundos

Por padrão, você verá uma lista de eventos registrados nos últimos 60 segundos. Cada evento exibe um carimbo de data/hora que corresponde ao horário de seu registro no dispositivo de desenvolvimento. Você pode clicar em um evento para ver uma lista dos parâmetros associados a esse evento.

Uma lista de exemplo de parâmetros de evento.

À medida que os valores das propriedades do usuário mudam durante o uso do aplicativo, você verá uma entrada para essa mudança.

Um exemplo de propriedade do usuário.

Fluxo de minutos

Este fluxo mostra uma série de círculos, cada um correspondendo a um minuto dos últimos 30 minutos. O número no círculo indica a contagem de eventos recebidos naquele minuto. Clicar em um desses círculos preencherá o fluxo de Segundos com eventos que foram registrados durante aquele minuto. Isso efetivamente permite que você examine os eventos registrados nos últimos 30 minutos com detalhes refinados.

Um exemplo do fluxo de minutos.

Principais eventos e propriedades atuais do usuário

A tabela Principais eventos mostra os principais eventos registrados durante o período de 30 minutos. E a tabela Propriedades do usuário atual mostra o estado mais recente do conjunto de Propriedades do usuário para o dispositivo de desenvolvimento atualmente selecionado.

Um exemplo da tabela de eventos principais.

Seletor de dispositivos

Como muitos dispositivos de desenvolvimento diferentes podem ter o modo de depuração ativado, você pode usar o seletor de dispositivos para escolher o dispositivo específico no qual o relatório DebugView se concentrará. Isso permite que vários desenvolvedores se concentrem em seus próprios esforços de instrumentação e validação sem impactar uns aos outros.

Um exemplo do seletor de dispositivos.