Partilhar via


Dados coletados por SDKs do App Center

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, exceto para os recursos de Análise e Diagnóstico, que continuarão a ter suporte até 30 de junho de 2026. Mais informações.

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 seu aplicativo. A utilização de alguns serviços requer o envio de determinados dados para que o serviço funcione. Todos os dados enviados para o App Center passam por um serviço central de ingestão.

Dados comuns

Dados enviados através de cabeçalhos de solicitação do SDK para o Ingestion

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

  • Segredo de aplicação (App-Secret) 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. Esse ID é usado para diferenciar dados de dispositivos exclusivos. Os serviços do App Center exigem que o ID funcione corretamente.

Dados enviados através 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 do registo, exemplo: '2017-03-13T18:05:42Z'

  • Identificador de sessão (sid) Os logs do Google Analytics podem fazer parte da mesma sessão especificando esse identificador.

  • Identificador de usuário (userId) Uma cadeia de caracteres opcional usada para associar logs a 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 em formato semver, por exemplo, "1.2.0" ou "0.12.3-alpha.1"

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

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

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

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

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

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

  • Código de compilação do sistema operacional (osBuild) Código de compilação do SO (exemplo: LMY47X)

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

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

  • Deslocamento de fuso horário (timeZoneOffset) O deslocamento em minutos do 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 versão principal, secundária, de compilação (exemplo: 1.1.42)

  • Nome da operadora (carrierName) O nome do provedor de serviços de telecomunicações móveis.

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

  • Compilação de aplicativos (appBuild) O número de compilação do aplicativo. (exemplo: 42)

  • Namespace do aplicativo (appNamespace) O identificador de bundle, identificador de pacote ou namespace, dependendo do que cada plataforma usa (exemplo: com.microsoft.example)

  • Rótulo de lançamento de atualização ao vivo (liveUpdateReleaseLabel) O rótulo que é usado para identificar a 'versão' do código do aplicativo lançado através do beacon do Live Update em execução no dispositivo.

  • Chave de implantação do Live Update (liveUpdateDeploymentKey) O identificador do ambiente ao qual pertence a versão atual do aplicativo, a chave de implantação é associada a ambientes como Produção e Staging

  • Hash do pacote de atualização ao vivo (liveUpdatePackageHash) Um hash de todos os ficheiros (ReactNative ou Cordova) despachados para o dispositivo via beacon LiveUpdate. Ajuda a identificar a versão de lançamento no dispositivo ou a necessidade de baixar atualizações no futuro

  • Versão do Wrapper de Tempo de Execução (wrapperRuntimeVersion) A versão da estrutura tecnológica do wrapper (versão do tempo de execução do Xamarin, ReactNative, Cordova, e assim por diante). Consulte wrappersdkname para ver se esta versão se refere ao Xamarin ou ReactNative ou outro.

  • Jailbreak (jailbreak) Um indicador indicando se o dispositivo foi sujeito a jailbreak.

Análises de Dados

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

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

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

    • Média de sessões por dia: Número de sessões por dia em 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 eventos Você pode acompanhar suas próprias métricas de eventos com até 20 propriedades para entender a interação entre seus usuários e o aplicativo.

Diagnóstico

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

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

  • Propriedades personalizadas Esses pares de valores de chave personalizados podem, opcionalmente, ser especificados para adicionar contexto adicional aos seus relatórios de erros.

  • ID de usuário de falha e erro Esse identificador exclusivo é opcionalmente definido pelo desenvolvedor para anexar a identificação específica do usuário aos relatórios de falhas.

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

Distribuir

  • Símbolo Esse GUID é enviado para o serviço de distribuição para verificar se há uma nova versão do aplicativo. O GUID só é enviado se o aplicativo tiver sido instalado usando o App Center.