Tutoriel sur l'ajout de balises personnalisées à la télémétrie de votre client
Ce didacticiel vous montre comment ajouter un attribut de données personnalisé, appelé balise d’options de diagnostic, aux données de télémétrie que votre client WebJS envoie à Azure Monitor. Cette télémétrie peut être utilisée pour l’analyse post-appel.
Pourquoi les tests A/B sont importants
Les tests A/B sont une technique essentielle pour prendre des décisions fondées sur des données dans le développement de produits. En examinant deux variantes d’une sortie d’application, les développeurs peuvent identifier quelle version excelle en fonction de mesures spécifiques qui suivent la fiabilité et la qualité des appels. Cette méthode permet aux entreprises de tester différentes conceptions, contenus et fonctionnalités dans un environnement contrôlé, garantissant que toute modification entraîne des améliorations mesurables. De plus, les tests A/B réduisent les risques liés à l’introduction de nouvelles fonctionnalités ou stratégies en offrant des informations fondées sur des preuves avant un lancement à grande échelle.
Un autre avantage clé des tests A/B est leur capacité à révéler les préférences et les comportements des utilisateurs qui peuvent ne pas être évidents avec les techniques de test traditionnelles. L'analyse des résultats de ces tests permet aux développeurs de mieux comprendre comment deux versions différentes de votre application entraînent des améliorations pour l'utilisateur final en termes de fiabilité et de qualité des appels. Ce cycle itératif de tests et d’optimisation cultive une culture d’amélioration continue, aidant les développeurs à rester compétitifs et adaptables aux tendances évolutives du marché.
Avantages de l'étiquette Options de diagnostic
Envisagez la possibilité que des segments spécifiques de votre base d’utilisateurs rencontrent des problèmes et essayez de mieux identifier et comprendre ces problèmes. Par exemple, imaginez que tous vos clients utilisant Azure Communication Services WebJS dans un seul emplacement particulier soient confrontés à des difficultés. Pour identifier les utilisateurs rencontrant des problèmes, vous pouvez incorporer une balise d’options de diagnostic sur les clients lançant un appel à l’emplacement spécifié. Ce balisage vous permet de filtrer et d’examiner efficacement les journaux d’appels. En appliquant une balise ciblée, vous pouvez séparer et analyser ces données plus efficacement. Des outils de surveillance tels que ACS Calling Insights et Call Diagnostic Center (CDC) peuvent aider à suivre ces balises et à identifier les problèmes ou modèles récurrents. Grâce à l’analyse continue de ces sessions balisées, vous obtenez des informations précieuses sur les problèmes des utilisateurs, vous permettant de les résoudre de manière proactive et d’améliorer l’expérience utilisateur globale.
Comment ajouter une balise d'options de diagnostic à votre code JavaScript
Il existe trois champs facultatifs que vous pouvez utiliser pour marquer et ajouter différents niveaux. Suivi de télémétrie pour vos besoins.
appNameappVersiontags
Chaque valeur peut avoir une longueur maximale de 64 caractères, avec prise en charge uniquement des lettres [aA, bB, cC, etc.], des chiffres [0-9] et des symboles de base (tiret « - », trait de soulignement « _ », point « . », deux points « : », signe dièse « # » ).
Voici un exemple d'utilisation des paramètres d'options de diagnostic depuis votre application WebJS :
const callClient = new CallClient({
diagnostics: {
appName: 'contoso-healthcare-calling-services',
appVersion: '2.1',
tags: ["contoso_virtual_visits",`#clientTag:participant0001}`]
}
});
Comment visualiser la balise
Une fois que vous avez ajouté les valeurs à votre SDK client, elles sont renseignées et apparaissent dans votre télémétrie et vos métriques pendant que vous appelez. Ces valeurs apparaissent sous forme de paires clé-valeur ajoutées au champ de l'agent utilisateur qui apparaît dans le schéma du journal du client d'appel
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, like Gecko) Chrome/129.0.0.0 Safari/537.36 Edg/129.0.0.0
Remarque
Si vous ne définissez pas de valeur pour « appName », « appVersion » ou « tag » à partir de l'API client, la valeur par défaut de ce champ sera vide.