Compartilhar via


Métricas de eventos

Importante

O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar a migração.

Saiba mais sobre linhas do tempo e alternativas de suporte.

Eventos são ações que os usuários tomam em seu aplicativo. Ao acompanhar eventos em seu aplicativo, você aprenderá mais sobre o comportamento dos usuários e entenderá a interação entre seus usuários e seus aplicativos. Anexar propriedades aos seus eventos fornecerá informações contextuais sobre os eventos.

O acompanhamento de eventos em seu aplicativo permite que você responda a perguntas como:

  • Qual é o conteúdo N superior exibido?
  • Qual é o conteúdo mais curtido?
  • Que tipo de arquivos meus usuários enviam?

Para acompanhar eventos personalizados em seu aplicativo, use nossa trackEvent API do SDK do App Center Analytics. Mais informações sobre como definir eventos personalizados usando nosso SDK podem ser encontradas na Documentação do SDK do App Center para Android, iOS, React Native, MAUI/Xamarin, Windows, macOS e Unity.

Informações gerais

Você pode filtrar a página de eventos por intervalo de tempo (os últimos 1, 7 ou 28 dias) e para a versão do aplicativo selecionada. Esses filtros permitem que você faça uma busca detalhada nos dados de eventos para o período de tempo ou a versão do aplicativo selecionado.

Página eventos

A Página de Eventos fornece uma tabela com uma visão geral dos eventos que ocorrem em seu aplicativo. Essa tabela pode ser classificada por contagem em ordem crescente e decrescente. Você também pode procurar um evento na tabela pelo nome. Para cada evento, as seguintes informações são fornecidas:

  • Contagem: número de vezes que um evento foi disparado.
  • Tendência: alteração da contagem em valor absoluto e alteração percentual, em comparação com o período de tempo selecionado anterior.
  • Usuários: número de usuários que dispararam um evento.
  • Alteração do usuário: alteração do número de usuários em valor absoluto e percentual, em comparação com o período selecionado anterior.
  • Contagem por usuário: número médio de vezes que um evento é disparado por usuário.

Exibição de Detalhes do Evento

Selecione um evento dentro da tabela de eventos para revelar informações mais detalhadas:

  • Usuários: número total de usuários que dispararam o evento. LAST (n) DAYS é um cálculo de tendência.
  • Contagem: número total de vezes que o evento foi disparado.
  • Contagem por usuário: número médio de vezes que o evento é disparado por usuário.
  • Contagem por sessão: número médio de vezes que o evento é disparado por sessão.

Excluir histórico de eventos

Remova eventos individuais da exibição Detalhes do Evento clicando na opção configurações no canto superior direito da página e selecionando "Excluir histórico de eventos". Essa ação não pode ser desfeita.

Propriedades de eventos

As Propriedades de Eventos fornecem informações contextuais sobre os eventos. Eles permitem uma compreensão mais profunda sobre as ações que os usuários tomam em seu aplicativo.

Exemplos de eventos e propriedades são:

  • Nome do evento: "Carregamento de Arquivo", Propriedades do evento: ".PDF", ".txt", ".PNG".
  • Nome do evento: "Pergunta respondida", Propriedades do evento: "Aceitar", "Recusar", "Ignorar".

Os valores de propriedade são otimizados para valores do tipo 'String'.

Limites

  • O número máximo de eventos personalizados distintos que podem ser rastreados diariamente é 200. Essa contagem é redefinida às 12h UTC. No entanto, não há um limite no número máximo de instâncias de eventos enviadas por dispositivo.
  • O número máximo de nomes de propriedade de evento e/ou valores por evento é 20. Quando mais de 20 nomes de propriedade e/ou valores são enviados, somente os primeiros 20 são processados e o restante é descartado automaticamente.
  • O SDK trunca os nomes de eventos para os primeiros 256 caracteres.
  • O SDK trunca cada chave de propriedade e o valor para os primeiros 125 caracteres.
  • O portal mostrará até os 10 valores de propriedade com contagens mais altas.

Os eventos podem ajudá-lo a identificar a causa raiz das falhas do aplicativo. Como parte do serviço de Falhas do App Center, você pode ver todos os eventos que ocorreram antes de uma falha para uma sessão específica.

Para ver os eventos antes de uma falha, integre o SDK do Analytics ao aplicativo e defina um ou mais eventos.

As barras de pão são armazenadas por 28 dias, enquanto as falhas podem ser armazenadas indefinidamente. Isso significa que, se você estiver olhando para um acidente com mais de 28 dias, não verá as migalhas de pão correspondentes.

Erros tratados

Para acompanhar erros tratados no App Center, recomendamos que você use a funcionalidade específica para ele. Confira mais informações sobre este tópico em nossa documentação oficial.