Programa de aplicação de ambiente de trabalho do Windows

Pode obter dados de telemetria detalhados e relatórios analíticos que lhe permitem ver o desempenho das suas aplicações de ambiente de trabalho do Windows através do novo Programa de Aplicações de Ambiente de Trabalho do Windows. Para exibir esses relatórios, navegue até o painel do Partner Center >Insights> Aplicativos da Área de Trabalho do Windows e clique em Visão geral.

Não há nenhum custo para acessar esses dados, tudo o que você precisa fazer é se inscrever e aceitar o Windows Desktop Application Program Agreemente, em seguida, carregar um arquivo assinado usando o mesmo certificado que você usou para assinar os arquivos executáveis do aplicativo.

Adira ao Programa de Aplicação de Ambiente de Trabalho do Windows

Se a sua empresa já tiver uma conta do Partner Center: Inicie sessão na sua conta do Partner Center (utilizando a conta Microsoft associada ao proprietário da conta) e navegue até à página Programas (no Configurações da conta ou selecionando Todos os no menu de navegação esquerdo). Em Windows Desktop Application Program, clique em de Introdução para aderir ao programa sem custos adicionais. Se você tiver um locatário do Azure AD associado à sua conta do Partner Center, os usuários adicionados poderão acessar o Programa de Aplicativo da Área de Trabalho do Windows. Em breve, permitiremos que você defina um acesso mais granular para este programa.

Dica

Se sua empresa tiver uma conta do Partner Center, mas você não tiver acesso a ela, peça ao administrador para adicioná-lo como usuário. Tenha em atenção que apenas o proprietário da conta pode aderir ao Programa de Aplicação de Ambiente de Trabalho do Windows.

Se a sua empresa não tiver uma conta do Partner Center: Você pode se inscrever no Windows Desktop Application Program diretamente sem nenhum custo. Em breve, forneceremos a opção de associar um locatário do Azure AD à sua conta para que outras pessoas em sua empresa também possam entrar.

Adicione as suas aplicações de ambiente de trabalho

Depois de aderir ao programa, terá de adicionar as suas aplicações de ambiente de trabalho do Windows ao seu painel para que possamos começar a mostrar-lhe os seus relatórios analíticos.

Usamos assinatura de código para estabelecer a identidade da sua empresa e recuperar análises para aplicativos que você publica.

Forneceremos um arquivo e solicitaremos que você o assine com os mesmos certificados de assinatura de código válidos, não expirados e não revogados que você usa para assinar seus aplicativos da área de trabalho. Depois disso, você carregará esse arquivo assinado para seu painel. Isso nos permite saber que todos os aplicativos de desktop assinados com o mesmo certificado pertencem à sua conta. Não utilizamos as informações do seu certificado para qualquer outra finalidade.

Importante

Não é necessário repetir este processo se lançar uma nova aplicação de ambiente de trabalho. Depois de carregar o arquivo assinado, identificaremos automaticamente todos os novos aplicativos assinados com o mesmo certificado e recuperaremos automaticamente as análises desses produtos. Você também não precisa distribuir o arquivo fornecido em seus aplicativos ou enviar qualquer tipo de mapeamento para seus produtos

Para adicionar uma ou mais aplicações de ambiente de trabalho

1. No seu painel, selecione Adicionar aplicativos da área de trabalho .
2. Na página seguinte, transfira o ficheiro assinado, selecionando Transferir o ficheiroe, em seguida, guarde o ficheiro no computador.
3. Assine o arquivo que você acabou de baixar usando o mesmo certificado de assinatura de código que você usa para autenticar seus aplicativos da área de trabalho. Você pode usar SignTool.exe (disponível no Microsoft Visual Studio e como parte do Windows SDK) para assinar esse arquivo. Mais detalhes sobre este processo são descritos abaixo.
4. Carregue o ficheiro que acabou de assinar arrastando-o para o campo (ou clique para procurar os seus ficheiros).
5. Selecione Enviar para concluir o processo.

Se você usar mais de um certificado de assinatura de código, poderá repetir as etapas acima para cada um dos certificados. Você pode baixar, assinar e carregar um arquivo para cada certificado atual usado para assinar seus aplicativos. No entanto, você só pode usar um certificado por arquivo baixado.

Depois de concluir essas etapas, identificaremos quais aplicativos da área de trabalho do Windows são assinados com o mesmo certificado que você usou para assinar nosso arquivo. Na maioria dos casos, começaremos a mostrar relatórios analíticos dentro de 48 horas, embora ocasionalmente possa demorar um pouco mais.

Use signtool.exe para assinar o arquivo baixado

