Solucionar problemas de ferramentas de análise de comportamento do usuário no Aplicativo Azure Insights

  • Artigo

Este artigo fornece respostas para perguntas comuns sobre as ferramentas de análise de comportamento do usuário no Application Insights. Essas ferramentas incluem:

Contando usuários

As ferramentas de análise de comportamento do usuário mostram que meu aplicativo tem um usuário/sessão, mas sei que meu aplicativo tem muitos usuários/sessões. Como posso corrigir essas contagens incorretas?

Todos os eventos de telemetria no Application Insights têm uma ID de usuário anônima e uma ID de sessão como duas de suas propriedades padrão. Por padrão, todas as ferramentas de análise de uso contam os usuários e as sessões com base nessas IDs. Se essas propriedades não estiverem sendo preenchidas com IDs exclusivas para cada usuário e sessão do seu aplicativo, você verá uma contagem incorreta de usuários e sessões nas ferramentas de análise de uso.

Se você estiver monitorando um aplicativo Web, a solução mais fácil é adicionar o SDK JavaScript do Application Insights ao seu aplicativo. Verifique se o snippet de script está carregado em cada página que você deseja monitorar. O SDK do JavaScript gera automaticamente IDs anônimas de usuário e sessão e, em seguida, preenche eventos de telemetria com essas IDs à medida que são enviadas do seu aplicativo.

Se você estiver monitorando um serviço Web (sem interface do usuário), crie um inicializador de telemetria que preencha as propriedades anônimas de ID do usuário e da ID da sessão de acordo com as noções de usuários e sessões exclusivas do seu serviço.

Se seu aplicativo estiver enviando IDs de usuário autenticadas, você poderá contar com base em IDs de usuário autenticadas na ferramenta usuários. Na lista suspensa Mostrar , escolha Usuários autenticados.

Atualmente, as ferramentas de análise de comportamento do usuário não dão suporte à contagem de usuários ou sessões com base em propriedades diferentes da ID anônima do usuário, ID de usuário autenticada ou ID da sessão.

Eventos de nomenclatura

Meu aplicativo tem milhares de nomes de eventos personalizados e exibição de páginas diferentes. É difícil distinguir entre eles e as ferramentas de análise de comportamento do usuário geralmente ficam sem resposta. Como posso corrigir esses problemas de nomenclatura?

O modo de exibição de página e os nomes de eventos personalizados são usados em todas as ferramentas de análise de comportamento do usuário. Nomear eventos bem é fundamental para obter valor dessas ferramentas. A meta é um equilíbrio entre ter nomes muito poucos e excessivamente genéricos (por exemplo, "Botão clicado") e ter muitos nomes excessivamente específicos (por exemplo, "Botão Editar clicado em 'http://www.contoso.com/index'").

Para fazer alterações na exibição de página e nomes de eventos personalizados que seu aplicativo está enviando, altere o código-fonte do aplicativo e reimplante. Todos os dados de telemetria no Application Insights são armazenados por 90 dias e não podem ser excluídos, portanto, as alterações feitas em nomes de eventos levarão 90 dias para se manifestar totalmente. Nos 90 dias após fazer alterações de nome, os nomes de eventos antigos e novos aparecerão em sua telemetria. Certifique-se de ajustar consultas e se comunicar em suas equipes de acordo.

Se o aplicativo estiver enviando muitos nomes de exibição de página, marcar para ver se esses nomes de exibição de página são especificados manualmente no código ou se estão sendo enviados automaticamente pelo SDK JavaScript do Application Insights:

  • Se os nomes de exibição de página forem especificados manualmente no código usando a API trackPageView, altere o nome para ser menos específico. Evite erros comuns, como colocar a URL no nome da exibição da página. Em vez disso, especifique a URL como um parâmetro na trackPageView API. Mova outros detalhes do nome de exibição de página para propriedades personalizadas.

  • Se o SDK JavaScript do Application Insights estiver enviando automaticamente nomes de exibição de página, você poderá alterar os títulos de suas páginas ou alternar para enviar manualmente nomes de exibição de página. O SDK envia o título de cada página como o nome de exibição da página, por padrão. Você pode mudar seus títulos para ser mais geral, mas esteja atento ao SEO e outros impactos que essa mudança pode ter. Especificar manualmente nomes de exibição de página com a trackPageView API substitui os nomes coletados automaticamente, o que significa que você pode enviar mais nomes gerais na telemetria sem alterar títulos de página.

Se o aplicativo estiver enviando muitos nomes de eventos personalizados, altere o nome no código para ser menos específico. Novamente, evite colocar URLs e outras informações por página ou dinâmicas diretamente nos nomes de eventos personalizados. Em vez disso, mova esses detalhes para propriedades personalizadas do evento personalizado com a API trackEvent. Por exemplo, em vez de appInsights.trackEvent("Edit button clicked on http://www.contoso.com/index"), sugerimos algo como appInsights.trackEvent("Edit button clicked", { "Source URL": "http://www.contoso.com/index" }).

Próximas etapas

Obter ajuda

Aviso de isenção de responsabilidade para informações de terceiros

Os produtos de terceiros mencionados neste artigo são produzidos por empresas independentes da Microsoft. A Microsoft não oferece nenhuma garantia, implícita ou não, do desempenho ou da confiabilidade desses produtos.

Entre em contato conosco para obter ajuda

Se você tiver dúvidas ou precisar de ajuda, crie uma solicitação de suporte ou peça ajuda à comunidade de suporte do Azure. Você também pode enviar comentários sobre o produto para a comunidade de comentários do Azure.