Compartilhar via


Dados coletados por SDKs do App Center

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.

Os SDKs do App Center enviam dados para os serviços do App Center. Os dados enviados variam de acordo com o SDK/serviço usado, como um SDK é configurado e para o serviço de falha, nos dados manipulados pelo aplicativo. O uso de alguns serviços exige que determinados dados sejam enviados para que o serviço funcione. Todos os dados enviados para o App Center viajam por meio de um serviço de ingestão central.

Dados comuns

Dados enviados por meio de cabeçalhos de solicitação do SDK para a Ingestão

Dados necessários – App-Secret, Install-ID

  • Segredo do Aplicativo (Segredo do Aplicativo) Uma chave exclusiva usada para identificar o aplicativo.

  • Identificador de Instalação (Install-ID) Cada instalação de um aplicativo com um SDK do App Center resulta em um novo identificador de instalação exclusivo. Essa ID é usada para diferenciar dados de dispositivos exclusivos. Os serviços do App Center exigem que a ID funcione corretamente.

Dados enviados por meio do corpo da solicitação do SDK para a Ingestão

Dados necessários – sdkName, sdkVersion, osName, osVersion, locale, timeZoneOffset, appVersion, appBuild

  • Carimbo de data/hora (carimbo de data/hora) Carimbo de data/hora do log, exemplo: '2017-03-13T18:05:42Z'

  • Identificador de Sessão (sid) Os logs de análise podem fazer parte da mesma sessão especificando esse identificador.

  • Identificador de Usuário (userId) Uma cadeia de caracteres opcional usada para associar logs com usuários.

  • Nome do SDK (sdkName) O nome do SDK. Consiste no nome do SDK e da plataforma, por exemplo, "appcenter.ios", "hockeysdk.android"

  • Versão do SDK (sdkVersion) A versão do SDK no formato semver, por exemplo, "1.2.0" ou "0.12.3-alpha.1"

  • Versão do Wrapper do SDK (wrapperSdkVersion) A versão do SDK do wrapper no formato semver. Quando o SDK encapsula um SDK base, a versão do SDK de encapsulamento é capturada nesse campo, enquanto a versão base do SDK é o sdkVersion. Por exemplo, o Xamarin.Android encapsula o Android nativo.

  • Nome do Wrapper do SDK (wrapperSdkName) O nome do SDK do wrapper. Consiste no nome do SDK e da plataforma wrapper, por exemplo, "appcenter.xamarin", "hockeysdk.cordova".

  • Modelo (modelo) O modelo de dispositivo (exemplo: iPad2,3)

  • Nome OEM (oemName) O nome do fabricante do dispositivo (exemplo: HTC)

  • Nome do sistema operacional (osName) Nome do sistema operacional (exemplo: iOS)

  • Versão do sistema operacional (osVersion) Versão do sistema operacional (exemplo: 9.3.0)

  • Código de build do sistema operacional (osBuild) Código de build do sistema operacional (exemplo: LMY47X)

  • Nível de API do Sistema Operacional (osApiLevel) Nível de API quando aplicável, como no Android (exemplo: 15)

  • Código de Idioma e País (localidade) Código de país e idioma ISO (exemplo: en-US)

  • Deslocamento de fuso horário (timeZoneOffset) O deslocamento em minutos de UTC para o fuso horário do dispositivo, incluindo o horário de verão.

  • Tamanho da Tela (screenSize) O tamanho da tela do dispositivo em pixels (exemplo: 640x480).

  • Versão do aplicativo (appVersion) A versão do aplicativo normalmente em build principal, secundário (exemplo: 1.1.42)

  • Nome da operadora (carrierName) O nome do provedor de serviços de célula.

  • País da transportadora (carrierCountry) O país do provedor de serviços de célula.

  • Build do aplicativo (appBuild) O número de build do aplicativo. (exemplo: 42)

  • Namespace do Aplicativo (appNamespace) O identificador de pacote, o identificador de pacote ou o namespace, dependendo do que a plataforma individual usa (exemplo: com.microsoft.example)

  • Rótulo de versão de atualização dinâmica (liveUpdateReleaseLabel) O rótulo usado para identificar o código do aplicativo "versão" lançado por meio do sinalizador de Atualização Dinâmica em execução no dispositivo.

  • Chave de implantação de atualização dinâmica (liveUpdateDeploymentKey) O identificador do ambiente ao qual a versão atual do aplicativo pertence, a chave de implantação é mapeada para o ambiente, como Produção, Preparo

  • Hash do pacote de atualização ao vivo (liveUpdatePackageHash) Um hash de todos os arquivos (ReactNative ou Cordova) implantados no dispositivo por meio do sinalizador LiveUpdate. Ajuda a identificar a versão de Versão no dispositivo ou a necessidade de baixar atualizações no futuro

  • Versão do wrapper de runtime (wrapperRuntimeVersion) A versão da estrutura de tecnologia wrapper (versão de runtime do Xamarin, ReactNative, Cordova e assim por diante). Consulte wrappersdkname para ver se essa versão se refere a Xamarin ou ReactNative ou outro.

  • Jailbreak (jailbreak) Um sinalizador que indica se o dispositivo foi ininterrupto.

Análise

  • Métricas de engajamento O Engagement mede as sessões diárias por usuário e duração da sessão.

    • Sessões diárias por usuário: número médio diário de sessões por usuário.

    • Total de sessões: número total de sessões.

    • Média de sessões por dia: número de sessões por dia média ao longo do intervalo de tempo.

    • Duração da sessão: distribuição do número de sessões em alguns intervalos de duração.

    • Duração média da sessão: média de todas as durações da sessão no intervalo de tempo selecionado.

  • Métricas de evento Você pode acompanhar suas próprias métricas de evento com até 20 propriedades para entender a interação entre os usuários e o aplicativo.

Diagnósticos

  • Dados de logs de erros e falhas Esses dados incluem a ID e o nome dos processos, threads, quadros, relacionados à falha e ao tipo de exceção e dados de mensagem e dispositivo, conforme definido na seção Dados Comuns

  • Anexos de falha Esses anexos são arquivos binários ou de texto que os desenvolvedores podem anexar opcionalmente a um relatório de falha.

  • Propriedades personalizadas Opcionalmente, esses pares de valores de chave personalizados podem ser especificados para adicionar contexto adicional aos relatórios de erro.

  • Falha e erro ID do usuário Opcionalmente, esse identificador exclusivo é definido pelo desenvolvedor para anexar a identificação de um usuário específico a relatórios de falha.

  • Arquivos de símbolo Esses arquivos de símbolo são fornecidos pelo desenvolvedor do App Center para simbolizar falhas.

Distribuir

  • Token Esse GUID é enviado ao serviço de distribuição para marcar para uma nova versão do aplicativo. O GUID só será enviado se o aplicativo tiver sido instalado usando o App Center.