Analisar o uso de aplicativos e agentes no portal do desenvolvedor

O Portal do desenvolvedor do Microsoft Teams fornece um conjunto abrangente de ferramentas para ajudar você a analisar e entender o desempenho e o envolvimento do usuário do seu aplicativo e agente. Ao usar essas análises, você pode obter informações valiosas sobre como os usuários interagem com seu aplicativo e agente, identificar áreas de melhoria e tomar decisões baseadas em dados para aprimorar a experiência geral do usuário.

Esteja você acompanhando usuários ativos, taxas de retenção ou padrões de uso em diferentes plataformas, o Portal do desenvolvedor ajuda você com as informações necessárias para otimizar seu aplicativo e garantir seu sucesso. Os aplicativos personalizados criados para sua organização (aplicativos LOB) podem acessar dados de uso de aplicativos e agentes somente para o Teams. No entanto, para aplicativos de terceiros, você pode explorar novas dimensões do Microsoft 365, como produto host e recursos.

O uso do aplicativo e do agente para um determinado dia é refletido dentro de 24 a 48 horas, e os dados de uso dos novos aplicativos ou agentes podem levar de três a cinco dias para serem refletidos nos gráficos. Os dados de uso não são mostrados para aplicativos com menos de cinco usuários ativos ou para agentes criados usando o construtor de agentes do Copilot Studio.

Observação

A análise no portal do desenvolvedor só está disponível para aplicativos com recursos desenvolvidos sob medida (bots, extensões de mensagem, guias). Os aplicativos que são agentes puramente declarativos ou agentes do Copilot Studio não terão análises disponíveis no Portal do Desenvolvedor.

Pré-requisito

Para analisar o uso de aplicativos personalizados, o administrador de locatários (um administrador global ou um administrador do Teams) deve permitir que os dados de uso do aplicativo e do agente para aplicativos personalizados sejam mostrados no Portal do Desenvolvedor. Para permitir o uso do aplicativo e do agente:

  1. Vá para o centro de administração do Microsoft 365.
  2. Navegue até Configurações>, Configurações da organização,>Portal do desenvolvedor deserviços> para o Teams.
  3. Selecione Permitir o uso do aplicativo para que todos os aplicativos personalizados sejam exibidos no Portal do Desenvolvedor.

Para obter mais informações, consulte Permitir que os desenvolvedores usem a análise de aplicativos.

A captura de tela mostra onde o administrador pode permitir a análise de aplicativos personalizados no Centro de administração do Microsoft 365.

Introdução

Você pode exibir o uso do seu aplicativo personalizado e outros insights na página Análise . Para acessar a página:

  1. Acesse o portal do desenvolvedor.
  2. Selecione Aplicativos no painel esquerdo.
  3. Selecione o aplicativo necessário na página Aplicativos .
  4. Selecione Análise na seção Visão geral .

A captura de tela mostra a página de análise do seu aplicativo e agente no Portal do desenvolvedor.

Observação

Você também pode acessar o card Usuários Ativos diretamente do Dashboard.

Definições de métrica

Indicador Definição
Usuários ativos mensais (MAU) Número de usuários únicos que realizaram uma atividade intencional com seu aplicativo e agente dentro dessa janela de 28 dias em UTC.
Usuários ativos semanais (WAU) Número de usuários únicos que realizaram uma atividade intencional com seu aplicativo e agente dentro dessa janela de sete dias em UTC.
Usuários ativos diários (DAU) Número de usuários únicos que realizaram uma atividade intencional com seu aplicativo e agente em um determinado dia em UTC.
Locatários ativos mensais Número de locatários exclusivos que realizaram uma atividade intencional com seu aplicativo e agente dentro dessa janela sem interrupção de 28 dias em UTC.
Locatários ativos semanais Número de locatários exclusivos que executaram uma atividade intencional com seu aplicativo e agente dentro dessa janela de sete dias em UTC.
Locatários ativos diários Número de locatários exclusivos que realizaram uma atividade intencional com seu aplicativo e agente em um determinado dia em UTC.

Dica

Para saber mais sobre cada definição de métrica, selecione Ver definições de métrica. Uma janela pop-up aparece no lado direito da janela com as definições necessárias.

Ao explorar métricas individuais nesta página, você pode usar o botão Filtrar para analisar o uso do seu aplicativo e do agente nas seguintes opções de filtro:

  • Tipo de agregação: permite exibir usuários ativos ou locatários ativos.
  • Platform: permite agrupar as métricas pela plataforma na qual os usuários realizaram atividades intencionais com seu aplicativo e agente. A plataforma pode ser Desktop, Mobile, Web ou outras opções disponíveis.
  • Sistema operacional: permite agrupar as métricas pelo sistema operacional no qual os usuários realizaram atividades intencionais com seu aplicativo e agente. O sistema operacional pode ser Windows, Mac, iOS,Android ou outras opções disponíveis.
  • Área: Permite agrupar as métricas pela localização geográfica do uso ativo.

A captura de tela mostra o filtro da página de análise de aplicativo e agente no Portal do desenvolvedor.

Análise de aplicativos e agentes

Para obter insights sobre o uso de aplicativos e agentes e analisar tendências, explore as três seções a seguir em Análise:

Uso de aplicativos e agentes

A guia Uso do aplicativo mostra as seguintes métricas para ajudá-lo a acompanhar o envolvimento e o comportamento do usuário:

A captura de tela mostra o gráfico de uso do aplicativo e do agente do seu aplicativo publicado no Portal do Desenvolvedor.

Uso ao longo do tempo

O gráfico Uso ao longo do tempo mostra o número de usuários ativos ou locatários que abriram e usaram seu aplicativo e agente em diferentes períodos de tempo.

