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.
Em seguida, basta começar a usar seu aplicativo para ver os eventos dele sendo registrados no 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.
À medida que os valores das propriedades do usuário mudam durante o uso do aplicativo, você verá uma entrada para essa mudança.
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.
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.
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.
