Condividi tramite

Esercitazione sull'aggiunta di tag personalizzati ai dati di telemetria del client

  • Articolo

Questa esercitazione illustra come aggiungere un attributo di dati personalizzato, denominato tag Opzioni di diagnostica, ai dati di telemetria inviati dal client WebJS a Monitoraggio di Azure. Questi dati di telemetria possono essere usati per l'analisi post-chiamata.

Perché i test A/B sono importanti

I test A/B sono una tecnica essenziale per prendere decisioni informate sui dati nello sviluppo di prodotti. Esaminando due varianti di un output dell'applicazione, gli sviluppatori possono identificare la versione in base a metriche specifiche che tengono traccia dell'affidabilità e della qualità delle chiamate. Questo metodo consente alle aziende di testare progetti, contenuti e funzionalità diversi all'interno di un'impostazione controllata, assicurando che qualsiasi modifica comporti miglioramenti misurabili. Inoltre, i test A/B riducono i rischi legati all'introduzione di nuove funzionalità o strategie offrendo informazioni dettagliate basate sulle prove prima di un lancio su larga scala.

Un altro vantaggio fondamentale dei test A/B è la capacità di rivelare preferenze e comportamenti degli utenti non evidenti tramite tecniche di test tradizionali. Quando si sceglie di eseguire test A/B, è possibile ottenere una comprensione più approfondita del modo in cui due diverse versioni dell'applicazione comportano miglioramenti dell'utente finale nell'affidabilità e nella qualità delle chiamate. Questo ciclo iterativo di test e ottimizzazione coltiva una cultura di miglioramento continuo, aiutando gli sviluppatori a rimanere competitivi e adattabili alle tendenze di mercato in evoluzione.

Vantaggi del tag Opzioni di diagnostica

Si consideri la possibilità che si verifichino problemi specifici dei segmenti della base utente e si mira a identificare e comprendere meglio questi problemi. Si supponga, ad esempio, che tutti i clienti usino Servizi di comunicazione di Azure WebJS in un'unica posizione specifica facciano difficoltà. Per individuare i problemi riscontrati dagli utenti, è possibile incorporare un tag di opzioni di diagnostica nei client che avviano una chiamata nella posizione specificata. Questo tag consente di filtrare ed esaminare i log delle chiamate in modo efficace. Applicando un tag di destinazione, è possibile separare e analizzare questi dati in modo più efficiente. Gli strumenti di monitoraggio, ad esempio ACS Calling Insights e Call Diagnostic Center (CDC) possono aiutare a tenere traccia di questi tag e identificare i problemi o i modelli ricorrenti. Grazie all'analisi continua di queste sessioni con tag, si ottengono informazioni dettagliate importanti sui problemi utente, consentendo di risolverli in modo proattivo e migliorare l'esperienza utente complessiva.

Come aggiungere un tag Opzioni di diagnostica al codice JavaScript

Esistono tre campi facoltativi che è possibile usare per assegnare tag per aggiungere vari livelli di . Rilevamento dei dati di telemetria per le proprie esigenze.

  • appName
  • appVersion
  • tags

Ogni valore può avere una lunghezza massima di 64 caratteri, con supporto solo per lettere [aA, bB, cC e così via], numeri[0-9], e simboli di base (trattino "-", sottolineatura "_", punto ".", punti ":", segno di numero "#").

Ecco un esempio di come usare i parametri Opzioni di diagnostica dall'interno dell'applicazione WebJS:

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

Come visualizzare il tag

Dopo aver aggiunto i valori all'SDK client, questi vengono popolati e visualizzati nei dati di telemetria e nelle metriche durante la chiamata. Questi valori vengono visualizzati come coppie chiave-valore aggiunte al campo dell'agente utente visualizzato all'interno dello schema del log degli aggiornamenti di riepilogo delle chiamate nella proprietà DiagnosticOptions.

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

Nota

Se non si imposta un valore per 'appName', 'appVersion o 'tag' dall'API client, il valore predefinito per tale campo sarà vuoto.

Passaggi successivi