A captura de tela mostra o uso do aplicativo e do agente ao longo do tempo do seu aplicativo publicado no Portal do Desenvolvedor.

Uso por estado de retenção

O gráfico Uso por estado de retenção permite rastrear quatro métricas principais de retenção ou rotatividade para seu aplicativo e agente ao longo do tempo.

A captura de tela mostra o uso do aplicativo e do agente por estado de retenção do seu aplicativo publicado no Portal do Desenvolvedor.

Indicador Definição
Novos usuários Usuários ativos que usaram seu aplicativo e agente pela primeira vez no período atual.
Usuários recorrentes Usuários ativos que usaram seu aplicativo e agente durante o período atual e no período imediatamente anterior.
Usuários ressuscitados Usuários ativos que começaram a usar seu aplicativo e agente novamente no período atual, após um período anterior de inatividade.
Usuários inativos Usuários ativos que pararam de usar seu aplicativo e agente no período atual, após um período anterior de atividade.

Uso por país ou região

O gráfico Uso por país/região mostra as várias regiões em que seu aplicativo e agente estão sendo usados. Cada usuário é mapeado para uma única área ou geografia. Você pode selecionar Exibir detalhes para obter mais informações sobre usuários ativos em diferentes países ou regiões.

A captura de tela mostra o uso do aplicativo e do agente por país ou região do seu aplicativo publicado no Portal do Desenvolvedor.

Intensidade de uso

O gráfico de intensidade de uso mostra a frequência e a profundidade do uso. Eles são um indicador de que os usuários estão encontrando valor em continuar usando seu aplicativo e agente.

A captura de tela mostra a intensidade de uso do aplicativo e do agente do seu aplicativo publicado no Portal do Desenvolvedor.

Indicador Definição
Mediana de dias usados por mês Número médio de dias em que seu aplicativo e agente foram abertos no último mês.
% de 5+ dias de uso Porcentagem de usuários ativos que abriram ou usaram seu aplicativo e agente mais de cinco dias no último mês.
DAU/MAU Número médio de usuários ativos diários (DAU) dividido por usuários ativos mensais (MAU) por um período de 30 dias.

App dashboard

A tabela Painel do Meu Aplicativo mostra os dados mais recentes de R30 (30 dias sem interrupção) para cada uma das métricas nas quatro categorias anteriores e a alteração mês a mês (MoM). Use o seletor de hora no canto superior esquerdo e selecione a data desejada para exibir o seguinte:

  • Selecione qualquer dia nos últimos 75 dias para exibir os dados diários do R30.
  • Selecione qualquer fim de mês nos últimos 12 meses para exibir os dados R30.

Você pode selecionar cada um desses nomes de métrica para ver as tendências ao longo do tempo.

A captura de tela mostra o uso da funcionalidade do aplicativo e do agente do seu aplicativo publicado no Portal do Desenvolvedor.

Hospedar produto

A guia Produto host mostra a seguinte análise de uso para aplicativo e agente:

Os dois primeiros scorecards exibem métricas como o host com os usuários mais ativos e o sistema operacional (SO) com os usuários mais ativos com base em dados mensais, semanais e diários.

A captura de tela mostra o uso do aplicativo e do agente em diferentes produtos host do seu aplicativo publicado no Portal do Desenvolvedor.

Uso de aplicativo e agente por produto host

O gráfico Uso de aplicativos por produto host mostra o uso ativo do aplicativo e do agente em vários produtos host, incluindo o aplicativo Microsoft 365, o Microsoft 365 Copilot, o Outlook e o Teams.

A captura de tela mostra o uso do aplicativo e do agente em diferentes produtos host do seu aplicativo publicado no Portal do Desenvolvedor.

Uso por plataforma

O gráfico Uso por plataforma mostra o uso ativo do seu aplicativo e do agente em várias plataformas, como Desktop, Celular, Web e outras plataformas em que o aplicativo e o agente são usados.

A captura de tela mostra o uso do aplicativo e do agente em diferentes plataformas do seu aplicativo publicado no Portal do Desenvolvedor.

Observação

A marca de visualização indica que a métrica Uso por produto host está em sua fase inicial e pode sofrer modificações à medida que coletamos comentários e continuamos a melhorar a experiência.

Uso por sistema operacional

O gráfico Uso por sistema operacional mostra o uso ativo do seu aplicativo ou agente em vários sistemas operacionais, como Android, Chrome OS,Linux, Mac, Windows e iOS de dados mensais, semanais e diários.

A captura de tela mostra o uso do aplicativo e do agente em diferentes sistemas operacionais do seu aplicativo publicado no Portal do Desenvolvedor.

Recursos

A guia Capacidade mostra o uso de recursos individuais de aplicativos e agentes que você configurou em seu aplicativo. Esta página resume o uso geral dos seguintes recursos de aplicativo e agente em diferentes produtos host.

  • Agente do Microsoft 365 Copilot

  • Bots

  • Guias

  • Extensão de mensagem

  • Aplicativo pessoal

  • Conector

  • Guia pessoal

    A captura de tela mostra o uso de recursos do aplicativo e do agente em diferentes produtos host do seu aplicativo publicado no Portal do Desenvolvedor.

    Observação

    O agente do Microsoft 365 Copilot inclui apenas o uso de agentes declarativos. Espera-se que o uso do agente de mecanismo personalizado seja introduzido posteriormente no Portal do Desenvolvedor.

Limitações conhecidas

  • Os dados de uso para extensões de mensagem no Outlook e no suplemento do Outlook não estão disponíveis.
  • Os dados de uso da guia pessoal do Outlook incluem dados da guia pessoal e da guia (cenário de reunião).
  • Os dados de uso para aplicativos do consumidor não estão disponíveis.
  • Os dados de uso para Android no Outlook, que não têm uma ID de locatário, não estão disponíveis.

Confira também