Tutorial sobre cómo agregar etiquetas personalizadas a la telemetría de sus clientes
Este tutorial muestra cómo agregar un atributo de datos personalizado, denominado etiqueta Opciones de diagnóstico, a los datos de telemetría que su cliente WebJS envía a Azure Monitor. Esta telemetría se puede usar para el análisis posterior a la llamada.
Por qué son importantes las pruebas de A/B
Las pruebas A/B son una técnica esencial para tomar decisiones basadas en datos en el desarrollo de productos. Examinando dos variaciones de una aplicación, los desarrolladores pueden identificar qué versión destaca en función de métricas específicas que controlan la confiabilidad y la calidad de las llamadas. Este método permite a las empresas probar diferentes diseños, contenido y funcionalidades dentro de una configuración controlada, lo que garantiza que las modificaciones produzcan mejoras medibles. Además, las pruebas A/B reducen los riesgos asociados a la introducción de nuevas características o estrategias al ofrecer información basada en evidencia antes de un lanzamiento a escala completa.
Otra ventaja clave de las pruebas A/B es su capacidad para revelar las preferencias y comportamientos del usuario que pueden no ser evidentes a través de técnicas de prueba tradicionales. El análisis de los resultados de estas pruebas permite a los desarrolladores comprender mejor cómo dos versiones diferentes de la aplicación dan lugar a mejoras del usuario final en la llamada a la confiabilidad y la calidad. Este ciclo iterativo de pruebas y optimización cultiva una cultura de mejora continua que ayuda a los desarrolladores a seguir siendo competitivos y a adaptarse a la evolución de las tendencias del mercado.
Ventajas de la etiqueta Opciones de diagnóstico
Tenga en cuenta la posibilidad de que determinados segmentos de la base de usuarios encuentren problemas y que tenga como objetivo identificar y comprender mejor estos problemas. Por ejemplo, imagine que todos los clientes que usan WebJS de Azure Communication Services en una sola ubicación determinada se enfrentan a dificultades. Para identificar a los usuarios que experimentan problemas, puede incorporar una etiqueta de opciones de diagnóstico en los clientes que inician una llamada en la ubicación especificada. Este etiquetado permite filtrar y examinar los registros de llamadas de forma eficaz. Al aplicar la etiqueta de destino, puede separar y analizar estos datos de forma más eficaz. Herramientas de supervisión como ACS Calling Insights y Call Diagnostic Center (CDC) pueden ayudar a realizar un seguimiento de estas etiquetas y a identificar problemas o patrones periódicos. A través del análisis continuo de estas sesiones etiquetadas, obtendrá información valiosa sobre los problemas del usuario, lo que le permite abordarlos de forma proactiva y mejorar la experiencia general del usuario.
Cómo agregar una etiqueta Opciones de diagnóstico a su código JavaScript
Hay tres campos opcionales que puede utilizar para la etiqueta de dar a agregar varios niveles de. Seguimiento de telemetría para sus necesidades.
appNameappVersiontags
Cada valor puede tener una longitud máxima de 64 caracteres, con compatibilidad solo con letras [aA, bB, cC, etc.], números[0-9], y símbolos básicos (guión "-", subrayado "_", punto ".", dos puntos ":", signo de número "#" ).
Este es un ejemplo de cómo utilizar los parámetros de las Opciones de diagnóstico desde su aplicación WebJS:
const callClient = new CallClient({
diagnostics: {
appName: 'contoso-healthcare-calling-services',
appVersion: '2.1',
tags: ["contoso_virtual_visits",`#clientTag:participant0001}`]
}
});
Cómo ver la etiqueta
Una vez que agregue los valores al SDK de cliente, se rellenan y aparecen en la telemetría y las métricas a medida que llama. Estos valores aparecen como pares clave-valor agregados al campo de agente de usuario que aparece dentro del esquema de registro del cliente de llamada
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; x64) AppleWebKit/537.36 (KHTML, como Gecko) Chrome/129.0.0.0 Safari/537.36 Edg/129.0.0.0
Nota:
Si no establece un valor para "appName", "appVersion" o "tag" desde dentro de la API de cliente, el valor predeterminado de ese campo estará vacío.