Tutorial sobre como adicionar tags personalizadas à telemetria do cliente

Este tutorial mostra como adicionar um atributo de dados personalizado, chamado de tag Opções de Diagnóstico, aos dados telemétricos enviados pelo cliente WebJS ao Azure Monitor. Essa telemetria pode ser usada para análise pós-chamada.

Por que o teste A/B é importante

O teste A/B é uma técnica essencial para tomar decisões informadas por dados no desenvolvimento de produtos. Examinando duas variações de uma saída de aplicativo, os desenvolvedores podem identificar qual versão se destaca com base em métricas específicas que acompanham a confiabilidade e a qualidade da chamada. Esse método permite que as empresas testem diferentes designs, conteúdo e funcionalidades dentro de uma configuração controlada, garantindo que qualquer modificação resulte em aprimoramentos mensuráveis. Além disso, o teste A/B reduz os riscos associados à introdução de novos recursos ou estratégias, oferecendo insights baseados em evidências antes de um lançamento em grande escala.

Outro benefício fundamental do teste A/B é a sua capacidade de revelar preferências e comportamentos do usuário que não são evidentes por meio de técnicas de teste tradicionais. Ao optar por realizar testes A/B, você poderá obter uma compreensão mais profunda de como duas versões diferentes do aplicativo resultam em melhorias no usuário final na confiabilidade e na qualidade da chamada. Esse ciclo iterativo de teste e otimização incentiva uma cultura de aprimoramento contínuo, ajudando os desenvolvedores a permanecerem competitivos e adaptáveis às tendências de mercado em evolução.

Benefícios da tag Opções de Diagnóstico

Considere a possibilidade de segmentos específicos da sua base de usuários estarem tendo problemas e você tem como objetivo identificar e entender melhor esses problemas. Por exemplo, imagine que todos os clientes que utilizam o WebJS dos Serviços de Comunicação do Azure em um único local específico enfrentam dificuldades. Para identificar os usuários com problemas, você pode incorporar uma tag de opções de diagnóstico em clientes que iniciam uma chamada no local especificado. Essa marcação permite filtrar e examinar os logs de chamadas com eficiência. Aplicando a tag de destino, você pode separar e analisar esses dados com mais eficiência. Ferramentas de monitoramento como o ACS Calling Insights e o Call Diagnostic Center (CDC), podem ajudar a rastrear essas tags e identificar problemas ou padrões recorrentes. Por meio da análise contínua dessas sessões marcadas, você obtém insights valiosos sobre problemas do usuário, permitindo que você os resolva proativamente e aprimore a experiência geral do usuário.

Como adicionar uma tag Opções de Diagnóstico ao código JavaScript

Há três campos opcionais que você pode usar para marcar devido permitindo adicionar vários níveis de. Acompanhamento de telemetria para suas necessidades.

• appName
• appVersion
• tags

Cada valor pode ter um comprimento máximo de 64 caracteres, com suporte apenas para letras (aA, bB, cC, etc.), números (0 a 9), e símbolos básicos (traço "-", sublinhado "_", ponto ".", dois-pontos ":", tecla jogo da velha "#").

Aqui está um exemplo de como usar os parâmetros de Opções de diagnóstico de dentro do seu aplicativo WebJS:

const callClient = new CallClient({
    diagnostics: {
        appName: 'contoso-healthcare-calling-services',
        appVersion: '2.1',
        tags: ["contoso_virtual_visits",`#clientTag:participant0001}`]
    }
});

Como exibir as tags

Depois de adicionar os valores ao SDK do cliente, eles serão preenchidos e aparecerão em sua telemetria e métricas enquanto você estiver fazendo chamadas. Esses valores aparecem como pares chave-valor acrescentados ao campo de agente do usuário que aparece dentro do Esquema de Log de Atualizações de Resumo de Chamadas na propriedade DiagnosticOptions.

contoso-healthcare-calling-services/2.1 azsdk-js-communication-calling/1.27.1-rc.10 (contoso_virtual_visits, participant0001). Mozilla/5.0 (Windows NT 10.0, Win64 e x64) AppleWebKit/537.36 (KHTML, como Gecko) Chrome/129.0.0.0 Safari/537.36 Edge/129.0.0.0

Próximas etapas

• Saiba mais sobre o Call Diagnostic Center dos Serviços de Comunicação do Azure aqui
• Saiba mais sobre insights de chamada de voz e de vídeo aqui
• Saiba mais sobre como habilitar os logs dos Serviços de Comunicação do Azure aqui