A Microsoft fornece uma ferramenta para assinar arquivos, SignTool.exe, com o Visual Studio e no SDK do Windows. Você pode usar essa ferramenta para executar e verificar o processo de assinatura de código. Mais informações sobre SignTool.exe estão disponíveis aqui.

Aqui estão duas das maneiras mais comuns de usar essa ferramenta para assinar o arquivo assinado.

• Se você tiver acesso ao certificado de assinatura de código como um arquivo de do Personal Information Exchange (PFX):

  signtool sign /f MyCert.pfx /p MyCertPassword /v SignableFile.bin
  

  

• Se o certificado de assinatura de código estiver disponível em seu armazenamento de certificados local:

  Signtool sign /v /s MY /n CertSubjectName SignableFile.bin
  

  

Depois de assinar o arquivo, você pode verificar se ele foi assinado com êxito com um certificado válido com o seguinte:

signtool verify /a SignableFile.bin

Visualizando seus dados analíticos

Depois que seus arquivos assinados forem carregados e identificarmos seus aplicativos da área de trabalho, seu painel mostrará uma visão geral de seus aplicativos, juntamente com as principais métricas.

Nossos dados de telemetria mostrarão informações de integridade, como falhas para cada aplicativo associado ao seu certificado. Seu painel mostrará uma visão geral de seus aplicativos, juntamente com as principais métricas. Você pode selecionar qualquer aplicativo para exibir seus de relatórioIntegridade, relatório Instalae relatório Bloqueia no painel. Você também pode recuperar dados analíticos programaticamente usando a API de análise da Microsoft Store.

Observação

Se detetarmos que os metadados de um aplicativo foram atualizados para usar um novo nome, começaremos a relatar novos dados com o novo nome. Os dados históricos associados ao nome antigo serão preservados por 30 dias.

O Google Analytics não estará disponível para um aplicativo até que ele tenha sido instalado em pelo menos 100 dispositivos.

Relatório sobre a saúde

O relatório Health permite obter dados relacionados ao desempenho e à qualidade do seu aplicativo, incluindo falhas e eventos que não respondem. Quando aplicável, você pode visualizar rastreamentos de pilha e/ou arquivos CAB para depuração adicional.

Você pode filtrar os dados de várias maneiras, permitindo:

• Exibir um resumo de todos os tipos de falha, classificados por número de acertos
• Analise detalhadamente uma falha específica e baixe rastreamentos de pilha para depurar o problema mais rapidamente
• Compare uma nova versão do seu aplicativo com as versões anteriores
• Exibir dados de integridade de forma agregada ou por região, permitindo isolar problemas específicos de uma região
• Compare o desempenho das suas aplicações de ambiente de trabalho em versões do Windows ou numa versão específica, como a versão mais recente do Windows 10
• Exibir informações de integridade de um arquivo executável específico incluído em seu aplicativo

Selecione Carregar símbolos na parte superior da tabela Falhas para carregar um arquivo .zip contendo os arquivos de símbolos do seu aplicativo. Esses arquivos de símbolos serão indexados e usados para produzir traços de pilha mais precisos. Os tipos de arquivo de símbolo dentro do .zip devem ser .pdb, .dllou .exe. Depois de carregar com sucesso o seu ficheiro .zip, deverá ver menos ! Valores de desconhecidos para novas falhas na lista de falhas do seu aplicativo em aproximadamente 5 dias.

Instala relatório

O relatório Instala permite ver em quantos dispositivos um aplicativo foi instalado em um determinado dia e o número médio de dispositivos em que cada versão do aplicativo foi instalada nos últimos 30 dias.

Você pode filtrar os dados de várias maneiras, permitindo:

• Veja um resumo das suas instalações, ordenadas por popularidade
• Compare uma nova versão do seu aplicativo com as versões anteriores
• Ver dados de instalação agregados ou por região
• Compare o desempenho das suas aplicações de ambiente de trabalho em versões do Windows ou numa versão específica, como a versão mais recente do Windows 10 ou as versões Fast e Slow do Windows Insider

Relatório de blocos de aplicativos

O relatório Application bloqueia permite que você veja informações sobre dispositivos Windows 10 nos quais seu aplicativo está afetando as atualizações do Windows 10. Você pode ver quantos dispositivos foram afetados em um determinado dia, juntamente com o número médio de dispositivos nos últimos 30 dias.

Os tipos de blocos de atualização incluídos são os seguintes:

Categoria	Questão	Descrição	Orientações fornecidas aos utilizadores
Sedimentos potenciais	Bloqueará a atualização	O aplicativo não funcionará na nova versão de lançamento do sistema operacional. A ação do usuário é necessária durante a configuração para prosseguir com a atualização.	Remova o aplicativo antes de atualizar e verifique com o desenvolvedor para uma versão compatível do aplicativo.
Sedimentos temporários	Pode bloquear a atualização. Necessidade de testar a aplicação.	A Microsoft está investigando problemas de atualização relacionados a este aplicativo. A atualização não será implementada para usuários que possam ser afetados.	Remova o aplicativo antes de atualizar e verifique com o desenvolvedor para uma versão compatível do aplicativo.
Notificação de tempo de execução	Pode não funcionar corretamente na nova versão do sistema operacional, mas não bloqueará a atualização	O aplicativo não impedirá a atualização, mas foram detetados problemas que podem impedi-lo de funcionar corretamente na nova versão do sistema operacional.	Nenhuma ação é necessária para que a atualização continue, mas certifique-se de testar o aplicativo na nova versão do sistema operacional e verifique com o desenvolvedor se há uma versão compatível, se necessário.

Recuperar dados analíticos usando a API de análise da Microsoft Store

A API de análise da Microsoft Store permite recuperar programaticamente dados analíticos de aplicativos que você adicionou à sua conta.

Esta API oferece os seguintes métodos específicos para o Windows Desktop Application Program:

• instala o
• Falha atinge
• Detalhes da falha
• de rastreamento de pilha
• arquivo CAB
• Blocos de atualização
• Detalhes do bloco de atualização

Para saber mais sobre como usar essa API, veja acessar dados analíticos usando os serviços da Loja.

Gerir os metadados da sua aplicação de ambiente de trabalho

Usamos o nome do arquivo, a versão do arquivo, o nome do produto e os metadados da versão do produto em seus arquivos executáveis para inferir os agrupamentos lógicos dos executáveis em aplicativos. Se os arquivos executáveis não tiverem metadados precisos, eles poderão aparecer juntos sob um nome de aplicativo Desconhecido ou o nome do aplicativo será padronizado para o nome executável individual.

Manter os metadados de seus aplicativos e arquivos atualizados ajuda a garantir que eles sejam representados corretamente em seu painel. Aqui estão algumas recomendações:

• Use seu certificado para assinar todos os arquivos executáveis que você deseja ver em seu relatório de análise, não apenas seus executáveis de configuração.
• Forneça informações consistentes sobre o nome do produto e a versão do produto para todos os arquivos executáveis que pertencem ao mesmo aplicativo (ou seja, Meu aplicativo). Se alguns dos seus ficheiros executáveis forem distribuídos com várias aplicações, dê-lhes nomes exclusivos (ou seja, Componentes partilhados) para que possa ver análises para esses executáveis separadamente das aplicações com as quais foram distribuídos.
• Toda vez que você fizer alterações em seus metadados, poderá ver uma nova entrada para seu aplicativo em seu painel. Se você fizer uma alteração, os novos dados de telemetria de entrada refletirão suas alterações, mas os dados de telemetria antigos ainda aparecerão como um aplicativo Desconhecido.
• Ao revisar um arquivo, atualize a versão do aplicativo e os números de versão do produto.

  Dica

  Use recursos de VERSIONINFO para definir o FileDescription, FileVersion, ProductNamee ProductVersion para seus arquivos e aplicativos. O exemplo a seguir define um recurso VERSIONINFO:

  #define VER_PRODUCTNAME_STR      "Sample App"
  #define VER_PRODUCTVERSION       3,10,349,0
  #define VER_PRODUCTVERSION_STR   "3.10.349.0\0"
  #define VER_FILEDESCRIPTION_STR  "Sample File"
  #define VER_FILEVERSION          3,10,349,0
  #define VER_FILEVERSION_STR      "3.10.349.0\0"
  #define VER_COMPANYNAME_STR     "XYZ Corp."
  #define VER_LEGALCOPYRIGHT_STR   "Copyright \251 XYZ Corp." 
   
  VS_VERSION_INFO VERSIONINFO
  FILEVERSION VER_FILEVERSION
  PRODUCTVERSION VER_PRODUCTVERSION
  FILEFLAGSMASK VER_FILEFLAGSMASK
  FILEFLAGS VER_FILEFLAGS
  FILEOS VER_FILEOS
  FILETYPE VER_FILETYPE
  FILESUBTYPE VER_FILESUBTYPE
  BEGIN
      BLOCK "StringFileInfo"
      BEGIN
          BLOCK "040904E4"
          BEGIN
              VALUE "ProductName",      VER_PRODUCTNAME_STR
              VALUE "ProductVersion",   VER_PRODUCTVERSION_STR
              VALUE "FileDescription",  VER_FILEDESCRIPTION_STR
              VALUE "FileVersion",      VER_FILEVERSION_STR
              VALUE "CompanyName",      VER_COMPANYNAME_STR
              VALUE "LegalCopyright",   VER_LEGALCOPYRIGHT_STR
          END
      END
       
  END 
  

