Partilhar via

Tutorial sobre como adicionar tags personalizadas à telemetria do cliente

  • Artigo

Este tutorial mostra como adicionar um atributo de dados personalizado, chamado de marca Opções de Diagnóstico, aos dados de telemetria que seu cliente WebJS envia ao Azure Monitor. Essa telemetria pode ser usada para análise pós-chamada.

Por que os testes A/B são importantes

O teste A/B é uma técnica essencial para tomar decisões baseadas em 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 controlam a confiabilidade e a qualidade das chamadas. Esse método permite que as empresas testem diferentes designs, conteúdos e funcionalidades dentro de um ambiente controlado, garantindo que quaisquer modificações resultem em melhorias mensuráveis. Além disso, os testes A/B reduzem 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 é sua capacidade de revelar preferências e comportamentos do usuário que podem não ser evidentes através de técnicas de teste tradicionais. A análise dos resultados desses testes permite que os desenvolvedores obtenham uma compreensão mais profunda de como duas versões diferentes do seu aplicativo resultam em melhorias para o usuário final na confiabilidade e qualidade das chamadas. Este ciclo iterativo de testes e otimização cultiva uma cultura de aprimoramento contínuo, ajudando os desenvolvedores a permanecerem competitivos e adaptáveis às tendências do mercado em evolução.

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

Considere a possibilidade de que segmentos específicos da sua base de usuários estejam encontrando problemas, e você pretende identificar e entender melhor esses problemas. Por exemplo, imagine que todos os seus clientes que utilizam o WebJS dos Serviços de Comunicação do Azure em um único local específico enfrentem dificuldades. Para identificar os usuários que estão enfrentando problemas, você pode incorporar uma marca de opções de diagnóstico nos clientes que iniciam uma chamada no local especificado. Essa marcação permite filtrar e examinar os registros de chamadas de forma eficaz. Ao aplicar a tag direcionada, você pode segregar e analisar esses dados de forma mais eficiente. 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. Através da análise contínua dessas sessões marcadas, você obtém informações valiosas sobre os problemas do usuário, permitindo que você os resolva proativamente e melhore a experiência geral do usuário.

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

Há três campos opcionais que você pode usar para marcar dar para adicionar vários níveis de. Rastreamento 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-9] e símbolos básicos (traço "-", sublinhado "_", ponto ".", dois pontos ":", sinal numérico "#" ).

Aqui está um exemplo de como usar os parâmetros 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 visualizar a tag

Depois de adicionar os valores ao SDK do cliente, eles são preenchidos e aparecem na telemetria e nas métricas enquanto você está chamando. Esses valores aparecem como pares chave-valor anexados ao campo do agente do usuário que aparece no esquema de log do cliente de chamada

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

Nota

Se você não definir um valor para 'appName', 'appVersion ou 'tag' de dentro da API do cliente, o valor padrão para esse campo estará vazio.

Próximos passos