Perguntas frequentes de Análise

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 migrar.

Saiba mais sobre linhas do tempo e alternativas de suporte.

Os dados são amostrados?

Os dados não são amostrados. A análise usará todos os dados enviados, a menos que sejam enviados no formato errado ou alguns dos limites conhecidos sejam atingidos.

Qual é a latência entre um log enviado e sua representação nos painéis do Analytics?

Normalmente, a latência é de alguns minutos.

Se o aplicativo estiver offline, o SDK armazenará os logs e os enviará quando estiver online novamente?

Sim. Quando não há conectividade de rede, o SDK salva até 10 MB (por padrão) de logs no armazenamento local. O tamanho do armazenamento pode ser alterado por meio da setMaxStorageSize API. Quando o armazenamento estiver cheio, o SDK começará a descartar logs antigos para liberar espaço para os novos logs. Depois que a conectividade de rede for restaurada, o SDK enviará esses logs para o back-end do App Center.

A duração da sessão é desconhecida, por quê?

Uma sessão é definida como a hora do aplicativo chegando em primeiro plano até o último evento antes de ir para o segundo plano. Se nenhum evento personalizado for identificado dentro de 5 minutos em uma sessão, a sessão não será contada.

Por que meu gráfico de "Distribuição do SO" mostra mais dispositivos do que o número de instalações?

As contagens de distribuição do sistema operacional não são instantâneos. São contagens de dispositivos que correspondem ao período de tempo selecionado. Por exemplo, se os usuários atualizarem de uma versão do sistema operacional para uma versão mais recente dentro do período de tempo selecionado, eles serão contados em ambas as versões do sistema operacional. Se um número significativo de usuários atualizar dentro do período de tempo, a sobreposição poderá causar visivelmente mais dispositivos no gráfico "Distribuição do SO" do que o número de instalações.

Por que as informações de país/região não estão sendo exibidas? / As informações de país/região não parecem estar corretas.

O país/região é determinado pelo país/região da operadora e exige que o dispositivo tenha um SIM. Se você estiver usando um tablet ou um dispositivo sem cartão SIM, o país/região não será relatado. Se você estiver usando um simulador, as informações de país/região provavelmente não serão precisas.

Qual é o número máximo de eventos distintos que podem ser enviados por aplicativo?

Para o Analytics, o número máximo de eventos personalizados distintos que acompanharemos por dia é 200. As contagens serão redefinidas diariamente às 12h UTC. No entanto, não há limite para o número máximo de instâncias de eventos enviadas por dispositivo.

O limite de 200 eventos distintos por dia não se aplica a Exportar. Exportamos todos os logs que aceitamos, mesmo que não os acompanhemos no Analytics.

Qual é o número máximo de propriedades de evento que posso definir por evento? O que acontece se eu enviar mais do que o limite?

Atualmente, o número máximo de propriedades de evento está definido como 20. Se mais de 20 propriedades forem enviadas, elas serão rejeitadas automaticamente.

Qual é o número máximo de valores de propriedade que posso enviar por evento?

Você verá a contagem dos 10 valores de propriedade com a contagem mais alta.

Por que não estou vendo nenhum dado no fluxo de log?

A página de fluxo de log mostrará os logs de entrada conforme eles chegam. Para começar a ver os logs fluindo, você precisará abrir a página de fluxo de log e, em seguida, começar a enviar logs do aplicativo.

Posso exportar os dados brutos?

Sim. Nas configurações do aplicativo, você pode exportar todos os dados brutos do Analytics para Armazenamento de Blobs do Azure e Application Insights.

Quais são as limitações de período de tempo para enviar um log para o App Center?

O back-end do App Center só aceitará logs que não sejam superiores a 25 dias nos últimos ou três dias no futuro.

Qual é a granularidade da resposta para a API start e end os parâmetros do Analytics?

A API de Análise retorna contadores por dia. Em outras palavras, a parte de tempo da entrada é ignorada e somente o componente de dia é levado em conta quando o resultado é processado.

Por que o valor de UserId é 'None' em eventos de análise, sessões e outros dados de análise?

A ID de usuário só pode ser aplicada ao Diagnóstico (falhas, erros) por enquanto.

A solução alternativa é adicionar o userId em Propriedades, conforme mostrado abaixo.

Map<String, String> properties = new HashMap<>();
properties.put("UserId", "your user Id");
Analytics.trackEvent("EventName", properties);