Adicionar e gerenciar usuários da conta

Você pode usar o Azure Ative Directory para adicionar e gerenciar usuários adicionais em sua conta do Programa de Aplicativo de Área de Trabalho do Windows. Você pode adicionar usuários individuais, grupos de usuários ou aplicativos do Azure AD, dando a cada um deles uma função predefinida (Gerente ou Desenvolvedor).

Associar o Azure Ative Directory à sua conta

Para adicionar e gerenciar usuários de conta, você deve primeiro associar sua conta ao Azure Ative Directory da sua organização. Se a sua organização já utiliza o Office 365 ou outros serviços empresariais da Microsoft, já tem o Azure AD. Caso contrário, você pode criar um novo locatário do Azure AD sem custo adicional.

Consulte Associar o Azure Ative Directory à sua conta do Partner Center para obter mais informações. Embora o tópico se concentre no programa de desenvolvedor de aplicativos do Windows, associar um locatário funciona da mesma maneira para o Programa de Aplicativo da Área de Trabalho do Windows.

Adicionar usuários, grupos e aplicativos do Azure AD à sua conta

Depois de configurar a associação do Azure AD, você pode adicionar usuários acessando a seção Usuários em Configurações da conta. Cada usuário recebe uma função que define seu acesso à conta. Você também pode adicionar grupos de usuários e aplicativos do Azure AD para conceder a eles acesso à sua conta do Partner Center. Para saber mais sobre como adicionar usuários, veja Adicionar usuários, grupos e aplicativos do Azure AD.

Cada usuário, grupo ou aplicativo do Azure AD adicionado à sua conta deve receber uma função. Esse processo é descrito em Definir funções ou permissões personalizadas para usuários de conta. No entanto, observe que, para o Windows Desktop Application Program, não há capacidade de atribuir permissões personalizadas ou restringir o acesso por produto. Em vez disso, cada usuário deve receber uma das seguintes funções padrão.

Funções	Descrição
Gestor	Pode carregar e remover certificados e pode visualizar todos os dados analíticos. Tem acesso completo à conta, exceto para alterar informações financeiras. Isso inclui o gerenciamento de usuários, mas observe que a capacidade de criar e excluir usuários no locatário do Azure AD depende da permissão da conta no Azure AD. Ou seja, se um usuário receber a função de gerente, mas não tiver permissões de administrador global no Azure AD da organização, ele não poderá criar novos usuários ou excluir usuários do diretório (embora possa alterar a função de conta de um usuário). Observe que, se sua conta estiver associada a mais de um locatário do Azure AD, um gerente não poderá ver detalhes completos de um usuário (incluindo nome, sobrenome, email de recuperação de senha e se ele é um administrador global do Azure AD), a menos que ele esteja conectado ao mesmo locatário que esse usuário com uma conta que tenha permissões de administrador global para esse locatário. No entanto, eles podem adicionar e remover usuários em qualquer locatário associado à conta.
Desenvolvedor	Pode exibir aplicativos e detalhes do certificado associados à conta e pode exibir o relatório de Integridade do e Instala. Não é possível visualizar informações financeiras ou configurações da conta.

Perguntas Frequentes

• Por que não vejo dados para um aplicativo? Não mostraremos dados até detetarmos usuários suficientes para coletar informações significativas. Se você acabou de lançar seu aplicativo, pode levar algum tempo para atingir esse limite mínimo de adoção. Outra razão pela qual você pode não ver os dados é se você não assinou um arquivo com o certificado para um determinado aplicativo. Certifique-se de carregar arquivos assinados com cada certificado que você usa para assinar seus aplicativos.
• Posso aceder a estes dados através de uma API? Sim, os dados serão disponibilizados através de uma API pública quando o programa estiver disponível para todos os desenvolvedores.
• E as candidaturas com certificados mais antigos? Infelizmente, não suportamos o envio de certificados expirados ou revogados, mesmo que você os renove com a mesma chave.
• Porque é que vejo uma aplicação que não reconheço? Se o certificado que você usa para assinar arquivos em seu aplicativo também for usado por outra pessoa em sua empresa para assinar outro aplicativo, você verá telemetria para esse aplicativo também. No futuro, forneceremos uma opção para ocultar aplicativos do seu painel. Se a conta da sua empresa estiver anexada a um locatário do Azure AD, você poderá solicitar que seu administrador modifique as permissões de usuário para que apenas aplicativos específicos fiquem visíveis para você.
• Como posso dar feedback sobre a experiência ou obter suporte? Se precisar de ajuda, pode criar um pedido de suporte aqui. Para compartilhar seus comentários, use o link Comentários (em Configurações da conta) e selecione a área do Analytics para nos informar o que você pensa.