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. Al examinar dos variaciones de una salida de aplicación, los desarrolladores pueden identificar qué versión destaca en función de métricas específicas que realizan un seguimiento de 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 del usuario y los comportamientos no evidentes a través de técnicas de prueba tradicionales. Al elegir realizar pruebas A/B, es posible que pueda comprender mejor cómo dos versiones diferentes de la aplicación dan lugar a mejoras del usuario final en la confiabilidad y la calidad de las llamadas. 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 usar los parámetros de Opciones de diagnóstico desde la 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 anexados al campo agente de usuario que aparece dentro del Esquema de registro de novedades de resumen de llamadas en la propiedadDiagnosticOptions.
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.