Dados coletados por SDKs do App Center

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 requer que determinados dados sejam enviados para que o serviço funcione. Todos os dados enviados ao App Center passam por um serviço de ingestão central.

Dados comuns

Dados enviados por meio de cabeçalhos de solicitação do SDK para o sistema de ingestão

Dados necessários – Segredo do Aplicativo, Install-ID

• Segredo do Aplicativo (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. 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

• Timestamp (timestamp) Timestamp 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 da SDK Wrapper (wrapperSdkVersion) A versão da 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 wrapper do SDK. 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)

• 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 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 no build principal, secundário (exemplo: 1.1.42)

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

• País da Operadora (carrierCountry) O país do provedor de serviços de telecomunicações.

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

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

• Rótulo de versão de atualização ao vivo (liveUpdateReleaseLabel) O rótulo usado para identificar a "versão" do código do aplicativo lançada por meio do sinalizador de Atualização Ao Vivo em execução no dispositivo.

• Chave de Implantação da Atualização ao Vivo (liveUpdateDeploymentKey) O identificador do ambiente ao qual a versão atual do aplicativo pertence. A chave de implantação então é associada ao ambiente, como Produção, Teste.

• Hash do pacote de atualização ao vivo (liveUpdatePackageHash) Um hash de todos os arquivos (ReactNative ou Cordova) implantados no dispositivo através do sinalizador 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 Runtime (wrapperRuntimeVersion) A versão da estrutura tecnológica do wrapper (versão do Xamarin runtime, ReactNative, Cordova, e assim por diante). Consulte wrappersdkname para ver se essa versão se refere a Xamarin ou ReactNative ou outro.

• Jailbreak (jailbreak) Uma indicação que mostra se o dispositivo foi modificado por jailbreak.

Análises de dados

• Métricas de participação O Engagement mede as sessões diárias por usuário e a 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.

  • Comprimento médio 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 falha e erro 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 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.

• ID de usuário para falhas e erros Esse identificador exclusivo é definido opcionalmente pelo desenvolvedor para associar a identificação de um usuário específico aos relatórios de falhas.

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

Distribuir

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